一、接口概述
1. 接口定位
- 数据源:阿里巴巴旗下 1688 平台的工厂信息数据(企业资质、生产能力、交易记录等)
- 应用场景 :供应链分析、供应商评估、市场调研、竞品分析等
2. 核心功能 - 工厂基础信息:企业名称、注册地址、成立时间、注册资本、法定代表人等
- 生产能力数据:主营产品、年营业额、员工规模、生产线数量等
- 交易信用数据:交易勋章、回头率、纠纷率、违规记录等
- 认证信息 :实地认证、深度认证、行业资质证书等
3. 接入方式 - API 类型:RESTful API
- 请求方式:HTTPS
- 返回格式:JSON
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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版本 |
请求参数
请求参数:sid=b2b-2216573601057966b9
参数说明:sid:店铺id
二、Python 请求示例
以下代码展示如何使用 Python 调用 1688 工厂信息 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_get_company/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&sid=b2b-2216573601057966b9"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
三、注意事项
- 权限申请:需先在 1688 开放平台注册开发者账号,创建应用并申请相应 API 权限。
- 频率限制:API 调用有 QPS 限制(通常为 5-10 次 / 秒),需合理控制请求频率。
- 异常处理:实际使用时需添加网络异常重试、Token 过期自动刷新等机制。
- 数据安全:敏感信息(如 AppSecret)需妥善保存,避免硬编码在代码中。