电商数据 · 数据 API

1688 API

按关键词搜批发货源并拉商品与供应商详情——比价选品与供应链调研。统一入口 POST /api/v1/social,干净结构化 JSON,¥0.01/次、失败不计费。

免费开始 →看文档

个能力

¥0.01

每次调用

秒级

响应

1 个

API Key 通 87 平台

1688 能力清单

action	必填参数	可选参数	单次条数	模式	单价 / 次	返回字段
search	keyword	city, max_price, min_price, sort	默认 20 · 最多 100	同步	¥0.01	id · url · title · text · price_min · price_max · currency · min_order_quantity · order_count · repurchase_rate · category · city · province · supplier_name · is_out_of_stock · supports_dropship · images · platform
product_detail	url	—	—	同步	¥0.01	id · url · title · text · price_min · price_max · currency · price_tiers · min_order_quantity · stock · sold_count · category · unit · supplier_name · supplier_fans · supplier_founded_year · supplier_type · supplier_favorited_count · supports_dropship · supports_sampling · is_out_of_stock · skus · images · platform · name · price · min_quantity

返回字段含义

字段名跨 87 个平台统一，同一个键在哪个平台都是同一个意思—— 这也是换平台只需改 platform 一个字段的原因。机器可读版:/api/v1/social/fields

id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url: 该记录在原平台上的可访问链接。
title: 标题。平台无标题概念时（如纯文本帖）为 null。
text: 正文内容，已去除 HTML 标签。长文可能被上游截断。
currency: 价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。
category: 分类名称，取值为原平台的分类体系，未做跨平台归一。
city: 城市名，用原平台的语言书写，未做中英归一。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
name: 名称。用于账号/商品/商家类能力，指该对象本身的名字。
price: 价格数值，不含货币符号；币种见 currency。

另有 1688 特有字段 price_min · price_max · min_order_quantity · order_count · repurchase_rate · province · supplier_name · is_out_of_stock · supports_dropship · images · price_tiers · stock · sold_count · unit · supplier_fans · supplier_founded_year · supplier_type · supplier_favorited_count · supports_sampling · skus · min_quantity，保留该平台自身的语义。

30 秒调用示例

alibaba1688_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \  -H "Authorization: Bearer omg_live_你的KEY" \  -H "Content-Type: application/json" \  -d '{"platform":"alibaba1688","action":"search","params":{"keyword":"咖啡"}}'

返回长这样

response.json

{  "id": "alibaba1688_…",  "search": [    {      "id": "…",      "url": "https://…",      "title": "…",      "text": "…",      "price_min": "…",      "price_max": "…",      "currency": "…",      "min_order_quantity": "…",      "order_count": 128,      "repurchase_rate": "…",      "category": "…",      "city": "…",      "province": "…",      "supplier_name": "…",      "is_out_of_stock": true,      "supports_dropship": "…",      "images": "…",      "platform": "alibaba1688"    }  ],  "count": 20,  "billing": { "charged": true, "credits": 100, "cny": 0.01 }}

常见用例

关键词监控

按关键词轮询 1688 的新内容，配合 Gemini 文本 API 做情绪分类与异常波动告警。

价格与库存监控

追踪 1688 的商品价格、库存与详情变化，波动即告警。

1688 API 常见问题

1688 API 怎么调用?

统一入口 POST /api/v1/social,请求体传 platform="alibaba1688"、action(见上方能力清单)和 params。鉴权用请求头 Authorization: Bearer <API Key>,同一把 Key 可以调用全部 87 个平台,不需要为每个平台单独申请。

1688 API 怎么收费?

按次计费,¥0.01/次,从统一的 ¥ 钱包扣。一次调用一次计费,不按返回条数或页数加价;参数错误、鉴权失败和空结果都不计费。每次调用的响应里带 billing 字段,写明本次实扣多少。

1688 API 一次能返回多少条数据?

按能力不同,单次最多 100 条(逐能力上限见上方清单的「单次条数」列)。传 limit 参数控制,不传则用默认值。一次调用就返回这么多条,不需要翻页、也不会因为条数多而多收钱。

1688 API 返回哪些字段?

每个能力的返回字段都列在上方能力清单的「返回字段」列里,例如 search 返回 id、url、title、text、price_min、price_max 等。字段名跨平台统一,换平台不用改解析代码。

可以先免费试用 1688 API 吗?

可以。注册免费,加微信领邀请码可得 ¥5 免费额度(≈500 次数据调用或 400 次 AI 调用),足够把 1688 的 2 个能力都试一遍。无需信用卡。