一、接口概述
1688店铺详情API是阿里巴巴B2B平台提供的重要数据接口,主要用于获取店铺的详细信息。该接口支持获取店铺基础信息、商品列表、销量数据、商家资质等核心数据。
1.主要功能特性:
店铺基础信息:店铺名称、店铺等级、开店时间、联系方式。
商品数据:店铺内所有商品列表、价格区间、库存数量。
经营数据:销量统计、买家评价、回头率。
商家资质:诚信通年限、实力商家标识、工厂认证。
服务信息:发货速度、售后政策、混批条件。
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
| address | 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版本 |
2.技术特性:
请求方式:HTTP GET/POST。
数据格式:JSON。
认证方式:AppKey签名认证。
实时性:数据与1688主站同步更新,延迟≤30秒。
二、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 "
# 请求示例 url 默认请求参数已经做URL编码
url = "/1688/seller_info/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&sid=b2b-2206619673102e9470"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
代码功能说明:
实现了完整的HMAC-MD5签名生成逻辑,符合1688 API安全要求。
支持获取店铺核心信息,包括名称、等级、开店时间等。
包含错误处理和超时机制,确保程序稳定性。
返回标准JSON格式数据,便于后续处理和分析。
三、结语
通过1688店铺详情API,开发者可以高效获取结构化店铺数据,为供应商管理、市场分析、竞品研究等B2B场景提供数据支持。该接口相比手动采集具有数据维度全、实时性强、合规性高等优势,是企业级电商应用的理想选择。