接口健康状态
- 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 等待后重试。
写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。请求参数
#| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。 |
platform | body | string | 是 | taobao | 平台标识,固定值。 |
action | body | string | 是 | reviews | 能力标识,固定值。 |
url | body.params | string | 是 | - | product_detail / reviews / questions 接收商品数字 ID、淘宝/天猫商品 URL,或含唯一商品 URL 的分享文本;e.tb.cn / m.tb.cn 短链仅在可安全解析为商品页时接受。纯淘口令、过期链接和非商品页会拒绝。 |
page | body.params | integer | 否 | - | 评价的页码,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_token | body.params | string | 否 | - | 翻页令牌。第 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 条五次);返回不足时没用到的几次退回,一条都没返回的空页不扣费。 |
limit | body.params | integer (1–100) | 否 | 20 | 这次调用最多返回的条数,整数,1–100;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。 |
代码示例
#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。
响应示例
#{ "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 空结果
- 没有数据,不扣费。