1688

1688 API

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

平台可用度

24h 健康值
正常
正常

30 天趋势

1688 能力清单

能力做什么单价24 小时可用度
关键词搜索search按商品关键词搜索货源,把采购门槛与展示价格一起看。$1.39 / 千次正常
商品详情product_detail按 offerId 定位具体货源,对照采购数量档和规格报价。$1.39 / 千次正常
平台内商品图搜image_search把客户提供的商品图片直接匹配到 1688 商品候选,再按商品 ID 继续核详情。$5.56 / 千次正常

点能力名进它的文档:参数、返回字段、代码示例和试用。

1688 每个接口分别做什么

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

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

能力必填参数可选参数单次条数模式单价返回字段
searchkeywordcity, 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 · supplier_type · supplier_years · supplier_shop_url · supplier_composite_score · sold_count_text · service_tags · product_badges · platform
product_detailurl——同步$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 · description_images · video_url · specs · rating · rating_scale · review_count · positive_rate · sold_display · want_buy_count · category_path · services · promotions · customization_supported · winport_url · platform
image_searchimage_url—默认 5 · 最多 5同步$5.56 / 千次id · url · title · price · currency · min_order_quantity · order_count · supplier_name · image_url · rank · platform

怎么调用 1688 商品详情 API?

product_detail

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

查看完整接口文档:参数、代码示例、响应样例与健康状态 →

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

url必填
1688 单品定位。product_detail 接收 detail.1688.com 或 m.1688.com 的正规商品 URL、含唯一商品 URL 的分享文本或纯数字 offerId;qr.1688.com 分享短链仅在可安全解析到商品页时接受。店铺首页和搜索页会拒绝。

1688 的采购文档区分商品 offerId、规格 specId 与购买数量,并单独校验起批量。此处仅引用这些术语,本接口不创建或预览采购订单。官方来源:1688:商品、规格与起批量说明来源核查:

1688 返回字段与含义(30)
supplier_name
供应商名称。
supplier_type
供应商经营模式(如 生产加工、经销批发)。
min_order_quantity
最小起订量(MOQ)。1688 批发场景的第一门槛,采购前先看它。
price_min
价格区间下限。
price_max
价格区间上限。
is_out_of_stock
是否缺货。
images
商品图片。
supports_dropship
是否支持一件代发。做无货源电商的关键筛选项。
supplier_founded_year
供应商成立年份。
supplier_fans
供应商粉丝数。
supplier_favorited_count
被收藏次数。
price_tiers
阶梯价(买得越多单价越低),配合 min_quantity 读。
unit
计价单位(个/件/箱)。
sold_count
销量。
stock
库存。
skus
可获取的规格明细;每行的选项、价格、库存和可售状态仅在平台数据明确给出时返回,缺失不等于无货。
supports_sampling
是否支持拿样。
description_images
详情描述图 URL 列表(按商品页原顺序);null 表示该商品无详情图。
video_url
商品视频链接(如有)。
specs
商品参数/规格表:[{name, value}] 键值对列表(如 材质: TPU)。
rating
商品综合评分(1-5)。
review_count
累计评价数。
positive_rate
好评率(0-1 小数,如 0.999 = 99.9%)。
sold_display
销量的原文展示(如 已售10万+件);数值口径见 sold_count。
want_buy_count
想要/求购人数(采购意向热度参考)。
category_path
完整类目路径(如 数码、电脑 > 手机配件 > 手机保护套)。
services
商品服务标签列表(如 退货包运费、晚发即赔)。
promotions
当前生效的促销活动名称列表。
customization_supported
是否支持定制(来图定制/打样等)。
winport_url
供应商 1688 诚信通店铺链接。
1688 search 调用流程一次 1688 search 调用的全过程:向 POST /api/v1/social 发送 platform="alibaba1688"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、title、text、price_min 等字段;返回列表,单次最多 100 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "alibaba1688"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idurltitletextprice_min
一次 1688 search 调用的全过程:向 POST /api/v1/social 发送 platform="alibaba1688"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、title、text、price_min 等字段;返回列表,单次最多 100 条,计费 $1.39 / 千次,失败与空结果不计费。

1688 原始字段名

EveryInfra 统一字段名

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

1688 的独有字段名(当前目录)

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

  • order_count
  • repurchase_rate
  • supplier_name
  • is_out_of_stock
  • supports_dropship
  • supplier_type
  • supplier_years
  • supplier_shop_url
  • supplier_composite_score
  • sold_count_text
  • service_tags
  • product_badges
  • price_tiers
  • unit
  • supplier_fans
  • supplier_founded_year
  • 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
商品图片。
supplier_type
供应商经营模式(如 生产加工、经销批发)。
supplier_years
供应商在 1688 平台的年数。
supplier_shop_url
供应商店铺链接。
supplier_composite_score
供应商综合服务分(1-5)。
sold_count_text
销量的原文展示(搜索行,如 全网100+件)。
service_tags
服务标签列表(搜索行)。
product_badges
商品徽章列表(搜索行,如 7×24H响应、先采后付)。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
price_tiers
阶梯价(买得越多单价越低),配合 min_quantity 读。
stock
库存。
sold_count
销量。
unit
计价单位(个/件/箱)。
supplier_fans
供应商粉丝数。
supplier_founded_year
供应商成立年份。
supplier_favorited_count
被收藏次数。
supports_sampling
是否支持拿样。
skus
可获取的规格明细;每行的选项、价格、库存和可售状态仅在平台数据明确给出时返回,缺失不等于无货。
description_images
详情描述图 URL 列表(按商品页原顺序);null 表示该商品无详情图。
video_url
商品视频链接(如有)。
specs
商品参数/规格表:[{name, value}] 键值对列表(如 材质: TPU)。
rating
商品综合评分(1-5)。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
review_count
累计评价数。
positive_rate
好评率(0-1 小数,如 0.999 = 99.9%)。
sold_display
销量的原文展示(如 已售10万+件);数值口径见 sold_count。
want_buy_count
想要/求购人数(采购意向热度参考)。
category_path
完整类目路径(如 数码、电脑 > 手机配件 > 手机保护套)。
services
商品服务标签列表(如 退货包运费、晚发即赔)。
promotions
当前生效的促销活动名称列表。
customization_supported
是否支持定制(来图定制/打样等)。
winport_url
供应商 1688 诚信通店铺链接。
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 你的 API 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,
  "supplier_type": null,
  "supplier_years": null,
  "supplier_shop_url": null,
  "supplier_composite_score": null,
  "sold_count_text": null,
  "service_tags": null,
  "product_badges": 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 教程与实战

先在本页核对当前 action、参数与字段,再按真实任务进入完整步骤或相邻方法;文章中的示例和边界不会替代本页机器目录。

Blog

价格抓取怎么商业化:做一款商家愿意续费的价格监控产品

商家为什么为价格监控付费,又为什么取消订阅?从商品匹配、经营例外清单和调价审批出发,拆解价格数据的交付方式、收费单位与试点验证。

阅读完整文章 →
指南

统一数据 API 入门:从能力目录到第一条可用结果

用 platform、action、params 接入多平台数据:读懂能力目录,完成最小请求,处理异步任务、部分结果与计费,并建立可追溯的数据记录。

阅读完整文章 →
指南

API 失败、返还与对账:如何核对一条请求的净扣款

把业务任务、调用尝试、交付状态与钱包事件分开,解释扣前拒绝、空结果和部分返还,避免把同一返还重复减项,并用整数离线示例核对单次请求。

阅读完整文章 →

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 通 90 个平台。

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 等 25 个字段名。按全站当前目录统计,24 个字段名只在 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 次数据调用),注册后在控制台「余额与充值」兑换,进入赠送余额,24 小⁠时内有效。请先选择 1688 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 3 个能力。无需信用卡。

开始调用 1688 API

加微信领 $1 额度码,注册后在控制台兑换,24 小⁠时内有效,先选一个 1688 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始