1688 商品详情
获取 1688 商品的阶梯价、起订量、SKU、属性、供应商和发货地。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"productId": "929196455687"
}{
"request_id": "e41f9c6a-3b7d-4c58-b1e2-9f0a7d5c2b46",
"data": {
"product_id": "929196455687",
"title": "假两件运动长裤女春夏高腰防走光健身裤羽毛球服跑步瑜伽鲨鱼裤裙",
"price": 14.9,
"currency": "CNY",
"sold_count": 14666,
"shop_name": "璟和服饰有限公司",
"repurchase_rate": null,
"image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01yaZG1A1YiBh7LdKXM_!!2219532523092-0-cib.jpg",
"product_url": "https://detail.1688.com/offer/929196455687.html",
"seller_name": "东阳市璟和服饰有限公司",
"seller_id": "2219532523092",
"supplier_id": "b2b-22195325230922e9c0",
"shop_url": "https://winport.m.1688.com/page/index.html?memberId=b2b-22195325230922e9c0",
"min_order_quantity": 1,
"unit": "件",
"stock": 58613,
"location": "浙江省金华市",
"shipping_fee": 2.5,
"category_id": "1037024",
"price_tiers": [
{
"min_quantity": 1,
"price": 14.9
},
{
"min_quantity": 1,
"price": 15.9
}
],
"skus": [
{
"sku_id": "5981803031159",
"name": "颜色:黑色;尺码:M【建议80-105斤】",
"price": 14.9,
"stock": 10000
},
{
"sku_id": "5981803031155",
"name": "颜色:黑色;尺码:L【建议105-120斤】",
"price": 14.9,
"stock": 9432
}
],
"attributes": [
{
"name": "款式",
"value": "裙裤"
},
{
"name": "面料名称",
"value": "涤纶(聚酯纤维)"
},
{
"name": "弹力",
"value": "中弹"
}
],
"images": [
"https://cbu01.alicdn.com/img/ibank/O1CN01yaZG1A1YiBh7LdKXM_!!2219532523092-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01xEl8lU1YiBh81BcrV_!!2219532523092-0-cib.jpg"
],
"video_url": "https://cloud.video.taobao.com/play/u/2219532523092/p/2/e/6/t/1/520710612064.mp4"
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/alibaba/1688/products/detail
下方请求和响应字段已与当前公开契约核对。
MCP 调用
| 项目 | 内容 |
|---|---|
| MCP Code | alibaba_1688_products_detail |
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/alibaba/1688/products/detail \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"productId": "929196455687"
}'使用 AI CLI 接入
复制给 AI CLI
粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。
请直接在当前代码库中接入 Ecommerce Data API 的「1688 商品详情」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/alibaba/1688/product-details
请求接口:POST https://ecommercedataapi.com/v1/alibaba/1688/products/detail
API 密钥环境变量:ECOMMERCE_DATA_API_KEY
请求示例:
{
"productId": "929196455687"
}
请按以下要求执行:
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/products/detail',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
productId: '929196455687',
}),
}
);
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/products/detail",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"productId": "929196455687",
},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])请求参数
请求体直接发送下表字段,不要再包裹额外对象;未定义字段会被拒绝。
| 字段 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
productId | 字符串 | 是 | 1688 商品 ID:detail.1688.com/offer/ 链接里的数字,或搜索结果里的 product_id。 | 929196455687 |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
product_id | 字符串 | 1688 商品 ID,可传给 1688 商品详情接口 | 929196455687 |
title | 字符串 | 商品标题(中文) | - |
price | 数字 | 供货价(人民币)。有阶梯价或多规格时为最低价,完整价格见商品详情 | 14.9 |
currency | 字符串 | 币种,固定为 CNY | CNY |
sold_count | 整数 | 商品页展示的销量。搜索结果里最高显示 100000 | 14000 |
shop_name | 字符串 | 供应商店铺名。关键词搜索结果里为 null | 苏州满星源商贸有限公司 |
image_url | 字符串 | 主图链接 | - |
product_url | 字符串 | 1688 商品页链接 | - |
seller_name | 字符串 | 供应商公司名 | - |
seller_id | 字符串 | 供应商数字账号 ID | 2219532523092 |
supplier_id | 字符串 | 供应商 ID,可传给 1688 工厂档案或 1688 供应商商品接口 | b2b-22195325230922e9c0 |
shop_url | 字符串 | 店铺链接 | - |
min_order_quantity | 整数 | 起订量 | 1 |
unit | 字符串 | 销售单位(中文) | 件 |
stock | 整数 | 全部规格的库存合计 | 58613 |
location | 字符串 | 发货地(中文) | 浙江省金华市 |
shipping_fee | 数字 | 商品页展示的国内运费(人民币) | 2.5 |
category_id | 字符串 | 1688 类目 ID | 1037024 |
price_tiers.min_quantity | 整数 | 该价格适用的起始数量 | 1 |
price_tiers.price | 数字 | 单价(人民币)。价格按规格而不是按数量区分时,各条数量相同,表示价格区间 | 14.9 |
skus.sku_id | 字符串 | SKU ID | - |
skus.name | 字符串 | 规格组合(中文) | 颜色:黑色;尺码:M |
skus.price | 数字 | SKU 价格(人民币) | 14.9 |
skus.stock | 整数 | SKU 库存 | 10000 |
attributes.name | 字符串 | 属性名(中文) | 面料名称 |
attributes.value | 字符串 | 属性值(中文) | - |
images | 数组 | 主图组链接 | - |
video_url | 字符串 | 商品视频链接,没有则为 null | - |
返回示例
{
"request_id": "e41f9c6a-3b7d-4c58-b1e2-9f0a7d5c2b46",
"data": {
"product_id": "929196455687",
"title": "假两件运动长裤女春夏高腰防走光健身裤羽毛球服跑步瑜伽鲨鱼裤裙",
"price": 14.9,
"currency": "CNY",
"sold_count": 14666,
"shop_name": "璟和服饰有限公司",
"repurchase_rate": null,
"image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01yaZG1A1YiBh7LdKXM_!!2219532523092-0-cib.jpg",
"product_url": "https://detail.1688.com/offer/929196455687.html",
"seller_name": "东阳市璟和服饰有限公司",
"seller_id": "2219532523092",
"supplier_id": "b2b-22195325230922e9c0",
"shop_url": "https://winport.m.1688.com/page/index.html?memberId=b2b-22195325230922e9c0",
"min_order_quantity": 1,
"unit": "件",
"stock": 58613,
"location": "浙江省金华市",
"shipping_fee": 2.5,
"category_id": "1037024",
"price_tiers": [
{
"min_quantity": 1,
"price": 14.9
},
{
"min_quantity": 1,
"price": 15.9
}
],
"skus": [
{
"sku_id": "5981803031159",
"name": "颜色:黑色;尺码:M【建议80-105斤】",
"price": 14.9,
"stock": 10000
},
{
"sku_id": "5981803031155",
"name": "颜色:黑色;尺码:L【建议105-120斤】",
"price": 14.9,
"stock": 9432
}
],
"attributes": [
{
"name": "款式",
"value": "裙裤"
},
{
"name": "面料名称",
"value": "涤纶(聚酯纤维)"
},
{
"name": "弹力",
"value": "中弹"
}
],
"images": [
"https://cbu01.alicdn.com/img/ibank/O1CN01yaZG1A1YiBh7LdKXM_!!2219532523092-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01xEl8lU1YiBh81BcrV_!!2219532523092-0-cib.jpg"
],
"video_url": "https://cloud.video.taobao.com/play/u/2219532523092/p/2/e/6/t/1/520710612064.mp4"
}
}错误响应、请求追踪和限流头说明见错误与限流。