​
接口说明

TikTok Shop Reviews API 获取 TikTok Shop 商品评论、星级、发布时间和图片等数据。

​
请求URL

POST https://scrapeapi.pangolinfo.com/api/v1/ecommerce/tiktok/reviews

​
请求头

参数名参数值类型说明
Content-Typeapplication/jsonstring数据格式
AuthorizationBearer xxxstring认证凭证

采集超时90秒，客户端超时建议至少105秒。

​
请求参数

参数必填类型说明
productIdNostring商品ID，必须用字符串传递；与productUrl二选一。
productUrlNostring配置站点的商品链接，可替代productId。
最多字符: 2048
includeNativeNoboolean默认true，保留原始平台字段。
allowStaleNoboolean默认false；true允许失败时返回旧缓存，meta会注明。
refreshNoboolean默认false；true跳过新鲜缓存。

productId 与 productUrl 至少填写一项；商品 ID 必须使用字符串。

​
支持站点

国家码默认每页最大每页
US55

仅返回首屏推荐的 5 条评论，不支持翻页。

​
响应值

返回值类型说明
codeinteger状态码，0 表示成功。
messagestring响应信息，成功时为 ok。
pointCostnumber本次完整响应实际消耗的积点。
dataobject | null返回数据，字段见下表。

​
返回参数 data 说明

返回值类型说明
countrystring采集站点国家，不代表评论作者的国家。
paginationobject分页结果，续页时使用 nextPage。
productIdstring商品 ID，以字符串返回。
queryobject本次生效的检索参数。
warningsstring[]采集范围及数据口径提示。
storestringstore
totalsobject平台报告总量与本次返回数量，口径可能不同。
platformstring平台标识。
sourceUrlstringsourceUrl
providerstringprovider
metaobject采集状态、缓存信息等元数据。
schemaFingerprintstringschemaFingerprint
capturedAtstring本次数据采集时间。
productSummaryobject商品整体评分及星级分布。
resultsobject[]本次返回的主体记录数组。
statisticsobjectstatistics

​
data.pagination 字段说明

返回值类型说明
nextPagenull下一页页码；null 表示结束。
totalPagesinteger总页数；未知时为 null。
pageSizeinteger每页记录数。
hasNextboolean是否还有下一页。
pageinteger本次页码。

​
data.totals 字段说明

返回值类型说明
queryinteger本次生效的检索参数。
reportedintegerreported
returnedintegerreturned
withTextintegerwithText

​
data.meta 字段说明

返回值类型说明
cachestringcache
stalebooleanstale
ageSecondsintegerageSeconds
operationIdstringoperationId
upstreamAttemptsintegerupstreamAttempts
coalescedbooleancoalesced

​
data.productSummary 字段说明

返回值类型说明
withTextCountnull有文字的评论数量；平台未提供时为 null。
reviewCountnull评论总数；平台未提供时为 null。
averageRatingnumber商品整体平均评分。
scopestring汇总覆盖范围。
warningsany[]采集范围及数据口径提示。
sourcestring统计数据来源。
totalCountinteger平台统计总数，含义由 countKind 说明。
countKindstring统计口径，区分全部评分与文字评论。
starDistributionobject1–5 星对应的数量。

​
data.productSummary.starDistribution 字段说明

返回值类型说明
1integer1
2integer2
3integer3
4integer4
5integer5

​
data.results[] 字段说明

返回值类型说明
reviewIdstring评论唯一标识。
contentstring正文，保留平台原文。
titlestring | null评论或帖子标题，缺失时为 null。
authorstring | null作者名称。
starstring | null评论星级，以字符串返回，如 5.0。
datestring | null平台评论日期。
createdAtstring | null发布时间，保留完整时间；不可用时为 null。
purchasedboolean | null是否已验证购买；未知时为 null。
imgsstring[]图片 URL 数组。
photosany[]保留图片各尺寸的原始对象。
videosany[]视频数组。
nativeobject平台原始字段；includeNative 控制是否返回。

​
data.statistics 字段说明

返回值类型说明
sellerobjectseller
soldCountstringsoldCount
skusobject[]skus
sortRulestringsortRule
hasMorebooleanhasMore
titlestring评论或帖子标题，缺失时为 null。

​
data.statistics.seller 字段说明

返回值类型说明
namestringname
idstring记录唯一标识。

​
data.statistics.skus[] 字段说明

返回值类型说明
specificationstringspecification
skuIdstringskuId

imgs 兼容 Best Buy CA 的 imageUrl 和 Judge.me 的 original；photos 保留各尺寸原对象。评论星级、日期等缺失值保留 null。

失败保留统一响应外壳及 data.error；参数错误 code=1002、限流4029、暂忙5001、采集失败9200。HTTP 503 冷却响应保留 Retry-After。

​
请求示例

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/ecommerce/tiktok/reviews \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "productId": "1731986560485069148"
}'

​
返回示例

下例截取实际响应首条列表记录，长文本和链接作了缩写；pointCost 为完整响应的实际费用。

{
  "code": 0,
  "pointCost": 4.0,
  "data": {
    "country": "US",
    "pagination": {
      "nextPage": null,
      "totalPages": 1,
      "pageSize": 5,
      "hasNext": false,
      "page": 1
    },
    "productId": "1731986560485069148",
    "query": {
      "includeRatings": true,
      "pageSize": 5,
      "page": 1,
      "sort": "recommended"
    },
    "warnings": [
      "Live pagination can shift as reviews are added. Deduplicate by review ID and reconcile page 1."
    ],
    "store": "roborock",
    "totals": {
      "query": 5,
      "reported": 45,
      "returned": 5,
      "withText": 5
    },
    "platform": "tiktok",
    "sourceUrl": "https://shop.tiktok.com/us/pdp/1731986560485069148",
    "provider": "tiktok-pdp",
    "meta": {
      "cache": "miss",
      "stale": false,
      "ageSeconds": 0,
      "operationId": "265e603a-2050-40b1-b058-dff867f89250",
      "upstreamAttempts": 1,
      "coalesced": false
    },
    "schemaFingerprint": "1ecdb1b4f4753fd549d700c30caaa083e25e5f6897a9c9499d948ef9fb2244be",
    "capturedAt": "2026-11-07T11:49:53.053Z",
    "productSummary": {
      "withTextCount": null,
      "reviewCount": null,
      "averageRating": 4.8,
      "scope": "upstream_product_or_review_group",
      "warnings": [],
      "source": "TikTok Shop PDP review_info.review_ratings",
      "totalCount": 45,
      "countKind": "platform_review_total",
      "starDistribution": {
        "1": 1,
        "2": 0,
        "3": 0,
        "4": 3,
        "5": 41
      }
    },
    "results": [
      {
        "date": "2026-06-11",
        "imgs": [
          "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/2756ff21c292408c9e558e4c489d3bca~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=5..."
        ],
        "merchantResponses": [],
        "syndication": {
          "incentivized": false,
          "reviewerCountry": "US",
          "sku": "Qrevo S5V-White",
          "skuId": "1732412412024033628"
        },
        "star": "5.0",
        "author": "S**t",
        "actualProductId": "1731986560485069148",
        "videos": [],
        "language": null,
        "title": null,
        "photos": [
          "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/2756ff21c292408c9e558e4c489d3bca~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=5..."
        ],
        "content": "If I could give this thing more than 5 stars I would. We just installed spc flooring in our main living area, it is so nice to have “Rosie” vacuum and mop da...",
        "createdAt": "2026-06-11T17:44:47.052Z",
        "actualProductUrl": null,
        "purchased": true,
        "native": {
          "review_id": "7650195141623121677",
          "reviewer_avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/6301c26037cf24d7f491a2055c4b11da~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=3...",
          "sku_specification": "Qrevo S5V-White",
          "sku_id": "1732412412024033628",
          "display_image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/2756ff21c292408c9e558e4c489d3bca~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=5...",
          "is_incentivized_review": false,
          "product_name": "Roborock Qrevo S5V Robot Vacuum and Mop - 12000Pa Suck, Anti-Collision, Wi-Fi, Auto-Self-Emptying, Auto-Refill Mopping, Warm Air Drying, FlexiArm Edge Moppin...",
          "review_rating": 5,
          "review_images": [
            "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/2756ff21c292408c9e558e4c489d3bca~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=5..."
          ],
          "reviewer_name": "S**t",
          "product_id": "1731986560485069148",
          "reviewer_id": "7286084275620250670",
          "review_time": "1781199887052",
          "review_text": "If I could give this thing more than 5 stars I would. We just installed spc flooring in our main living area, it is so nice to have “Rosie” vacuum and mop da...",
          "review_country": "US",
          "is_verified_purchase": true
        },
        "reviewId": "7650195141623121677"
      }
    ],
    "statistics": {
      "seller": {
        "name": "RoborockUS",
        "id": "7495314483238570332"
      },
      "soldCount": "635",
      "skus": [
        {
          "specification": "Qrevo S5V-White",
          "skuId": "1732412412024033628"
        }
      ],
      "sortRule": "recommended",
      "hasMore": true,
      "title": "Roborock Qrevo S5V Robot Vacuum and Mop - 12000Pa Suck, Anti-Collision, Wi-Fi, Auto-Self-Emptying, Auto-Refill Mopping, Warm Air Drying, FlexiArm Edge Moppin..."
    }
  },
  "message": "ok"
}

​
积点消耗说明

每条评论消耗0.8积点，同一响应内按唯一评论计费。

每次成功请求独立计费，命中缓存也按返回主体收费；失败及空列表不扣费，以 pointCost 为准。