义乌购商品列表 API 文档指南（附代码）

一、前言

义乌购平台通过开放 API 提供商品数据访问能力，其商品列表接口采用 RESTful 设计，支持获取商品基础信息、价格、销量等核心数据。该接口适用于价格监控、商品推荐等场景开发。数据返回格式为标准化 JSON。前往体验 API：c0b.cc/R4rbK2 。

二、接口概述

1.核心参数

必选参数：app_key（应用标识）、category_id（分类 ID）、timestamp（秒级时间戳）、sign（签名）

分页参数：page（默认 1）、page_size（最大 100）

筛选参数：q（关键词）、price_range（价格区间）、sort（排序方式如 price_asc/sales_desc）

2.响应结构

json

{ "status": 200, "data": { "total": 1500, "items": [ { "item_id": "P123456", "title": "无线蓝牙耳机", "price": 29.9, "sales": 1500, "main_image": "https://image.url" } ] } }

包含商品 ID、标题、价格、销量及主图链接等核心字段。

三、Python 请求示例

python
# coding:utf-8
""" Compatible for python2.x and python3.x requirement: pip install requests """
from __future__ import print_function import requests
# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 "
app_key = "YOUR_APP_KEY" q = "衣服" # 目标关键词
# 请求示例 url 默认请求参数已经做URL编码 url = "yiwugou/item_search/?key=<您自己的apiKey>&&q=女装&page=1&sort=&price_range=" headers = { "Accept-Encoding": "gzip", "Connection": "close" }
if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

代码特点：

1.实现 MD5 签名生成，符合义乌购接口规范。

2.支持分类 ID 和关键词双模式查询。

3.内置分页参数处理，默认每页 20 条数据。

4.包含完整的错误处理机制和结果解析逻辑。