raw.taobao.comments

淘宝/天猫商品评价

实时Beta

GEThttps://api.qovia.ai/v1/raw/taobao/comments

淘宝和天猫商品的买家评价，从新到旧，每页 20 条：评价内容和时间、好评/中评/差评、SKU、买家昵称（平台已打码）和会员等级、晒图和视频、追评和商家回复。 item_id 填淘宝或天猫的商品 ID 均可。默认跳过没有内容的默认好评（带追评的仍保留）。 has_more 为 false 时停止翻页。商品没有评价或不存在时返回空结果，不计费。

常见用途：口碑与评论分析、舆情监测，比如找出用户最常夸和最常抱怨的点。

价格: $0.0135 / 次$13.5 / 千次 · 固定价格
计费: 成功且有结果才扣费扣费写在 meta.charged_usd
权限: raw:taobaoAPI Key 需要这个 scope
限速: 不限流不按账户或接口限制每分钟请求数

请求参数

作为查询参数发送

只接受下列参数，多出的参数会返回 400。

item_idstring必填

淘宝或天猫商品 ID（商品链接里的 id=）

格式^[1-9][0-9]{5,19}$

示例611261922146

pageinteger

页码，从 1 开始；has_more 为 false 时停止

默认1范围1–500

skip_default_reviewsboolean

true（默认）跳过没有内容的默认好评（带追评的仍保留）；false 返回全部评价

默认true

curl 'https://api.qovia.ai/v1/raw/taobao/comments?item_id=611261922146' \
  -H "Authorization: Bearer $QOVIA_KEY"

把 $QOVIA_KEY 换成你的 API Key

示例响应200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "items": [
      {
        "id": "eco_tao_e35d27d45024",
        "cid": "1316054905552",
        "text": "其实线上买药很方便也很优惠很好，",
        "rating_level": "good",
        "likes": 0,
        "created_at": "2026-10-03T21:27:00+08:00",
        "sku": "套餐类型:1盒装[基础体验【欧洲原研进口】]",
        "user_name": "刘***7",
        "user_level": 0,
        "anonymous": true,
        "images": [
          "https://img.alicdn.com/imgextra/i4/4611686018427385600/O1CN01bZPUiKO6BBJ1SdaC_!!4611686018427385600-0-rate.jpg_400x400.jpg"
        ],
        "videos": [],
        "shop_reply": null,
        "followup": {
          "text": "相信",
          "days_after_receipt": 16,
          "images": [
            "https://img.alicdn.com/imgextra/i1/4611686018427385600/O1CN01L74IopdbT1I1SdaC_!!4611686018427385600-0-rate.jpg_400x400.jpg"
          ],
          "videos": [],
          "shop_reply": "感谢您的认可，也谢谢您的晒图和追评。能让您买药更方便、享受到实惠，我们很高兴。…"
        }
      },
      {
        "id": "eco_tao_9b5c72573494",
        "cid": "1316866273768",
        "text": "我觉得性价比一般，有点贵。效果还可以",
        "rating_level": "good",
        "likes": 0,
        "created_at": "2026-10-14T21:08:00+08:00",
        "sku": "套餐类型:1盒装[基础体验【欧洲原研进口】]",
        "user_name": "欣***笑",
        "user_level": 0,
        "anonymous": false,
        "images": [
          "https://img.alicdn.com/imgextra/i3/4611686018427380977/O1CN01mo211OzAnAF2BxNI_!!4611686018427380977-0-rate.jpg_400x400.jpg"
        ],
        "videos": [],
        "shop_reply": null,
        "followup": null
      }
    ],
    "page": 1,
    "has_more": true,
    "total": 400,
    "total_exact": false,
    "prov": {
      "hash": "0x7b921e36e8cf1b4c",
      "ts": "2026-10-21T19:59:04+08:00",
      "source": "live"
    }
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.013500",
    "balance_usd": "9.986500",
    "empty": false
  }
}

目录示例，不是实时数据

响应

成功返回 HTTP 200 和统一信封：request_id、data（本接口的数据，见示例）、meta（扣费信息）。结果为空时同样是 200，meta.empty 为 true，不扣费，data 可能为空结构或 null。

响应结构详解

错误码

这个接口可能返回的错误码
code	HTTP	计费	说明
`scope_denied`	403	不扣费	这个 API Key 没有该接口需要的权限（scope）。
`endpoint_unavailable`	503	不扣费	接口暂不可用（尚未接入数据源，或价格未配置），没有执行。
`invalid_params`	400	不扣费	参数没有通过校验：缺少必填、类型或格式不对、数组超过允许的条数、有多余参数，或 POST 请求体不是 JSON 对象。单个参数的错误以参数名开头（`item_id: …`），缺少必填或多出参数以 `params: …` 开头。
`insufficient_balance`	402	不扣费	余额不足以支付这次调用，请先充值。
`upstream_busy`可重试	503	已退款	数据源繁忙或在冷却，已退款，按 `Retry-After` 重试。
`upstream_timeout`	504	已退款	数据源超时，已退款。
`upstream_error`	502 / 503	已退款	数据源返回失败，已退款。
`upstream_rejected`	400	已退款	数据源拒绝了这组参数（格式合法但不被接受），已退款。
`not_found`	404	已退款	数据源里没有这条数据（已删除或 ID 不存在），已退款。
`reservation_expired`	504	已退款	处理时间过长，已自动退款，没有返回数据。

任何请求还可能返回认证错误：401 invalid_api_key、403 account_disabled、429 too_many_auth_failures。

全部错误码

在浏览器里直接调用

需要登录并充值；调试台调用和 API 调用一样计费。

在调试台试用创建 API Key

请求参数

响应

错误码

淘宝与天猫的其他接口