速卖通

速卖通 API

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

平台可用度

24h 健康值
97%
健康

30 天趋势

速卖通 能力清单

能力做什么单价24 小时可用度
关键词搜索search用商品关键词搜索,再用最低星级缩小待比较的商品范围。$1.39 / 千次每 50 条算一次健康 · 健康值 100%
主页或对象详情profile用 profile 读取单个商品的名称、价格、店铺和规格信息。$1.39 / 千次正常
商品变体variants用 variants 读取同一商品的规格条目,避免只比较商品最低价。$1.39 / 千次健康 · 健康值 97%
评价reviews读取某个商品的评论正文,按规格和评价时间整理反馈。$1.39 / 千次正常
评分汇总ratings需要平均星级和评价总数时,用 ratings 读取商品评分汇总。$1.39 / 千次正常
商品详情product_detail用 product_detail 的国家和币种选项读取目标地区的商品信息。$1.39 / 千次正常

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

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

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

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

能力必填参数可选参数单次条数模式单价返回字段
searchkeywordmin_price, min_rating, sort默认 20 · 最多 200同步$1.39 / 千次每 50 条算一次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 · images · search_rank · seller_rating · seller_url · 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 · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · 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 · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform
reviewsurlsort默认 20 · 最多 200同步$1.39 / 千次review_id · text · rating · rating_scale · posted_at · country · author · sku_info · helpful_count · logistics · product_id · is_anonymous · unhelpful_count · language · original_text · is_translated · review_labels · sku_id · platform · images
ratingsurl——同步$1.39 / 千次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 · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform

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

profile

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

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

速卖通 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 的调用计费币种无关。
速卖通 返回字段与含义(26)
images
图片链接:商品类能力里是商品轮播图(按商品页顺序),reviews 里是买家晒图。
original_price
原价(划线价)。与 price 对比可算真实折扣。
discount
折扣力度。
description_images
商品描述区图片,来自受限的 AliExpress 媒体正文地址。
variants
商品的规格变体列表。
category_id
分类 ID。
category_path
分类路径。
price_max
价格区间上限(多规格商品)。
sold_count
销量。
shipping
运费与配送方式。
store_id
店铺 ID。
store_name
店铺名称。
store_url
店铺链接。
store_rating
店铺评分。
store_opened_at
店铺开设时间。新店 + 高销量是刷单的常见组合。
original_price_max
原价区间上限(多规格商品)。
sold_text
销量原文(如「10,000+ sold」);是平台展示的约数,不是精确销量。
attributes
商品属性列表(材质、型号等 {name, value} 行)。
ship_to
这次报价与运费对应的收货国家/地区。
total_stock
商品总库存(各规格合计;单个规格的库存在 variants 每项的 stock)。
video_url
商品视频链接。
seller_id
卖家 ID(速卖通自己的公开 ID)。
store_country
店铺所在国家/地区。
store_positive_rate
店铺好评率原文(如 95.2%)。
store_sold_180d
店铺近 180 天销量原文。
store_is_top_rated
店铺是否为平台优质卖家(Top Rated)。

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

variants

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

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

开放平台的属性查询接口把类目下的 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 的调用计费币种无关。
速卖通 返回字段与含义(26)
images
图片链接:商品类能力里是商品轮播图(按商品页顺序),reviews 里是买家晒图。
original_price
原价(划线价)。与 price 对比可算真实折扣。
discount
折扣力度。
description_images
商品描述区图片,来自受限的 AliExpress 媒体正文地址。
variants
商品的规格变体列表。
category_id
分类 ID。
category_path
分类路径。
price_max
价格区间上限(多规格商品)。
sold_count
销量。
shipping
运费与配送方式。
store_id
店铺 ID。
store_name
店铺名称。
store_url
店铺链接。
store_rating
店铺评分。
store_opened_at
店铺开设时间。新店 + 高销量是刷单的常见组合。
original_price_max
原价区间上限(多规格商品)。
sold_text
销量原文(如「10,000+ sold」);是平台展示的约数,不是精确销量。
attributes
商品属性列表(材质、型号等 {name, value} 行)。
ship_to
这次报价与运费对应的收货国家/地区。
total_stock
商品总库存(各规格合计;单个规格的库存在 variants 每项的 stock)。
video_url
商品视频链接。
seller_id
卖家 ID(速卖通自己的公开 ID)。
store_country
店铺所在国家/地区。
store_positive_rate
店铺好评率原文(如 95.2%)。
store_sold_180d
店铺近 180 天销量原文。
store_is_top_rated
店铺是否为平台优质卖家(Top Rated)。

怎么调用 速卖通 评价 API?

reviews

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

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

速卖通 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

速卖通 返回字段与含义(13)
product_id
商品 ID。
images
图片链接:商品类能力里是商品轮播图(按商品页顺序),reviews 里是买家晒图。
sku_id
具体规格的 SKU ID。
sku_info
SKU 规格信息(颜色 / 尺寸等组合)。
logistics
物流方案。
review_id
评价 ID。
author
评价人。
helpful_count
该评价被标为有用的次数。
is_anonymous
是否匿名评价(reviews)。
unhelpful_count
该评价被标为没帮助的次数(reviews)。
original_text
评价原文(reviews;text 可能是机翻后的文本)。
is_translated
text 是否为翻译后的文本(reviews)。
review_labels
评价人给的分项标签(reviews,如尺码合适度、质量、性价比 → 评语)。

怎么调用 速卖通 评分汇总 API?

ratings

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

目前只返回 average_star(平均星级)和 total_reviews(评论总数);各星级分布(five_star 到 one_star,各含 count 数量和 rate 占比)和 positive_rate、neutral_rate、negative_rate 暂时拿不到,恢复后才会重新出现在返回里。

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

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

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

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

速卖通 返回字段与含义(10)
average_star
平均星级。
five_star
五星评价,含 count(条数)和 rate(占比)。
four_star
四星评价,含 count 和 rate。
three_star
三星评价,含 count 和 rate。
two_star
二星评价,含 count 和 rate。
one_star
一星评价,含 count 和 rate。
positive_rate
好评率。
neutral_rate
中评率。
negative_rate
差评率。
total_reviews
评价总数。

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

product_detail

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

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

速卖通 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 的调用计费币种无关。
速卖通 返回字段与含义(26)
images
图片链接:商品类能力里是商品轮播图(按商品页顺序),reviews 里是买家晒图。
original_price
原价(划线价)。与 price 对比可算真实折扣。
discount
折扣力度。
description_images
商品描述区图片,来自受限的 AliExpress 媒体正文地址。
variants
商品的规格变体列表。
category_id
分类 ID。
category_path
分类路径。
price_max
价格区间上限(多规格商品)。
sold_count
销量。
shipping
运费与配送方式。
store_id
店铺 ID。
store_name
店铺名称。
store_url
店铺链接。
store_rating
店铺评分。
store_opened_at
店铺开设时间。新店 + 高销量是刷单的常见组合。
original_price_max
原价区间上限(多规格商品)。
sold_text
销量原文(如「10,000+ sold」);是平台展示的约数,不是精确销量。
attributes
商品属性列表(材质、型号等 {name, value} 行)。
ship_to
这次报价与运费对应的收货国家/地区。
total_stock
商品总库存(各规格合计;单个规格的库存在 variants 每项的 stock)。
video_url
商品视频链接。
seller_id
卖家 ID(速卖通自己的公开 ID)。
store_country
店铺所在国家/地区。
store_positive_rate
店铺好评率原文(如 95.2%)。
store_sold_180d
店铺近 180 天销量原文。
store_is_top_rated
店铺是否为平台优质卖家(Top Rated)。
速卖通 search 调用流程一次 速卖通 search 调用的全过程:向 POST /api/v1/social 发送 platform="aliexpress"、action="search",以及必填参数 keyword;返回结构化 JSON,含 product_id、title、url、price、original_price 等字段;返回列表,单次最多 200 条,计费 $1.39 / 千次(每 50 条算一次:按 limit 要几档扣几次,一条都没返回的档不扣费),失败与空结果不计费。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 / 千次(每 50 条算一次:按 limit 要几档扣几次,一条都没返回的档不扣费),失败与空结果不计费。

速卖通 原始字段名

EveryInfra 统一字段名

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

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

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

  • orders_count
  • ships_from
  • seller_rating
  • store_name
  • store_url
  • original_price_max
  • ship_to
  • total_stock
  • store_id
  • store_country
  • store_opened_at
  • store_positive_rate
  • store_rating
  • store_sold_180d
  • store_is_top_rated
  • sku_info
  • logistics
  • is_anonymous

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/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
是否包邮。
images
图片链接:商品类能力里是商品轮播图(按商品页顺序),reviews 里是买家晒图。
search_rank
在本次搜索结果中的位置(search)。
seller_rating
卖家评分(search)。
seller_url
卖家店铺链接(search)。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
tags
标签数组。无标签时为空数组,不是 null。
id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
text
正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
sold_count
销量。
shipping
运费与配送方式。
variants
商品的规格变体列表。
store_name
店铺名称。
store_url
店铺链接。
description_images
商品描述区图片,来自受限的 AliExpress 媒体正文地址。
price_max
价格区间上限(多规格商品)。
original_price_max
原价区间上限(多规格商品)。
sold_text
销量原文(如「10,000+ sold」);是平台展示的约数,不是精确销量。
attributes
商品属性列表(材质、型号等 {name, value} 行)。
category_id
分类 ID。
category_path
分类路径。
ship_to
这次报价与运费对应的收货国家/地区。
total_stock
商品总库存(各规格合计;单个规格的库存在 variants 每项的 stock)。
video_url
商品视频链接。
store_id
店铺 ID。
seller_id
卖家 ID(速卖通自己的公开 ID)。
store_country
店铺所在国家/地区。
store_opened_at
店铺开设时间。新店 + 高销量是刷单的常见组合。
store_positive_rate
店铺好评率原文(如 95.2%)。
store_rating
店铺评分。
store_sold_180d
店铺近 180 天销量原文。
store_is_top_rated
店铺是否为平台优质卖家(Top Rated)。
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
物流方案。
is_anonymous
是否匿名评价(reviews)。
unhelpful_count
该评价被标为没帮助的次数(reviews)。
language
内容语言代码(如 zh、en),由平台判定,可能不准。
original_text
评价原文(reviews;text 可能是机翻后的文本)。
is_translated
text 是否为翻译后的文本(reviews)。
review_labels
评价人给的分项标签(reviews,如尺码合适度、质量、性价比 → 评语)。
sku_id
具体规格的 SKU ID。
average_star
平均星级。
total_reviews
评价总数。
positive_rate
好评率。
neutral_rate
中评率。
negative_rate
差评率。
five_star
五星评价,含 count(条数)和 rate(占比)。
four_star
四星评价,含 count 和 rate。
three_star
三星评价,含 count 和 rate。
two_star
二星评价,含 count 和 rate。
one_star
一星评价,含 count 和 rate。

请求填写示例

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

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

aliexpress_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer 你的 API 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,
  "images": null,
  "search_rank": null,
  "seller_rating": null,
  "seller_url": 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 也不会替你下单或修改收货地址;运费与可售情况以实际结果为准。

速卖通 教程与实战

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

Blog

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

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

阅读完整文章 →
指南

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

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

阅读完整文章 →
指南

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

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

阅读完整文章 →

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

速卖通 API 怎么收费?

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

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

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

速卖通 API 返回哪些字段?

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

「按商品星级筛选 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 次数据调用),注册后在控制台「余额与充值」兑换,进入赠送余额,24 小⁠时内有效。请先选择 速卖通 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 6 个能力。无需信用卡。

开始调用 速卖通 API

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

免费开始