1688 店铺所有商品 API 使用指南

1688（阿里巴巴批发网）开放平台提供了店铺商品相关 API，用于查询指定店铺的商品列表、商品详情等核心数据。本文将从接口摘要、接口概述、Python 请求示例、使用结语四个维度，详细讲解 1688 店铺所有商品 API 的使用方法，帮助开发者快速实现接口对接。

一、摘要

1688 店铺所有商品 API 是阿里巴巴开放平台为开发者提供的核心业务接口之一，主要用于查询 1688 商家店铺下的商品列表及商品基础信息，包括商品 ID、商品名称、价格、库存、规格、类目、商品状态等关键数据。

适用场景

商家自身店铺的商品数据管理、批量运营与统计分析；

第三方服务商开发店铺管理工具、电商 ERP 系统；

合规的电商行业数据分析、市场调研与选品分析。

二、接口概述

1688 开放平台的 API 采用 RESTful 风格，基于 HTTP/HTTPS 协议通信，支持 GET/POST 请求方式，返回格式以 JSON 为主。以下以供应商店铺商品列表查询接口（核心接口）为例，介绍接口的核心信息。接口地址：c0b.cc/R4rbK2 。

三、Python 请求示例

以下示例基于 Python 3.x 实现 1688 店铺商品 API 的调用，核心包含参数构造、签名生成、请求发送、响应解析，使用 requests 库作为 HTTP 客户端。

# coding:utf-8
""" Compatible for python2.x and python3.x requirement: pip install requests """
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码 url = "1688/item_search_shop/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&seller_nick=b2b-2200733087881719de&start_price=0&end_price=0&q=&page=1&cid=" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj）

注意事项

参数替换：需将代码中的 APP_KEY、APP_SECRET、SELLER_ID 替换为开放平台的实际信息；

签名验证：签名生成是接口调用的核心，需严格按照 1688 的规则实现，否则会返回签名错误；

分页处理：若商品总数超过单页条数，需循环调用接口（递增 page_no）获取所有页数据；

频率限制：需遵守接口的 QPS 限制，避免频繁调用导致限流；

参数格式：部分参数（如 seller_id）为字符串类型，需确保参数类型与官方文档一致。

四、结语

1688 店铺所有商品 API 是对接 1688 电商生态的重要入口，其使用需严格遵守平台的相关规范，确保数据的合规采集与使用。