1688查询榜单列表API,python请求示例

Data_agent2025-11-30 21:19

1688榜单列表API是阿里巴巴开放平台提供的核心数据接口，支持获取热销商品、新品榜单等垂直领域排行数据，适用于B2B选品分析和市场趋势预测。以下是关键信息：

一、核心功能

获取实时榜单商品列表（支持20+细分品类），返回商品ID、标题、价格、30日销量等40+字段。 ‌

支持按价格区间、发货地等条件筛选。 ‌

二、调用流程

1.公共参数

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
adress	String	是	c0b.cc/R4rbK2（需替换为实际账号）
api_name	String	是	API接口名称（包括在请求地址中） $item_search,item_get,item_search_shop等$
cache	String	否	$yes,no$ 默认yes，将调用缓存的数据，速度比较快
result_type	String	否	$json,jsonu,xml,serialize,var_export$ 返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	$cn,en,ru$ 翻译语言，默认cn简体中文
version	String	否	API版本

2.请求参数

固定方法：method: alibaba.item.search.best 。 ‌

必填参数：timestamp（13位Unix时间戳）、page_no（页码，默认1）、page_size（每页数量，最大50）。 ‌

可选参数：sort_type（榜单类型，如_best）、category（类目ID）、region（发货地编码）。 ‌

榜单类型

rank_type参数支持：

complex（综合榜）

hot（热卖榜）

goodPrice（好价榜）。 ‌

3.示例代码

使用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 "
# 请求示例 url 默认请求参数已经做URL编码
url = "1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en"
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)

代码实现要点：

签名机制：采用MD5加密，参数按字母序排序‌。

错误处理：包含网络异常和状态码校验。

数据解析：直接处理JSON响应中的核心字段。