1688 工厂档案
获取 1688 工厂的员工数、厂房面积、设备数、年交易额、定制起订量、回头率、履约率和开票信息。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"supplierId": "b2b-2189087086"
}{
"request_id": "5d2c1b0e-7c1f-4a52-9a54-0d6f3a1b8e23",
"data": {
"supplier_id": "b2b-2189087086",
"company_name": "浦江福衣特服饰有限公司",
"shop_name": "福衣特旗舰店",
"description": "福衣特是全球规模领先的瑜伽服供应商。经过10余年发展,公司已演变成一家集研发、纺织、生产、销售为一体的链主型企业。",
"main_products": [
"瑜伽服",
"运动内衣",
"运动紧身裤"
],
"processing_methods": [
"来样加工",
"来图加工",
"包工包料",
"清加工"
],
"registered_on": "2021-02-08",
"employees": "201~300人",
"annual_turnover": "2000万以上",
"factory_area_sqm": 3000,
"equipment_count": 50,
"custom_min_order": "100件",
"oem_min_order": "100件",
"repurchase_rate": "72%",
"response_rate": "74%",
"on_time_rate": "97%",
"interested_buyers": 524,
"exports": false,
"vat_invoice": "有",
"invoice_tax_rate": "13%",
"logo_url": "https://cbu01.alicdn.com/img/ibank/O1CN015ZZ1tF1Bs2gcTkm6K_!!0-0-cib.jpg"
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 2 个计费单位。
POST /v1/alibaba/1688/factories/detail
下方请求和响应字段已与当前公开契约核对。
MCP 调用
| 项目 | 内容 |
|---|---|
| MCP Code | alibaba_1688_factories_detail |
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/alibaba/1688/factories/detail \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"supplierId": "b2b-2189087086"
}'使用 AI CLI 接入
复制给 AI CLI
粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。
请直接在当前代码库中接入 Ecommerce Data API 的「1688 工厂档案」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/alibaba/1688/factory-profile
请求接口:POST https://ecommercedataapi.com/v1/alibaba/1688/factories/detail
API 密钥环境变量:ECOMMERCE_DATA_API_KEY
请求示例:
{
"supplierId": "b2b-2189087086"
}
请按以下要求执行:
1. 先阅读接口文档,并检查当前项目使用的语言、框架、HTTP 客户端、目录结构和环境变量约定。
2. 优先复用项目现有的 API 客户端和错误处理方式;如果没有,再创建最小可复用的 Ecommerce Data API 客户端与该接口调用封装。
3. 从服务端环境变量 ECOMMERCE_DATA_API_KEY 读取密钥,发送 Content-Type: application/json 和 X-API-Key 请求头。绝不能把真实密钥写入源码、前端代码、日志、测试快照或 Git。
4. 如果环境变量不存在,提示我自行设置 ECOMMERCE_DATA_API_KEY;不要索取、输出或猜测真实密钥,并继续完成不依赖真实请求的代码与测试。
5. 根据接口文档实现请求与响应类型,处理非 2xx 响应、request_id、error.code、error.message 和 429 限流。
6. 添加一个符合当前项目习惯的最小调用示例或测试。如果密钥已配置且当前环境允许外部请求,再执行一次最小真实调用;否则使用 mock 或静态验证。
7. 运行相关格式化、类型检查和测试,最后汇报修改文件、调用方法、验证结果以及仍需我配置的环境变量。还没有 API 密钥?创建 API 密钥
在 Postman 中打开当前请求
下载当前接口的预配置 Collection,再通过 Postman Import 导入。
导入后在 Collection Variables 中填写 apiKey。创建 API 密钥
Node.js 示例
const response = await fetch(
'https://ecommercedataapi.com/v1/alibaba/1688/factories/detail',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
supplierId: 'b2b-2189087086',
}),
}
);
const result = await response.json();
if (!response.ok) {
throw new Error(`${result.error?.code}: ${result.error?.message}`);
}
console.log(result.data);Python 示例
import os
import requests
response = requests.post(
"https://ecommercedataapi.com/v1/alibaba/1688/factories/detail",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"supplierId": "b2b-2189087086",
},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])请求参数
请求体直接发送下表字段,不要再包裹额外对象;未定义字段会被拒绝。
| 字段 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
supplierId | 字符串 | 是 | 供应商 ID,通常以 b2b- 开头。取自 1688 工厂搜索或 1688 商品详情返回的 supplier_id。不接受纯数字的 seller_id。 | b2b-2189087086 |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
supplier_id | 字符串 | 供应商 ID | b2b-2189087086 |
company_name | 字符串 | 公司名称(中文) | 浦江福衣特服饰有限公司 |
shop_name | 字符串 | 1688 店铺名 | 福衣特旗舰店 |
description | 字符串 | 工厂自我介绍(中文) | - |
main_products | 数组 | 主营产品 | - |
processing_methods | 数组 | 加工方式,如来样加工、来图加工、包工包料、清加工 | - |
registered_on | 字符串 | 工厂档案注册日期,YYYY-MM-DD | 2021-02-08 |
employees | 字符串 | 员工人数区间(1688 原样) | 201~300人 |
annual_turnover | 字符串 | 年交易额区间(人民币,1688 原样) | 2000万以上 |
factory_area_sqm | 数字 | 厂房面积(平方米) | 3000 |
equipment_count | 整数 | 设备数量 | 50 |
custom_min_order | 字符串 | 定制起订量(带单位) | 100件 |
oem_min_order | 字符串 | 贴牌代工起订量(带单位) | 100件 |
repurchase_rate | 字符串 | 回头率(百分比字符串) | 72% |
response_rate | 字符串 | 服务响应率(百分比字符串) | 74% |
on_time_rate | 字符串 | 准时履约率(百分比字符串),1688 没有数据时为 null | 97% |
interested_buyers | 整数 | 意向客户数 | 524 |
exports | 布尔值 | 工厂是否标注有外贸业务 | false |
vat_invoice | 字符串 | 是否提供增值税发票:有 / 无 | 有 |
invoice_tax_rate | 字符串 | 开票税点,未标注时为 null | 13% |
logo_url | 字符串 | 工厂 Logo 链接,没有时为 null | - |
返回示例
{
"request_id": "5d2c1b0e-7c1f-4a52-9a54-0d6f3a1b8e23",
"data": {
"supplier_id": "b2b-2189087086",
"company_name": "浦江福衣特服饰有限公司",
"shop_name": "福衣特旗舰店",
"description": "福衣特是全球规模领先的瑜伽服供应商。经过10余年发展,公司已演变成一家集研发、纺织、生产、销售为一体的链主型企业。",
"main_products": ["瑜伽服", "运动内衣", "运动紧身裤"],
"processing_methods": ["来样加工", "来图加工", "包工包料", "清加工"],
"registered_on": "2021-02-08",
"employees": "201~300人",
"annual_turnover": "2000万以上",
"factory_area_sqm": 3000,
"equipment_count": 50,
"custom_min_order": "100件",
"oem_min_order": "100件",
"repurchase_rate": "72%",
"response_rate": "74%",
"on_time_rate": "97%",
"interested_buyers": 524,
"exports": false,
"vat_invoice": "有",
"invoice_tax_rate": "13%",
"logo_url": "https://cbu01.alicdn.com/img/ibank/O1CN015ZZ1tF1Bs2gcTkm6K_!!0-0-cib.jpg"
}
}错误响应、请求追踪和限流头说明见错误与限流。