电商数据 · 数据 API

1688 API

按关键词搜批发货源并拉商品与供应商详情——比价选品与供应链调研。调 POST /api/v1/social 就行,返回结构化 JSON,$1.39 / 千次/次、失败不计费。

免费开始看文档

个能力

$1.39 / 千次

每次调用

秒级

响应

1 个

API Key 通 87 平台

1688 能力清单

action	必填参数	可选参数	单次条数	模式	单价 / 次	返回字段
search	keyword	city, max_price, min_price, sort	默认 20 · 最多 100	同步	$1.39 / 千次	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	—	—	同步	$1.39 / 千次	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

1688 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。请求都发到 POST /api/v1/social，只需切换 action。

怎么调用 1688 关键词搜索 API？

search

使用 platform="alibaba1688"、action="search" 调用“关键词搜索”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、title、text、price_min、price_max 等 18 个字段。

keyword必填: 检索关键词。
city可选: 城市名。
max_price可选: 最高价格，数值。
min_price可选: 最低价格，数值。
sort可选: 排序方式。取值随平台而异，见该能力的 allowed_values。

1688 特有返回字段与含义（10）

supplier_name: 供应商名称。
province: 供应商所在省份。
min_order_quantity: 最小起订量(MOQ)。1688 批发场景的第一门槛，采购前先看它。
price_min: 价格区间下限。
price_max: 价格区间上限。
order_count: 订单数。
repurchase_rate: 复购率。1688 上判断供应商质量最硬的指标之一。
is_out_of_stock: 是否缺货。
images: 商品图片。
supports_dropship: 是否支持一件代发。做无货源电商的关键筛选项。

怎么调用 1688 商品详情 API？

product_detail

使用 platform="alibaba1688"、action="product_detail" 调用“商品详情”能力；返回单个对象，主要包含 id、url、title、text、price_min、price_max 等 27 个字段。

url必填: 目标页面的完整链接，直接从该平台复制。

1688 特有返回字段与含义（18）

supplier_name: 供应商名称。
min_order_quantity: 最小起订量(MOQ)。1688 批发场景的第一门槛，采购前先看它。
price_min: 价格区间下限。
price_max: 价格区间上限。
is_out_of_stock: 是否缺货。
images: 商品图片。
supports_dropship: 是否支持一件代发。做无货源电商的关键筛选项。
supplier_type: 供应商类型（生产商/贸易商）。
supplier_founded_year: 供应商成立年份。
supplier_fans: 供应商粉丝数。
supplier_favorited_count: 被收藏次数。
min_quantity: 该价格档的最低数量。
price_tiers: 阶梯价（买得越多单价越低），配合 min_quantity 读。
unit: 计价单位（个/件/箱）。
sold_count: 销量。
stock: 库存。
skus: 规格明细。
supports_sampling: 是否支持拿样。

一次 1688 search 调用的全过程:向 POST /api/v1/social 发送 platform="alibaba1688"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、title、text、price_min 等字段;单次最多 100 条,计费 $1.39 / 千次,失败与空结果不计费。

1688 原始字段名

EveryInfra 统一字段名

左边是 1688 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。右边这一列在 87 个平台上是同一套—— 换平台时只改请求里的 platform 一个字段，解析代码一行不用动。

只有 1688 返回的字段

全站 87 个平台里，这 14 个字段只有 1688 会返回——换别的平台拿不到这些数据。字段名与其余平台同样遵循 snake_case 命名，解析方式一致。

min_order_quantity
order_count
repurchase_rate
supplier_name
is_out_of_stock
supports_dropship
price_tiers
unit
supplier_fans
supplier_founded_year
supplier_type
supplier_favorited_count
supports_sampling
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_你的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.009356 }
}

常见用例

关键词监控

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

价格与库存监控

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

1688 API 常见问题

1688 API 怎么调用?

调 POST /api/v1/social,请求体传 platform="alibaba1688"、action 和 params。以 search 为例,必填 keyword,可选 city、max_price、min_price、sort。1688 共 2 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 87 个平台。

1688 API 怎么收费?

$1.39 / 千次/次,1688 全部 2 个能力同价。$1 免费额度约等于 719 次 1688 调用。一次调用一次计费,不按条数或页数加价;参数错误、鉴权失败和空结果都不计费。

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

最多的是 search,单次上限 100 条(默认 20 条)。另外 1 个能力返回单个对象,没有条数概念。传 limit 控制,一次调用就返回这么多,不需要翻页也不多收钱。

1688 API 返回哪些字段?

search 返回 id、url、title、text、price_min、price_max 等 18 个字段。其中 14 个字段只有 1688 会返回(见上方「独有字段」)。字段名跨平台统一,换平台不用改解析代码。

1688怎么按关键词批量采集?

调 POST /api/v1/social,传 platform="alibaba1688"、action="search",必填参数 keyword。单次最多 100 条,一次调用一次计费、不按条数加价;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,关键词搜索字段为 id、url、title、text、price_min。

1688商品详情怎么批量采集?

调 POST /api/v1/social,传 platform="alibaba1688"、action="product_detail",必填参数 url。返回单个对象,没有条数上限;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,商品详情字段为 id、url、title、text、price_min。

可以先免费试用 1688 API 吗?

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

速卖通 API Amazon API Craigslist API eBay API Etsy API Shopee API 淘宝 API Temu API 全部 87 平台 ↗

开始调用 1688 API

加微信领 $1 免费额度 —— ≈720 次数据调用或 576 次 AI 调用,足够把 1688 的能力全试一遍。

免费开始