在跨境选品、供应链市场分析、爆款挖掘业务中，需要获取 1688 类目热销榜、好价榜、综合榜商品清单，用来识别平台爆款、跟踪品类趋势。如果直接通过网页爬虫抓取榜单页面，会遇到页面改版、JS 动态渲染、反爬风控、榜单缓存变更等一系列问题，维护成本高。
1688 开放平台官方提供类目榜单接口 1688.item_search_best，可按照类目 ID 查询各类榜单商品，返回榜单排名、商品 offerId、标题、主图、阶梯价格、30 天销量、工厂标签等结构化数据，适合替代爬虫做选品系统、市场分析系统。本文完整解析接口能力、入参、返回字段，附带 JSON 样例、开发流程与踩坑点。
一、接口基础信息
- 基础属性
接口 Method：1688.item_search_best（1688 查询榜单列表，taobaoapi2014 前往体验）
请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）
数据格式：请求 &返回均为 JSON
签名算法 ：平台标准 MD5/HMAC 签名
2.适用业务场景
跨境选品系统：抓取类目热销榜单，挖掘潜力爆品
市场趋势分析：统计类目热销商品价格区间、供应商分布
竞品跟踪：监控类目头部商品上新、销量变化
供应链选品平台：基于榜单数据做货源推荐
联动商品详情 API：拿到 offerId 后拉取完整商品规格、库存信息
二、请求核心参数
| 参数名 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| method | string | 是 | 固定product.topList.query|
| timestamp | string | 是 | 13 位毫秒时间戳 |
| sign | string | 是 | 接口签名 |
| categoryId | string | 是 | 1688 类目 ID，查询哪个类目榜单 |
| rankType | string | 是 | 榜单类型：hot/complex/goodPrice/anchorHot 等 |
| pageNo | int | 否 | 页码，从 1 开始 |
| pageSize | int | 否 | 每页条数，最大 50 |
| access_token | string | 否 | 部分主播类榜单需要用户授权 token
