EveryInfra

电商数据 · 数据 API

速卖通

速卖通 API

跨境商品详情、SKU 变体、评分与买家评论——选品、比价与差评归因。POST /api/v1/social 就行,返回结构化 JSON,$1.39 / 千次/次、失败不计费。

6

个能力

$1.39 / 千次

每次调用

秒级

响应

1 个

API Key 通 87 平台

速卖通 能力清单

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
profileurl同步$1.39 / 千次product_id · title · url · price · price_max · original_price · currency · rating · rating_scale · review_count · variant_count · brand · category_id · category_path · ships_from · seller_country · store_id · store_name · store_url · store_rating · store_sales · store_opened_at · image_url · platform
variantsurl同步$1.39 / 千次product_id · title · url · variant_count · platform · sku_id · name · properties · color_hex · image_url · price · original_price · currency · stock · available
reviewsurlsort默认 20 · 最多 200同步$1.39 / 千次review_id · text · rating · rating_scale · posted_at · country · author · sku_info · helpful_count · logistics · product_id · platform
ratingsurlsort同步$1.39 / 千次average_star · total_reviews · positive_rate · neutral_rate · negative_rate · five_star · four_star · three_star · two_star · one_star · platform · count · rate
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 · platform

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

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

怎么调用 速卖通 关键词搜索 API?

search

使用 platform="aliexpress"action="search" 调用“关键词搜索”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 product_id、title、url、price、original_price、currency 等 18 个字段

keyword必填
检索关键词。
min_price可选
最低价格,数值。
min_rating可选
最低评分。量纲随平台而异(多为 5 分制)。
sort可选
排序方式。取值随平台而异,见该能力的 allowed_values。
速卖通 特有返回字段与含义(8
product_id
商品 ID。
original_price
原价(划线价)。与 price 对比可算真实折扣。
discount
折扣力度。
orders_count
累计订单数。AliExpress 上这是比评分更硬的信任指标。
free_shipping
是否包邮。
ships_from
发货地。
seller_name
卖家名称。
is_top_rated
是否为平台认证的优质卖家。

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

profile

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

url必填
目标页面的完整链接,直接从该平台复制。
速卖通 特有返回字段与含义(15
product_id
商品 ID。
original_price
原价(划线价)。与 price 对比可算真实折扣。
ships_from
发货地。
variant_count
规格变体数量。
brand
品牌。
category_id
分类 ID。
category_path
分类路径。
price_max
价格区间上限(多规格商品)。
store_id
店铺 ID。
store_name
店铺名称。
store_url
店铺链接。
store_rating
店铺评分。
store_sales
店铺总销量。
store_opened_at
店铺开设时间。新店 + 高销量是刷单的常见组合。
seller_country
卖家所在国家。

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

variants

使用 platform="aliexpress"action="variants" 调用“商品变体”能力;返回单个对象,主要包含 product_id、title、url、variant_count、platform、sku_id 等 15 个字段

url必填
目标页面的完整链接,直接从该平台复制。
速卖通 特有返回字段与含义(8
product_id
商品 ID。
original_price
原价(划线价)。与 price 对比可算真实折扣。
variant_count
规格变体数量。
sku_id
具体规格的 SKU ID。
properties
商品属性键值对。
color_hex
颜色的十六进制值。
stock
库存数量。
available
是否有货。

怎么调用 速卖通 评价 API?

reviews

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

url必填
目标页面的完整链接,直接从该平台复制。
sort可选
排序方式。取值随平台而异,见该能力的 allowed_values。
查看全部 2 个允许值

newestrelevance

速卖通 特有返回字段与含义(6
product_id
商品 ID。
sku_info
SKU 规格信息(颜色 / 尺寸等组合)。
logistics
物流方案。
review_id
评价 ID。
author
评价人。
helpful_count
该评价被标为有用的次数。

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

ratings

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

url必填
目标页面的完整链接,直接从该平台复制。
sort可选
排序方式。取值随平台而异,见该能力的 allowed_values。
查看全部 2 个允许值

newestrelevance

速卖通 特有返回字段与含义(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 等 18 个字段

url必填
目标页面的完整链接,直接从该平台复制。
country可选
国家/地区,ISO 3166-1 代码(如 CN、US)。
currency可选
价格币种,ISO 4217 代码(如 CNY、USD)。
速卖通 特有返回字段与含义(7
original_price
原价(划线价)。与 price 对比可算真实折扣。
discount
折扣力度。
store_name
店铺名称。
store_url
店铺链接。
variants
商品的规格变体列表。
sold_count
销量。
shipping
运费与配送方式。
速卖通 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 · 响应 · 最多 200 条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 统一字段名

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

只有 速卖通 返回的字段

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

  • orders_count
  • ships_from
  • category_path
  • seller_country
  • store_id
  • store_name
  • store_url
  • store_rating
  • store_sales
  • store_opened_at
  • sku_id
  • properties
  • color_hex
  • sku_info
  • logistics
  • average_star
  • positive_rate
  • neutral_rate

返回字段含义

字段名跨 87 个平台统一,同一个键在哪个平台都是同一个意思—— 这也是换平台只需改 platform 一个字段的原因。 机器可读版:/api/v1/social/fields

title
标题。平台无标题概念时(如纯文本帖)为 null。
url
该记录在原平台上的可访问链接。
price
价格数值,不含货币符号;币种见 currency。
currency
价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
rating
评分。分制随平台而异,同一行的 rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
review_count
评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
image_url
图片链接。多图能力可能返回 image_urls 数组。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
text
正文内容,已去除 HTML 标签。长文可能被截断。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
country
国家或地区。可能是全称也可能是 ISO 代码,取决于平台,未归一。
id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。

另有 速卖通 特有字段 product_id · original_price · discount · orders_count · ships_from · seller_name · is_top_rated · free_shipping · price_max · variant_count · brand · category_id · category_path · seller_country · store_id · store_name · store_url · store_rating · store_sales · store_opened_at · sku_id · properties · color_hex · stock · available · review_id · author · sku_info · helpful_count · logistics · average_star · total_reviews · positive_rate · neutral_rate · negative_rate · five_star · four_star · three_star · two_star · one_star · count · rate · sold_count · shipping · variants,保留该平台自身的语义。

30 秒调用示例

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":"咖啡"}}'

返回长这样

response.json
{
  "id": "aliexpress_…",
  "search": [
    {
      "product_id": "…",
      "title": "…",
      "url": "https://…",
      "price": "…",
      "original_price": "…",
      "currency": "…",
      "discount": "…",
      "rating": 128,
      "rating_scale": "…",
      "orders_count": 128,
      "review_count": 128,
      "image_url": "https://…",
      "ships_from": "…",
      "seller_name": "…",
      "category": "…",
      "is_top_rated": true,
      "free_shipping": "…",
      "platform": "aliexpress"
    }
  ],
  "count": 20,
  "billing": { "charged": true, "credits": 100, "cny": 0.009356 }
}

常见用例

关键词监控

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

口碑与差评告警

拉 速卖通 的评论做评分走势与差评归因,新差评第一时间入库推送。

账号与主体画像

按 速卖通 的主页数据建达人/商家档案,做投放筛选或竞品盯防。

价格与库存监控

追踪 速卖通 的商品价格、库存与详情变化,波动即告警。

速卖通 API 常见问题

速卖通 API 怎么调用?

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

速卖通 API 怎么收费?

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

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

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

速卖通 API 返回哪些字段?

search 返回 product_id、title、url、price、original_price、currency 等 18 个字段。其中 25 个字段只有 速卖通 会返回(见上方「独有字段」)。字段名跨平台统一,换平台不用改解析代码。

速卖通怎么按关键词批量采集?

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

速卖通账号资料怎么批量抓取?

调 POST /api/v1/social,传 platform="aliexpress"、action="profile",必填参数 url。返回单个对象,没有条数上限;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,账号资料字段为 product_id、title、url、price、price_max。

速卖通评价怎么批量采集?

调 POST /api/v1/social,传 platform="aliexpress"、action="reviews",必填参数 url。单次最多 200 条,一次调用一次计费、不按条数加价;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,评价数据字段为 review_id、text、rating、rating_scale、posted_at。

速卖通商品详情怎么批量采集?

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

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

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

开始调用 速卖通 API

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

免费开始