Loading / 加载中…
Loading / 加载中…
电商与交易平台数据
本 API 返回 1688.com 上的商品数据。它涵盖带翻译名称的类目树、按固定页大小分页的类目商品列表、批发商品关键词搜索、对 1688 精选工厂名单的搜索、单个商品详情（含按数量分档的价格与规格变体），以及单个商品的买家评价。价格以人民币计。
正在核对当前可用状态与已批准价格…
JSON 输入，结构化响应。公共网关端点统一使用 POST。
返回 1 到 3 层的 1688 类目节点，名称可选 9 种语言之一，并在每个节点旁保留中文原名。
POST /api/v1/alibaba-1688/post-1688-categories使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {
"depth": 1,
"language": "ru"
}
}分页浏览某个 1688 类目下的商品；每行含人民币价格、起订量、上架日期、履约承诺和证书信息。
POST /api/v1/alibaba-1688/post-1688-category-offers使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {
"category_id": "1031910"
}
}针对一个商品 id，返回标题、图片、人民币价格与定价方式、数量阶梯价、起订量、库存、混批条件、属性、卖家信息以及各规格 SKU。
POST /api/v1/alibaba-1688/post-1688-product-detail使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {
"offer_id": "864971848115"
}
}针对一个商品 id，返回满分 5 分的平均评分、好评率、评价数，以及包含正文、购买数量、规格、图片和日期的单条评价。
POST /api/v1/alibaba-1688/post-1688-product-reviews使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {
"offer_id": "864971848115"
}
}按关键词搜索 1688 商品，返回约 20 个商品的短名单，每行含价格、卖家公司、两种复购率、属性、类目 id 和广告标记。
POST /api/v1/alibaba-1688/post-1688-search使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {
"query": "蓝牙耳机"
}
}按关键词搜索 1688 精选的生产厂家名单，返回所在地、工人数、厂房面积、奖牌、回头率、准时率、验厂状态和商品 id。
POST /api/v1/alibaba-1688/post-1688-supplier-search使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {
"query": "蓝牙耳机"
}
}POST /api/v1/<project>/<action>，并携带 x-api-key、Content-Type: application/json 和必需的 Idempotency-Key。data 是操作的结果。可以。body.offer_id 为字符串，可以是商品 id 的数字，也可以是完整的商品链接。offerId、url 等替代字段名不被接受。
1688 的关键词结果主要由推广商品填充，广告标记反映的是 1688 自身的标注。若要非推广结果，请使用类目商品，可通过搜索结果行中的类目 id 进入。
中文搜索词返回的结果最丰富，因为 1688 是面向中国国内的市场；英文或拼音搜索词也能匹配。
它设定一次调用在放弃前最多尝试的次数，取值 1 到 8，默认 4。