一、前言
在 B2B 电商数据分析、供应链选品、店铺商品监控等场景中，1688 商品列表数据是核心数据源。相较于非合规的爬虫方式，基于 1688 开放平台官方 API 获取商品列表数据，具备稳定性高、数据准确、合规性强的优势。本文将以最常用的「店铺商品列表查询接口」为例，从接口基础认知到 Python 实战调用，帮助开发者快速掌握 1688 商品列表 API 的使用方法。
二、接口概述
- 核心接口说明
本文以 1688 开放平台高频使用的item_search_shop接口为例（适用于查询指定店铺的商品列表）。
接口地址：注册登录：c0b.cc/R4rbK2 (前往体验接口测试，Taobaoapi2014添加V获取）。
请求方式：GET
数据格式：JSON
- 调用前置条件
参数名说明示例
app_key应用 ID12345678
method接口名称item_search_shop
timestamp时间戳（格式：YYYY-MM-DD HH:MM:SS）2026-01-21 10:30:00
shop_id目标店铺 ID（从店铺 URL 提取）987654321
page页码1
page_size每页商品数（最大 100）20
sign签名（HMAC-MD5 生成）8E6F9A7B5C3D1E89...
- 核心规则
签名是接口调用成功的关键：需按参数名 ASCII 升序排序、URL 编码后拼接 secret 生成 MD5 值；
调用频率限制：个人账号≤10 次 / 秒，企业账号≤50 次 / 秒，超限会返回 429 错误；
返回数据包含商品 ID、标题、价格、起订量、主图 URL 等核心字段，可按需筛选。
四、结语
1688 商品列表 API 的使用核心在于「规范生成签名」和「遵守平台调用规则」：签名错误是最常见的问题，需严格按照 ASCII 排序、URL 编码规则实现；批量调用时建议增加缓存（如 Redis）和限流逻辑，避免触发频率限制。
同时，需注意数据使用的合规性：仅可将获取的商品数据用于申请时声明的业务场景，不得倒卖、篡改或用于恶意竞争。后续可基于该基础示例，扩展多线程批量调用、数据清洗入库、异常重试等功能，进一步提升数据采集的效率和稳定性。
