一、摘要
1688店铺所有商品API是阿里巴巴B2B平台提供的核心数据接口,主要用于获取指定店铺下的全部商品信息。该接口支持分页查询、商品筛选、排序等功能,为批发采购、供应链管理和市场分析提供全面的商品数据支持。
二、接口概述
1.主要功能特性
商品基础信息:商品ID、标题、主图、价格、库存状态。
商品详情数据:规格参数、商品描述、SKU信息。
经营数据:销量统计、评价信息、商品状态。
分类信息:商品类目、属性标签。
2.技术参数
请求方式:HTTP GET POST。
认证机制:AppKey + AppSecret签名认证 。
数据格式:JSON。
分页机制:支持page_no和page_size参数。
实时性:数据与1688主站同步,延迟≤1分钟。
3.接口限制
单次请求最多返回100条商品数据。
每日调用上限根据API套餐而定。
请求频率限制:最高100次/秒。
公共参数
1688.item_search_shop
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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版本 |
三、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 "
app_key = "YOUR_APP_KEY" shop_id = "123456789" # 目标店铺ID
# 请求示例 url 默认请求参数已经做URL编码 url = "1688/item_search_shop/?key=<您自己的apiKey>&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)
代码说明:
实现了完整的1688店铺商品API调用类,支持分页获取所有商品。
包含签名生成、错误处理和结果解析等完整功能。
支持多种筛选条件和排序方式。
提供完整的示例代码和依赖配置。
四、结语
1688店铺所有商品API为B2B电商数据获取提供了全面可靠的解决方案。相比手动采集,该接口具有数据准确性高、获取效率快、稳定性强等优势,特别适合批量商品管理和供应链优化场景。