1688商品列表API接口快速上手指南

一、前言

在 B2B 电商数据分析、供应链选品、店铺商品监控等场景中，1688 商品列表数据是核心数据源。相较于非合规的爬虫方式，基于 1688 开放平台官方 API 获取商品列表数据，具备稳定性高、数据准确、合规性强的优势。本文将以最常用的「店铺商品列表查询接口」为例，从接口基础认知到 Python 实战调用，帮助开发者快速掌握 1688 商品列表 API 的使用方法。

二、接口概述

1. 核心接口说明

本文以 1688 开放平台高频使用的item_search_shop接口为例（适用于查询指定店铺的商品列表）。

接口地址：注册登录：c0b.cc/R4rbK2 (前往体验接口测试，Taobaoapi2014添加V获取）。

请求方式：GET

数据格式：JSON

2. 调用前置条件

参数名说明示例

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...

3. 核心规则

签名是接口调用成功的关键：需按参数名 ASCII 升序排序、URL 编码后拼接 secret 生成 MD5 值；

调用频率限制：个人账号≤100次 / 秒，企业账号≤500次 / 秒，超限会返回 429 错误；

返回数据包含商品 ID、标题、价格、起订量、主图 URL 等核心字段，可按需筛选。

四、结语

1688 商品列表 API 的使用核心在于「规范生成签名」和「遵守平台调用规则」：签名错误是最常见的问题，需严格按照 ASCII 排序、URL 编码规则实现；批量调用时建议增加缓存（如 Redis）和限流逻辑，避免触发频率限制。

同时，需注意数据使用的合规性：仅可将获取的商品数据用于申请时声明的业务场景，不得倒卖、篡改或用于恶意竞争。后续可基于该基础示例，扩展多线程批量调用、数据清洗入库、异常重试等功能，进一步提升数据采集的效率和稳定性。

审核编辑 黄宇