电商数据 · 数据 API

1688 API

用商品词或 offerId 查找 1688 批发货源，读取起订量、阶梯价和 SKU 规格；价格须结合采购数量核对，不是含运费的成交报价。调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次–$5.56 / 千次；失败不计费。

免费开始看文档

个能力

$1.39 / 千次–$5.56 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

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
image_search	image_url	—	默认 5 · 最多 5	同步	$5.56 / 千次	id · url · title · price · currency · min_order_quantity · order_count · supplier_name · image_url · rank · platform

1688 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。请求都发到 POST /api/v1/social，切换 action 时，也要按对应接口调整参数。同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

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

search

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

1688 search 的参数分别是什么意思？

keyword必填: 1688 批发商品搜索词，例如保温杯、包装纸盒。用于 search，不是店铺名或 offerId；起订量和阶梯价属于返回的商品信息。
1688 官方说明用户输入关键词后，平台会匹配商品或服务，并可按销量、价格、综合等维度查看结果。该来源可解释 EveryInfra keyword 的商品搜索对象，但不证明 popular 与销量排序完全等价，也不证明 relevance、city、价格范围或本接口结果上限的具体实现。官方来源：1688：关键词匹配与商品搜索排序来源核查：2026-09-05
city可选: 1688 商品查询的城市筛选文本。它不是账号所在地，也不会修改返回供应商的地址；指定单品时不能据此推断该筛选仍生效。
max_price可选: 批发商品价格筛选上限，数值；不是阶梯报价中的采购数量上限。与 min_price 配合限定价格范围，不能保证每个 SKU 或数量档都处于该范围。
min_price可选: 批发商品价格筛选下限，数值；不是最低起订量或 API 调用预算。不同采购数量可能对应不同阶梯价，不能把筛选价当作最终成交报价。
sort可选: 商品搜索排序：relevance 为相关度，popular 为畅销优先，price_asc / price_desc 为价格升序 / 降序。不传时 search 使用 relevance；排序不等于返回精确销量或成交额。
查看全部 4 个允许值
popularprice_ascprice_descrelevance

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 等 24 个字段。

1688 product_detail 的参数分别是什么意思？

url必填: 1688 单品定位。product_detail 接收 detail.1688.com 或 m.1688.com 的正规商品 URL、含唯一商品 URL 的分享文本或纯数字 offerId；qr.1688.com 分享短链仅在可安全解析到商品页时接受。店铺首页和搜索页会拒绝。
1688 的采购文档区分商品 offerId、规格 specId 与购买数量，并单独校验起批量。此处仅引用这些术语，本接口不创建或预览采购订单。官方来源：1688：商品、规格与起批量说明来源核查：2026-09-04

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

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: 被收藏次数。
price_tiers: 阶梯价（买得越多单价越低），配合 min_quantity 读。
unit: 计价单位（个/件/箱）。
sold_count: 销量。
stock: 库存。
skus: 可获取的规格明细；每行的选项、价格、库存和可售状态仅在平台数据明确给出时返回，缺失不等于无货。
supports_sampling: 是否支持拿样。

怎么调用 1688 平台内商品图搜 API？

image_search

使用 platform="alibaba1688"、action="image_search" 调用“平台内商品图搜”能力；返回列表，默认 5 条、单次最多 5 条，主要包含 id、url、title、price、currency、min_order_quantity 等 11 个字段。

1688 image_search 的参数分别是什么意思？

image_url必填: 用于 1688 image_search 的单张公开商品图片 HTTPS URL。每次只搜索一张图并返回最多 5 个相似商品；该动作不返回完整 SKU、库存或供应商详情。
1688 开放平台存在按图片查找相似商品的官方接口，并以图片 URL 或图片内容定位商品结果。该来源仅用于说明平台内以图找货的含义；EveryInfra 的单图输入、最多五条候选、返回字段与计费方式以本站公开契约为准。官方来源：1688 开放平台：按图片查找相似商品来源核查：2026-09-21

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

supplier_name: 供应商名称。
min_order_quantity: 最小起订量(MOQ)。1688 批发场景的第一门槛，采购前先看它。
order_count: 订单数。
rank: 图搜结果在本次单图匹配列表中的顺序；只表示本次返回顺序，不是平台销量榜。

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

1688 原始字段名

EveryInfra 统一字段名

左边是 1688 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配；切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

1688 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 12 个字段名只在 1688 出现。这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

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

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。机器可读版：/api/v1/social/fields

id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url: 该记录在原平台上的可访问链接。
title: 标题。平台无标题概念时（如纯文本帖）为 null。
text: 正文内容，已去除 HTML 标签。长文可能被截断。
price_min: 价格区间下限。
price_max: 价格区间上限。
currency: 价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。
min_order_quantity: 最小起订量(MOQ)。1688 批发场景的第一门槛，采购前先看它。
order_count: 订单数。
repurchase_rate: 复购率。1688 上判断供应商质量最硬的指标之一。
category: 分类名称，取值为原平台的分类体系，未做跨平台归一。
city: 城市名，用原平台的语言书写，未做中英归一。
province: 供应商所在省份。
supplier_name: 供应商名称。
is_out_of_stock: 是否缺货。
supports_dropship: 是否支持一件代发。做无货源电商的关键筛选项。
images: 商品图片。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
price_tiers: 阶梯价（买得越多单价越低），配合 min_quantity 读。
stock: 库存。
sold_count: 销量。
unit: 计价单位（个/件/箱）。
supplier_fans: 供应商粉丝数。
supplier_founded_year: 供应商成立年份。
supplier_type: 供应商类型（生产商/贸易商）。
supplier_favorited_count: 被收藏次数。
supports_sampling: 是否支持拿样。
skus: 可获取的规格明细；每行的选项、价格、库存和可售状态仅在平台数据明确给出时返回，缺失不等于无货。
price: 价格数值，不含货币符号；币种见 currency。
image_url: 图片链接。多图能力可能返回 image_urls 数组。
rank: 图搜结果在本次单图匹配列表中的顺序；只表示本次返回顺序，不是平台销量榜。

请求填写示例

按批发商品名称检索；不是供应商主页查询。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

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":"不锈钢保温杯"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json

{
  "id": null,
  "url": null,
  "title": null,
  "text": null,
  "price_min": null,
  "price_max": null,
  "currency": null,
  "min_order_quantity": null,
  "order_count": null,
  "repurchase_rate": null,
  "category": null,
  "city": null,
  "province": null,
  "supplier_name": null,
  "is_out_of_stock": null,
  "supports_dropship": null,
  "images": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

按起订量初筛 1688 批发货源

按商品关键词搜索货源，把采购门槛与展示价格一起看。

查看 search 的 keyword 参数 →

keyword 字段填入商品词，并结合 min_order_quantity、price_min、price_max、currency 和 supplier_name 建立候选清单。
min_order_quantity 是起订量，不是返回条数；价格区间不等于含运费的成交报价，搜索排序也不是精确销量证明。

核对 1688 单品的 SKU 与阶梯价

按 offerId 定位具体货源，对照采购数量档和规格报价。

查看 product_detail 的 url 参数 →

url 可填 /offer/ 商品链接或纯数字 offerId；price_tiers 里的 min_quantity 对应数量档，skus 保存规格条目，unit 表示单位。
结合 min_order_quantity、price_tiers 和 skus 核对条件；返回规格可能不完整，不能把某档价格当作全部 SKU 的统一报价。

用一张商品图寻找 1688 相似货源

把客户提供的商品图片直接匹配到 1688 商品候选，再按商品 ID 继续核详情。

查看 image_search 的 image_url 参数 →

image_url 使用一张公开 HTTPS 图片；一次最多返回五条候选，读取 id、url、title、price、image_url 与 rank。
rank 只是本次图片匹配顺序，不是销量榜；image_search 不补全商品详情，也不返回完整 SKU、库存或供应商画像。

1688 API 常见问题

1688 API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="alibaba1688"、action 和 params。以 search 为例，必填 keyword，可选 city、max_price、min_price、sort。按批发商品名称检索；不是供应商主页查询。 1688 共 3 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

1688 API 怎么收费？

$1.39 / 千次–$5.56 / 千次，按能力不同(清单里逐条标了)。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 179 次 1688 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

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

1688 有 2 个列表接口，包括 search、image_search。其余 1 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

1688 API 返回哪些字段？

当前目录为 search 列出 id、url、title、text、price_min、price_max 等 18 个字段名。按全站当前目录统计，12 个字段名只在 1688 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「按起订量初筛 1688 批发货源」怎样接入 1688 API？

按商品关键词搜索货源，把采购门槛与展示价格一起看。 keyword 字段填入商品词，并结合 min_order_quantity、price_min、price_max、currency 和 supplier_name 建立候选清单。 min_order_quantity 是起订量，不是返回条数；价格区间不等于含运费的成交报价，搜索排序也不是精确销量证明。

「核对 1688 单品的 SKU 与阶梯价」怎样接入 1688 API？

按 offerId 定位具体货源，对照采购数量档和规格报价。 url 可填 /offer/ 商品链接或纯数字 offerId；price_tiers 里的 min_quantity 对应数量档，skus 保存规格条目，unit 表示单位。结合 min_order_quantity、price_tiers 和 skus 核对条件；返回规格可能不完整，不能把某档价格当作全部 SKU 的统一报价。

「用一张商品图寻找 1688 相似货源」怎样接入 1688 API？

把客户提供的商品图片直接匹配到 1688 商品候选，再按商品 ID 继续核详情。 image_url 使用一张公开 HTTPS 图片；一次最多返回五条候选，读取 id、url、title、price、image_url 与 rank。 rank 只是本次图片匹配顺序，不是销量榜；image_search 不补全商品详情，也不返回完整 SKU、库存或供应商画像。

可以先免费试用 1688 API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 1688 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 3 个能力。无需信用卡。

速卖通 API Amazon API Craigslist API 得物 Dewu API eBay API Etsy API 京东 JD.com API Shopee API 全部 89 平台 ↗

开始调用 1688 API

加微信领 $1 免费额度，先选一个 1688 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始