POST

接口健康状态

24h 健康值
0%
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
基本不可用

24 小时趋势

30 天趋势

评价:返回列表,默认 20 条、单次最多 100 条;主要字段 id、text、rating、rating_scale、posted_at、sku。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页按这一页的条数计费,每 20 条算一次调用。

请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 taobao,action 填 reviews。 单价 $5.56 / 千次(每次 $0.005556),失败和空结果都不收费。 每 20 条算一次:按 limit 要几档扣几次,一条都没返回的档不扣费。 同步返回;慢任务可在请求体加 "mode": "async",先拿 job_id 再轮询。

淘宝评价接口按商品读取买家评价,每条带评价正文、评分、发布时间、购买的规格、买家昵称、评价图片,以及卖家对这条评价的回复。它回答「买家对这件商品满意吗、问题集中在哪」,适合做口碑分析、差评归因,以及提炼竞品的卖点和痛点。

url 和商品详情用的是同一种商品标识:数字 ID、商品链接或含唯一商品链接的分享文本。sku 能把评价对应到具体规格,适合比较不同颜色、尺码的反馈;seller_reply 能看出商家怎么处理差评。比较评分前先看同一行的 rating_scale。

AI 提示词

#
请帮我用 EveryInfra 的「淘宝评价」接口(taobao/reviews)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 taobao,action 填 reviews,参数放在 params 里。
- 必填参数:
  - url:product_detail / reviews / questions 接收商品数字 ID、淘宝/天猫商品 URL,或含唯一商品 URL 的分享文本。
- 可选参数:
  - page:评价的页码,1–50,新的在前,一页通常 20 条(末页更少)。带 page 就直接取这一页、整页给,limit 不起作用;不带 page 和以前一样从第 1 页开始,用 next_page_token 往下翻。
  - page_token:翻页令牌。第 1 页不用传;响应里有 next_page_token 时,把它原样作为 page_token 传回就拿下一页,其余参数保持不变(limit 可以改)。
  - limit:这次调用最多返回的条数,整数,1–100;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。(默认 20)
- 返回一组记录,每条记录的主要字段:id、text、rating、rating_scale、posted_at、sku(规格)、buy_count(购买人数)、useful_count(评价被标有用次数)、author_name、author_avatar_url(评价人头像链接(reviews))、images(图片链接列表:product_de…)、review_append(买家追评正文(有多条时按时间顺序换…);一共 14 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=taobao。
- 示例请求体:
{
  "platform": "taobao",
  "action": "reviews",
  "params": {
    "url": "https://item.taobao.com/item.htm?id=744983869996"
  }
}
- 计费:$5.56 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

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

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是taobao平台标识,固定值。
actionbodystring是reviews能力标识,固定值。
urlbody.paramsstring是-product_detail / reviews / questions 接收商品数字 ID、淘宝/天猫商品 URL,或含唯一商品 URL 的分享文本;e.tb.cn / m.tb.cn 短链仅在可安全解析为商品页时接受。纯淘口令、过期链接和非商品页会拒绝。
pagebody.paramsinteger否-评价的页码,1–50,新的在前,一页通常 20 条(末页更少)。带 page 就直接取这一页、整页给,limit 不起作用;不带 page 和以前一样从第 1 页开始,用 next_page_token 往下翻。每页算一次调用;翻过末页返回空结果、不扣费。淘宝每个商品最多给前 1,000 条评价(第 50 页),51 起扣费前拒。pagination.has_more 为 true 就还有下一页:接着传 page 加 1,或把 next_page_token 作为 page_token 传回;page 和 page_token 同传时以 page_token 为准。翻页期间有新评价进来,相邻两页可能有一两条重复,合并时按评价 id 去重。
page_tokenbody.paramsstring否-翻页令牌。第 1 页不用传;响应里有 next_page_token 时,把它原样作为 page_token 传回就拿下一页,其余参数保持不变(limit 可以改)。也可以不用令牌,直接传 page 要第几页(见 page);两者同传时以 page_token 为准。令牌 24 小时内有效,只能用于同一个商品、同一个账户;换了商品会被拒(422,不扣费)。响应里没有 next_page_token(pagination.has_more 为 false)就是到底了。每页给 limit 条(默认 20,最多 100),下一页从上一页最后一条之后接着给。评价新的在前;翻页期间有新评价进来,相邻两页可能有一两条重复,合并时按评价 id 去重。每页单独计费,按这一页的条数算:每 20 条算一次调用(20 条一次,21–40 条两次,100 条五次);返回不足时没用到的几次退回,一条都没返回的空页不扣费。
limitbody.paramsinteger (1–100)否20这次调用最多返回的条数,整数,1–100;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。

代码示例

#
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": "taobao",
  "action": "reviews",
  "params": {
    "url": "https://item.taobao.com/item.htm?id=744983869996"
  }
}'

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

响应示例

#
2026年9月26日 16:56(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息;id、billing、quota 每次调用都不同,只给结构。
json
{  "id": "req_…",  "platform": "taobao",  "action": "reviews",  "results": [    {      "text": "質量過關,用着挺放心的,之前那個用了幾年時間,用不了,綠聯質量太好了",      "rating": 5,      "posted_at": "2026.08.27 21:28",      "platform": "taobao",      "rating_scale": 5    }  ],  "next_page_token": …,  "pagination": { … },  "count": 1,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

#

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

字段含义
id该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
text正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
rating评分。分制随平台而异,同一行的 rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。
rating_scale上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
posted_at发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
sku规格。
buy_count购买人数。
useful_count评价被标有用次数。
author_name作者昵称(显示名)。
author_avatar_url评价人头像链接(reviews)。
images图片链接列表:product_detail、search 是商品图(search 不含主图 image_url),reviews 是买家晒图(没晒图时没有这个字段)。
review_append买家追评正文(有多条时按时间顺序换行拼接;没有追评时字段不出现)。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
next_page_token翻页令牌:作为下一次请求的 page_token 原样传回取下一页(其余参数不变,24 小时内有效,只能用于同一个商品);同一页每行的值相同,响应顶层也有同一个 next_page_token。没有该字段即到底。
seller_reply卖家对该评价的回复。

常见问题

#

评价能按规格区分吗?

#

能。每条评价的 sku 是买家购买的规格,按它分组就能比较不同颜色、尺码或套餐的口碑;useful_count 是评价被标为有用的次数,可以帮你挑出更有参考价值的评价。

怎么看商家对差评的处理?

#

看 seller_reply,它是卖家对这条评价的回复。把低分评价和卖家回复放在一起读,能看出常见问题是什么、商家通常怎么处理。

能翻页、直接跳到第几页吗?怎么算钱?

#

能,两种翻法。按页码:传 page(1–50)直接取那一页,一页通常 20 条,每页算一次调用,limit 不起作用。按令牌:把响应里的 next_page_token 原样作为 page_token 传回,每页给 limit 条(默认 20,最多 100),每 20 条算一次调用,返回不足时没用到的几次退回。两种都是响应里有 next_page_token 就还有下一页,空页不扣费,同传时以 page_token 为准。淘宝每个商品最多给前 1,000 条评价。

错误与计费

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

错误码

Google Analytics 同意才加载 隐私