一、摘要
1688店铺列表API为开发者提供获取平台上符合条件的店铺信息接口,支持按行业、地区、信用等级等多维度筛选,适用于供应商挖掘、市场分析等业务场景。
二、接口概述
1.接口基本信息
请求方式:HTTP GET/POST。
数据格式:JSON。
2.核心功能特性
店铺基础信息:店铺名称、主营行业、所在地区。
信用与认证:信用等级、认证标识、保障服务。
经营数据:开店时长、商品数量、交易评分。
联系方式:旺旺、电话等联系信息(需授权)。
3.请求参数说明
必需参数:
app_key:应用标识
timestamp:请求时间戳
签名参数:基于请求参数的MD5签名
筛选参数:
industry_id:行业分类ID
province:省份编码
city:城市编码
credit_level:信用等级范围
分页参数:page_no、page_size
4.公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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请求示例
# 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/item_search_seller/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&page=1"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
四、结语
1688店铺列表API为供应商筛选和市场分析提供了标准化数据接口。通过灵活的筛选条件和完整的分页机制,开发者可以高效地获取目标店铺信息,为采购决策和供应链管理提供数据支撑。