速卖通商品详情 API

POST

接口健康状态

24h 健康值: 99%
24h 平均耗时: 31.68 s

健康 / 正常
可用
少量可用
基本不可用

24 小时趋势

30 天趋势

商品详情：返回单个对象；主要字段 id、url、name、text、price、original_price。

请求发到 POST https://api.everyinfra.com/api/v1/social，platform 填 aliexpress，action 填 product_detail。单价 $1.39 / 千次（每次 $0.001389），失败和空结果都不收费。同步返回；慢任务可在请求体加 "mode": "async"，先拿 job_id 再轮询。

AI 提示词

请帮我用 EveryInfra 的「速卖通商品详情」接口（aliexpress/product_detail）写一个数据采集脚本。

接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 aliexpress，action 填 product_detail，参数放在 params 里。
- 必填参数：
  - url：AliExpress 商品链接，建议传 https://www.aliexpress.com/item/<商品ID>.html。
- 可选参数：
  - country：product_detail 查询的国家/地区代码，例如 US；默认 US，并转换为大写。它选择商品查询地区，不会修改你的账户国家或实际下单收货地址。
  - currency：product_detail 商品价格的展示币种，例如 USD；默认 USD，并转换为大写。与 EveryInfra API 的调用计费币种无关。
- 返回一个对象，主要字段：id、url、name、text、price、original_price（原价（划线价））、currency、discount（折扣力度）、sold_count（销量）、rating、rating_scale、review_count；一共 36 个字段，完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=aliexpress。
- 示例请求体：
{
  "platform": "aliexpress",
  "action": "product_detail",
  "params": {
    "url": "https://www.aliexpress.com/item/3256806025886958.html"
  }
}
- 计费：$1.39 / 千次；失败和空结果不扣费。
- 一次要采几十上百个时，在请求体加 "mode": "async"：先拿到 job_id，再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时，按错误信息里的候选参数和允许值修正；返回 429 或 503 时，按 Retry-After 等待后重试。

写代码前，先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式，再把方案和大概花费讲给我确认。

请求参数

参数名	位置	类型	必填	默认值	说明
`Authorization`	header	`string`	是	-	Bearer 加你的 API Key。在控制台创建；不要放进网址或代码仓库。
`platform`	body	`string`	是	`aliexpress`	平台标识，固定值。
`action`	body	`string`	是	`product_detail`	能力标识，固定值。
`url`	body.params	`string`	是	-	AliExpress 商品链接，建议传 https://www.aliexpress.com/item/<商品ID>.html。profile 返回商品资料而非用户主页，variants 查商品变体，reviews / ratings 查评论或评分汇总；product_detail 也接收纯数字商品 ID。
`country`	body.params	`string`	否	-	product_detail 查询的国家/地区代码，例如 US；默认 US，并转换为大写。它选择商品查询地区，不会修改你的账户国家或实际下单收货地址。
`currency`	body.params	`string`	否	-	product_detail 商品价格的展示币种，例如 USD；默认 USD，并转换为大写。与 EveryInfra API 的调用计费币种无关。

代码示例

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "aliexpress",
  "action": "product_detail",
  "params": {
    "url": "https://www.aliexpress.com/item/3256806025886958.html"
  }
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。

响应示例

json

{  "id": "req_…",  "platform": "aliexpress",  "action": "product_detail",  "results": {    "id": "•••",    "url": "https://www.aliexpress.com/item/3256806025886958.html",    "name": "Thermal Underwear Tops Men Spring Clothes Thermal Shirt Autumn Men's Winter Tights High Neck Thin Slim Fit Long Sleeve T-shirt",    "price": 1.91,    "original_price": 11.06,    "currency": "USD",    "discount": 83,    "rating": 4.4,    "review_count": 404,    "shipping": [      {        "method": "AliExpress Selection Standard Shipping",        "free_shipping": false,        "ship_from": "China",        "ship_to": "US",        "delivery_days_min": 8,        "delivery_days_max": 13,        "estimated_delivery": "Nov. 01 – Nov. 06",        "tracking": true      }    ],    "variants": [      {        "sku_id": "12000036301240276",        "properties": {          "Color": "Dark Grey",          "Size": "S"        },        "price": 2.23,        "original_price": 11.78,        "stock": 6,        "available": true,        "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/Sd1b109e7315a4b0bb6a0e676dbe81f11N.jpg",        "max_buy_count": 1      },      {        "sku_id": "12000036301240277",        "properties": {          "Color": "Dark Grey",          "Size": "M"        },        "price": 2.43,        "original_price": 12.22,        "stock": 3,        "available": true,        "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/Sd1b109e7315a4b0bb6a0e676dbe81f11N.jpg",        "max_buy_count": 1      },      {        "sku_id": "12000036301240278",        "properties": {          "Color": "Dark Grey",          "Size": "L"        },        "price": 2.21,        "original_price": 11.74,        "stock": 0,        "available": false,        "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/Sd1b109e7315a4b0bb6a0e676dbe81f11N.jpg",        "max_buy_count": 0      }    ],    "store_name": "Shop1102888504 Store",    "store_url": "https://www.aliexpress.com/store/1102892506",    "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S702341bd952e48d19070fda1b1b2c15eI.jpg",    "images": [      "https://ae-pic-a1.aliexpress-media.com/kf/S702341bd952e48d19070fda1b1b2c15eI.jpg",      "https://ae-pic-a1.aliexpress-media.com/kf/S2259b7a7b87445c484e782f739f76593E.jpg",      "https://ae-pic-a1.aliexpress-media.com/kf/S6e96c6eeaa8b44d3bd0189288bd92471o.jpg"    ],    "price_max": 3.15,    "original_price_max": 13.84,    "sold_text": "2,000+ sold",    "attributes": [      {        "name": "Special Features",        "value": "Lightweight"      },      {        "name": "Product Care Instructions",        "value": "Dry Clean Only"      },      {        "name": "Closure Type",        "value": "Pull On"      }    ],    "category_id": "200000783",    "category_path": "•••/•••/•••",    "ship_to": "US",    "total_stock": 96,    "video_url": "https://video.aliexpress-media.com/play/u/ae_sg_item/2215998649727/p/1/e/6/t/10301/5000232324880.mp4",    "store_id": "1102892506",    "seller_id": "•••",    "store_country": "China",    "store_opened_at": "2023-06-12 01:35:24",    "store_positive_rate": "93.9%",    "store_sold_180d": "20,000+",    "store_is_top_rated": false,    "platform": "aliexpress",    "rating_scale": 5  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

业务数据在 results 里；下表是每条记录可能包含的字段，平台没有提供的值不会被编造。

字段	含义
`id`	该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
`url`	该记录在原平台上的可访问链接。
`name`	名称。用于账号/商品/商家类能力，指该对象本身的名字。
`text`	正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。
`price`	价格数值，不含货币符号；币种见 currency。
`original_price`	原价（划线价）。与 price 对比可算真实折扣。
`currency`	价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。
`discount`	折扣力度。
`sold_count`	销量。
`rating`	评分。分制随平台而异，同一行的 `rating_scale` 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。
`rating_scale`	上一列 `rating` 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
`review_count`	评价条数，用于商品/商家类能力。null 表示不公开，不等于 0。
`shipping`	运费与配送方式。
`variants`	规格（SKU）列表，每项一个规格：sku_id、properties（规格名 → 取值，如 Color、Size）、price、original_price、stock、available、image_url、max_buy_count；平台没给的项不出现。
`store_name`	店铺名称。
`store_url`	店铺链接。
`image_url`	图片链接。多图能力可能返回 image_urls 数组。
`images`	图片链接：商品类能力里是商品轮播图（按商品页顺序），reviews 里是买家晒图。
`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）。
`platform`	数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。

错误与计费

401: 缺少 Key 或 Key 无效。
402: 余额不足，先充值。
422: 参数名或取值不对，按错误信息给的候选改；不扣费。
429: 超过每分钟请求上限，按 Retry-After 等待后再试。
503: 暂时无法完成，预扣的费用退回；结果未知时先核对，不要直接重发。
200 空结果: 没有数据，不扣费。

错误码