电商数据 · 数据 API

速卖通

速卖通 API

查询跨境商品、SKU 规格、评分汇总与买家评论,可按国家和展示币种核对单品;适合比较规格报价与整理反馈,不保证全部变体可售。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

6

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

速卖通 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordmin_price, min_rating, sort默认 20 · 最多 200同步$1.39 / 千次product_id · title · url · price · original_price · currency · discount · rating · rating_scale · orders_count · review_count · image_url · ships_from · seller_name · category · is_top_rated · free_shipping · platform · tags
profileurlcountry, currency—同步$1.39 / 千次id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · platform
variantsurlcountry, currency—同步$1.39 / 千次id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · platform
reviewsurlsort默认 20 · 最多 200同步$1.39 / 千次review_id · text · rating · rating_scale · posted_at · country · author · sku_info · helpful_count · logistics · product_id · platform · images
ratingsurl——同步$1.39 / 千次count · rate · average_star · total_reviews · positive_rate · neutral_rate · negative_rate · five_star · four_star · three_star · two_star · one_star · platform
product_detailurlcountry, currency—同步$1.39 / 千次id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · platform

速卖通 每个接口分别做什么

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

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

怎么调用 速卖通 主页或对象详情 API?

profile

使用 platform="aliexpress"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 id、url、name、text、price、original_price 等 20 个字段。

速卖通 profile 的参数分别是什么意思?

url必填
AliExpress 商品链接,建议传 https://www.aliexpress.com/item/<商品ID>.html。profile 返回商品资料而非用户主页,variants 查商品变体,reviews / ratings 查评论或评分汇总;product_detail 也接收纯数字商品 ID。

AliExpress 官方接口可按产品 ID 获取商品详情、商品链接和评价率等资料。EveryInfra 的 profile 当前表示商品资料而不是买家或卖家个人资料,并由自身逻辑从商品 URL 定位产品;官方接口的 product ID 不是 EveryInfra url 的同义参数,也不证明所有地区站链接都能解析。官方来源:AliExpress:profile 实际表示商品资料来源核查:

country可选
product_detail 查询的国家/地区代码,例如 US;默认 US,并转换为大写。它选择商品查询地区,不会修改你的账户国家或实际下单收货地址。
currency可选
product_detail 商品价格的展示币种,例如 USD;默认 USD,并转换为大写。与 EveryInfra API 的调用计费币种无关。
速卖通 特有返回字段与含义(9)
original_price
原价(划线价)。与 price 对比可算真实折扣。
discount
折扣力度。
images
商品轮播相册,按平台商品页顺序返回。
description_images
商品描述区图片,来自受限的 AliExpress 媒体正文地址。
variants
商品的规格变体列表。
sold_count
销量。
shipping
运费与配送方式。
store_name
店铺名称。
store_url
店铺链接。

怎么调用 速卖通 商品变体 API?

variants

使用 platform="aliexpress"、action="variants" 调用“商品变体”能力;返回单个对象,主要包含 id、url、name、text、price、original_price 等 20 个字段。

开放平台的属性查询接口把类目下的 SKU 属性与通用属性分开,并给出属性名、属性值及是否必填等字段。这里只用于解释 variants 页面里的 AliExpress 变体术语,不代表本接口支持商品发布或保证返回类目中的所有组合。官方来源:AliExpress:类目下的 SKU 属性与通用属性来源核查:

速卖通 variants 的参数分别是什么意思?

url必填
AliExpress 商品链接,建议传 https://www.aliexpress.com/item/<商品ID>.html。profile 返回商品资料而非用户主页,variants 查商品变体,reviews / ratings 查评论或评分汇总;product_detail 也接收纯数字商品 ID。
country可选
product_detail 查询的国家/地区代码,例如 US;默认 US,并转换为大写。它选择商品查询地区,不会修改你的账户国家或实际下单收货地址。
currency可选
product_detail 商品价格的展示币种,例如 USD;默认 USD,并转换为大写。与 EveryInfra API 的调用计费币种无关。
速卖通 特有返回字段与含义(9)
original_price
原价(划线价)。与 price 对比可算真实折扣。
discount
折扣力度。
images
商品轮播相册,按平台商品页顺序返回。
description_images
商品描述区图片,来自受限的 AliExpress 媒体正文地址。
variants
商品的规格变体列表。
sold_count
销量。
shipping
运费与配送方式。
store_name
店铺名称。
store_url
店铺链接。

怎么调用 速卖通 评价 API?

reviews

使用 platform="aliexpress"、action="reviews" 调用“评价”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 review_id、text、rating、rating_scale、posted_at、country 等 13 个字段。

速卖通 reviews 的参数分别是什么意思?

url必填
AliExpress 商品链接,建议传 https://www.aliexpress.com/item/<商品ID>.html。profile 返回商品资料而非用户主页,variants 查商品变体,reviews / ratings 查评论或评分汇总;product_detail 也接收纯数字商品 ID。

AliExpress 官方政策确认用户可以留下并向其他用户展示商品评论。该来源只支撑商品评论这一数据对象;EveryInfra 按商品 URL 定位评论是自身契约,不能据此宣称 AliExpress 提供按 URL 批量获取评论的开放接口,也不能证明 sort、覆盖范围或结果上限。官方来源:AliExpress:商品评论对象与访问边界来源核查:

sort可选
按当前 action 列出的允许值选择。search:relevance 为默认综合排序,popular 为订单量优先,price_asc / price_desc 为价格升序 / 降序,top_rated 为评分优先;兼容旧值 default / orders / rating。reviews:relevance 为默认顺序,newest 为最新评论,不是商品上架时间。ratings 不公开 sort 参数。
查看全部 2 个允许值

newestrelevance

速卖通 特有返回字段与含义(7)
product_id
商品 ID。
images
商品轮播相册,按平台商品页顺序返回。
sku_info
SKU 规格信息(颜色 / 尺寸等组合)。
logistics
物流方案。
review_id
评价 ID。
author
评价人。
helpful_count
该评价被标为有用的次数。

怎么调用 速卖通 评分分布 API?

ratings

使用 platform="aliexpress"、action="ratings" 调用“评分分布”能力;返回单个对象,主要包含 count、rate、average_star、total_reviews、positive_rate、neutral_rate 等 13 个字段。

速卖通 ratings 的参数分别是什么意思?

url必填
AliExpress 商品链接,建议传 https://www.aliexpress.com/item/<商品ID>.html。profile 返回商品资料而非用户主页,variants 查商品变体,reviews / ratings 查评论或评分汇总;product_detail 也接收纯数字商品 ID。

AliExpress 官方商品详情接口可返回评价率等商品层评分信息。EveryInfra ratings 通过商品 URL 定位目标属于自身解析契约;该来源不证明存在按 URL 获取的独立 ratings 数据集,也不能把汇总评价率描述成逐条评分记录或评论排序结果。官方来源:AliExpress:商品评价率不是逐条评分记录来源核查:

速卖通 特有返回字段与含义(12)
average_star
平均星级。
rate
评分值。
five_star
五星评价数。
four_star
四星评价数。
three_star
三星评价数。
two_star
二星评价数。
one_star
一星评价数。
positive_rate
好评率。
neutral_rate
中评率。
negative_rate
差评率。
total_reviews
评价总数。
count
数量(含义随所在能力而定)。

怎么调用 速卖通 商品详情 API?

product_detail

使用 platform="aliexpress"、action="product_detail" 调用“商品详情”能力;返回单个对象,主要包含 id、url、name、text、price、original_price 等 20 个字段。

速卖通 product_detail 的参数分别是什么意思?

url必填
AliExpress 商品链接,建议传 https://www.aliexpress.com/item/<商品ID>.html。profile 返回商品资料而非用户主页,variants 查商品变体,reviews / ratings 查评论或评分汇总;product_detail 也接收纯数字商品 ID。

AliExpress 官方商品详情接口按产品 ID 返回商品链接、价格、店铺和评价率等资料。EveryInfra product_detail 从商品 URL 定位目标是自身适配契约,官方 product ID 不是 url 的同义参数;country、currency、地区站解析和字段完整性也不能由该来源保证。官方来源:AliExpress:商品详情使用产品 ID 定位来源核查:

country可选
product_detail 查询的国家/地区代码,例如 US;默认 US,并转换为大写。它选择商品查询地区,不会修改你的账户国家或实际下单收货地址。
currency可选
product_detail 商品价格的展示币种,例如 USD;默认 USD,并转换为大写。与 EveryInfra API 的调用计费币种无关。
速卖通 特有返回字段与含义(9)
original_price
原价(划线价)。与 price 对比可算真实折扣。
discount
折扣力度。
images
商品轮播相册,按平台商品页顺序返回。
description_images
商品描述区图片,来自受限的 AliExpress 媒体正文地址。
variants
商品的规格变体列表。
sold_count
销量。
shipping
运费与配送方式。
store_name
店铺名称。
store_url
店铺链接。
速卖通 search 调用流程一次 速卖通 search 调用的全过程:向 POST /api/v1/social 发送 platform="aliexpress"、action="search",以及必填参数 keyword;返回结构化 JSON,含 product_id、title、url、price、original_price 等字段;返回列表,单次最多 200 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "aliexpress"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表product_idtitleurlpriceoriginal_price
一次 速卖通 search 调用的全过程:向 POST /api/v1/social 发送 platform="aliexpress"、action="search",以及必填参数 keyword;返回结构化 JSON,含 product_id、title、url、price、original_price 等字段;返回列表,单次最多 200 条,计费 $1.39 / 千次,失败与空结果不计费。

速卖通 原始字段名

EveryInfra 统一字段名

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

速卖通 的独有字段名(当前目录)

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

  • orders_count
  • ships_from
  • store_name
  • store_url
  • sku_info
  • logistics
  • rate
  • average_star
  • positive_rate
  • neutral_rate
  • negative_rate
  • five_star
  • four_star
  • three_star
  • two_star
  • one_star

返回字段含义

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

product_id
商品 ID。
title
标题。平台无标题概念时(如纯文本帖)为 null。
url
该记录在原平台上的可访问链接。
price
价格数值,不含货币符号;币种见 currency。
original_price
原价(划线价)。与 price 对比可算真实折扣。
currency
价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
discount
折扣力度。
rating
评分。分制随平台而异,同一行的 rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
orders_count
累计订单数。AliExpress 上这是比评分更硬的信任指标。
review_count
评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
image_url
图片链接。多图能力可能返回 image_urls 数组。
ships_from
发货地。
seller_name
卖家名称。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
is_top_rated
是否为平台认证的优质卖家。
free_shipping
是否包邮。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
tags
标签数组。无标签时为空数组,不是 null。
id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
text
正文内容,已去除 HTML 标签。长文可能被截断。
sold_count
销量。
shipping
运费与配送方式。
variants
商品的规格变体列表。
store_name
店铺名称。
store_url
店铺链接。
images
商品轮播相册,按平台商品页顺序返回。
description_images
商品描述区图片,来自受限的 AliExpress 媒体正文地址。
review_id
评价 ID。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
country
国家或地区。可能是全称也可能是 ISO 代码,取决于平台,未归一。
author
评价人。
sku_info
SKU 规格信息(颜色 / 尺寸等组合)。
helpful_count
该评价被标为有用的次数。
logistics
物流方案。
count
数量(含义随所在能力而定)。
rate
评分值。
average_star
平均星级。
total_reviews
评价总数。
positive_rate
好评率。
neutral_rate
中评率。
negative_rate
差评率。
five_star
五星评价数。
four_star
四星评价数。
three_star
三星评价数。
two_star
二星评价数。
one_star
一星评价数。

请求填写示例

这里搜索商品;商品排序与 reviews 的评论排序不同。

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

aliexpress_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"aliexpress","action":"search","params":{"keyword":"wireless keyboard"}}'

记录字段预览(非真实响应)

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

fields.preview.json
{
  "product_id": null,
  "title": null,
  "url": null,
  "price": null,
  "original_price": null,
  "currency": null,
  "discount": null,
  "rating": null,
  "rating_scale": null,
  "orders_count": null,
  "review_count": null,
  "image_url": null,
  "ships_from": null,
  "seller_name": null,
  "category": null,
  "is_top_rated": null,
  "free_shipping": null,
  "platform": null,
  "tags": null
}

常见用例

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

按商品星级筛选 AliExpress 候选

用商品关键词搜索,再用最低星级缩小待比较的商品范围。

查看 search 的 min_rating 参数 →
  • min_rating 使用 0–5 分,例如 4.5;结合 product_id、title、rating、review_count 和 price 核对商品。
  • 这是商品评分门槛,不是好评率百分比,也不是只返回四星以上的评论;商品价格仍要结合 currency 阅读。

AliExpress 商品资料与店铺核对

用 profile 读取单个商品的名称、价格、店铺和规格信息。

查看 profile 的 url 参数 →
  • url 指向具体商品;结合 id、name、store_name、price 与 currency 核对结果。规格数据位于 variants,结构与完整程度以本次实际返回为准。
  • profile 返回商品资料,不是用户主页;不提供独立的变体总数或跨规格最高价字段,也不保证全部规格可售或都有库存。

逐个 SKU 比较 AliExpress 规格

用 variants 读取同一商品的规格条目,避免只比较商品最低价。

查看 variants 的 url 参数 →
  • url 字段使用商品链接;返回单个商品对象,规格数据位于 variants。读取前核对该字段的实际结构,不假定每个条目都有相同的 SKU、属性、价格或库存子字段。
  • 缺失规格不表示缺货,缺失库存也不能推断可购买;本次结果不保证完整覆盖全部规格,不代表库存预留。

AliExpress 商品评价问题整理

读取某个商品的评论正文,按规格和评价时间整理反馈。

查看 reviews 的 sort 参数 →
  • reviews 字段使用商品 url,结合 review_id、text、rating、sku_info 与 posted_at 核对评论;sort=newest 指最新评论。
  • 评论排序不是商品上架时间排序,实际取得的评价不能代表全部买家的体验。

区分 AliExpress 评分汇总与评论样本

需要平均星级和评价总数时,用 ratings 读取商品评分汇总。

查看 ratings 的 url 参数 →
  • url 定位商品,average_star 是平均星级,total_reviews 是汇总评价数;它们不同于一次 reviews 返回的评论条数。
  • 此接口不返回评论正文;缺失的星级分布不能记为零,也不要用不完整样本重新算出一个冒充官方的总评分。

按地区与展示币种查询 AliExpress 单品

用 product_detail 的国家和币种选项读取目标地区的商品信息。

查看 product_detail 的 currency 参数 →
  • url 可填商品链接或纯数字商品 ID;country 选择查询地区,currency 选择商品展示币种,结合 price、currency 与 shipping 查看结果。
  • currency 不改变 EveryInfra API 的计费币种,country 也不会替你下单或修改收货地址;运费与可售情况以实际结果为准。

速卖通 API 常见问题

速卖通 API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="aliexpress"、action 和 params。以 search 为例,必填 keyword,可选 min_price、min_rating、sort。这里搜索商品;商品排序与 reviews 的评论排序不同。 速卖通 共 6 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

速卖通 API 怎么收费?

$1.39 / 千次,速卖通 全部 6 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 719 次 速卖通 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

速卖通 API 一次能返回多少条数据?

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

速卖通 API 返回哪些字段?

当前目录为 search 列出 product_id、title、url、price、original_price、currency 等 19 个字段名。按全站当前目录统计,16 个字段名只在 速卖通 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「按商品星级筛选 AliExpress 候选」怎样接入 速卖通 API?

用商品关键词搜索,再用最低星级缩小待比较的商品范围。 min_rating 使用 0–5 分,例如 4.5;结合 product_id、title、rating、review_count 和 price 核对商品。 这是商品评分门槛,不是好评率百分比,也不是只返回四星以上的评论;商品价格仍要结合 currency 阅读。

「AliExpress 商品资料与店铺核对」怎样接入 速卖通 API?

用 profile 读取单个商品的名称、价格、店铺和规格信息。 url 指向具体商品;结合 id、name、store_name、price 与 currency 核对结果。规格数据位于 variants,结构与完整程度以本次实际返回为准。 profile 返回商品资料,不是用户主页;不提供独立的变体总数或跨规格最高价字段,也不保证全部规格可售或都有库存。

「逐个 SKU 比较 AliExpress 规格」怎样接入 速卖通 API?

用 variants 读取同一商品的规格条目,避免只比较商品最低价。 url 字段使用商品链接;返回单个商品对象,规格数据位于 variants。读取前核对该字段的实际结构,不假定每个条目都有相同的 SKU、属性、价格或库存子字段。 缺失规格不表示缺货,缺失库存也不能推断可购买;本次结果不保证完整覆盖全部规格,不代表库存预留。

「AliExpress 商品评价问题整理」怎样接入 速卖通 API?

读取某个商品的评论正文,按规格和评价时间整理反馈。 reviews 字段使用商品 url,结合 review_id、text、rating、sku_info 与 posted_at 核对评论;sort=newest 指最新评论。 评论排序不是商品上架时间排序,实际取得的评价不能代表全部买家的体验。

可以先免费试用 速卖通 API 吗?

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

开始调用 速卖通 API

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

免费开始