接口说明

Trustpilot Comments API 获取 Trustpilot 评论数据,支持接口列出的分页、排序或筛选参数。

使用 Pangolinfo API Key 调用,返回结构化 JSON 数据。

请求URL

POST https://scrapeapi.pangolinfo.com/api/v1/social/trustpilot-comments

请求头

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

采集最长约75秒,客户端超时建议设为90秒。

请求参数

参数必填类型说明
targetYesstringTrustpilot 商家页链接,也可直接传商家域名(如 roborock.com.au)或官网任意链接(如 https://www.roborock.com/en)
optionsNoobject仅处理下列开放参数;未列出的字段忽略,内部参数不可覆盖。

options 参数说明

参数必填类型说明
maxPagesNointeger本次请求翻几页,默认 1,最大 5,按实际返回条数计费,更多数据用返回的游标续取
默认值: 1
最小值: 1
最大值: 5
cursorNostring | null续取评论: 上次输出的 pagination.comments.cursor
sortNostring评论排序, 默认 recency (最新)
languagesNostring评论语言, 如 en / de; 默认 all (全部语言)
starsNointeger只要某个星级的评论 (1-5)
最小值: 1
最大值: 5
dateNostring发布时间范围: last30days / last3months / last6months / last12months; 默认不限;可选值:last30days / last3months / last6months / last12months
可用值: [“last30days”, “last3months”, “last6months”, “last12months”]
topicsNostring[] | string评论主题ID,最多10项,多个取交集;接受字符串数组或英文逗号分隔字符串,去除空白与空项。ID来自trustpilot-post返回的post.topics[].id。

仅处理本页列出的请求参数,其他字段忽略。分页游标原样传回,不编码、解码或转换格式。

每次默认1页,最多5页;页数必须为正整数,超过5按5处理。

topics可传最多10个主题ID(数组或英文逗号分隔字符串),去除空白和空项,多个主题取交集;不额外获取商家热门提及。

响应值

返回值类型说明
codeinteger状态码,0 表示成功
messagestring响应信息,成功时为 ok
pointCostnumber本次请求实际消耗的积点
dataobject返回数据,结构见下表
metaobject请求标识及耗时(毫秒)
billingobject计费条数、单价及规则版本

返回参数 data 说明

返回值类型说明
typestringType
可用值: [“comments”]
commentsCountnumber | null当前筛选下的评论数
commentsobject[]评论, 与 trustpilot-post 同形
paginationobject评论分页

data.comments[] 字段说明

返回值类型说明
idstring评论 id
urlstring评论链接
titlestring | null评论标题
contentstring | null评论正文
ratingnumber | null星级 (1-5)
likesnumber | null有用数
languagestring | null语言代码
sourcestring | null来源, 如 Organic / BannerRedirect
timeobject | null发布时间
experiencedAtobject | null消费日期
updatedAtobject | null修改时间; 没改过为 null
nicknamestring | null评论者显示名
avatarstring | null评论者头像
profileUrlstring | null评论者主页
posterobject评论者
verificationobject评论验证
locationany门店 (多门店商家); 没有为 null
productReviewsany[]商品评价 (上游原样)
consumersReviewCountOnSameDomainnumber | null评论者对该商家写过的评论数
merchantReplyobject | null商家回复; 没有为 null

data.comments[].time 字段说明

返回值类型说明
textstring | null上游原始时间文本
valuenumber | null解析后的毫秒时间戳; 解析失败为 null

data.comments[].experiencedAt 字段说明

返回值类型说明
textstring | null上游原始时间文本
valuenumber | null解析后的毫秒时间戳; 解析失败为 null

data.comments[].updatedAt 字段说明

返回值类型说明
textstring | null上游原始时间文本
valuenumber | null解析后的毫秒时间戳; 解析失败为 null

data.comments[].poster 字段说明

返回值类型说明
idstring | null评论者 id
countryCodestring | null评论者国家代码
reviewsCountnumber | null评论者写过的评论数
verifiedboolean评论者是否认证

data.comments[].verification 字段说明

返回值类型说明
isVerifiedboolean是否验证过的评论
levelstring | null验证级别, 如 invited / not-verified
sourcestring | null验证来源

data.comments[].merchantReply 字段说明

返回值类型说明
contentstring | null回复内容
timeobject | null回复时间
updatedAtobject | null回复修改时间

data.pagination 字段说明

返回值类型说明
commentsobjectComments

data.pagination.comments 字段说明

返回值类型说明
cursorstring | null下一页游标, 传回 options.cursor 续取; 到底 (或匿名 10 页上限) 为 null
hasMoreboolean是否还有更多

请求示例

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/social/trustpilot-comments \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "target": "https://www.trustpilot.com/review/trustpilot.com"
}'

返回示例

下例截取实际响应中的首条列表记录,长文本与链接作了缩写;pointCost 为该次完整响应的实际费用。完整字段结构可在在线调试页查看。

{
  "code": 0,
  "message": "ok",
  "pointCost": 6.4,
  "data": {
    "type": "comments",
    "commentsCount": 538486,
    "comments": [
      {
        "id": "6aed760cee9bc831d2d07c5a",
        "url": "https://www.trustpilot.com/reviews/6aed760cee9bc831d2d07c5a",
        "title": "Very helpful and it did help resolve…",
        "content": "Very helpful and it did help resolve the issue with the previous review, meaning BookRun did refund the money.. Thank you for helping the public and provide ...",
        "rating": 5,
        "likes": 0,
        "language": "en",
        "source": "BannerRedirect",
        "time": {
          "text": "2026-11-06T08:39:08.000Z",
          "value": 1793954348000
        },
        "experiencedAt": {
          "text": "2026-11-06T00:00:00.000Z",
          "value": 1793923200000
        },
        "updatedAt": null,
        "nickname": "Nan Li",
        "avatar": "https://user-images.trustpilot.com/6785e0c78fb275334e266551/73x73.png",
        "profileUrl": "https://www.trustpilot.com/users/6785e0c78fb275334e266551",
        "poster": {
          "id": "6785e0c78fb275334e266551",
          "countryCode": "US",
          "reviewsCount": 4,
          "verified": false
        },
        "verification": {
          "isVerified": true,
          "level": "invited",
          "source": "invitation"
        },
        "location": null,
        "productReviews": [],
        "consumersReviewCountOnSameDomain": 1,
        "merchantReply": null
      }
    ],
    "pagination": {
      "comments": {
        "cursor": "1.8",
        "hasMore": true
      }
    }
  },
  "meta": {
    "requestId": "pg-audit-r1-trustpilot-comments-1793954367975930100",
    "durationMs": 3124
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 8,
    "pointCost": 6.4
  }
}

积点消耗说明

每条一级评论消耗 0.8 积点,附带回复免费。支持独立回复模式的接口按返回的直接回复条数计费,每条0.8积点,回复附带的下一层免费。

空结果、失败响应不扣费。同一响应中相同 ID 只计一次,独立调用和续页分别计费。详见 社媒评论 API 计费说明。

在线调试