​
接口说明

Trustpilot Search API 按关键词搜索 Trustpilot 内容，返回搜索结果及对应信息。

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

​
请求URL

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

​
请求头

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

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

​
请求参数

参数必填类型说明
targetYesstring搜索关键词
optionsNoobject仅处理下列开放参数；未列出的字段忽略，内部参数不可覆盖。

​
options 参数说明

参数必填类型说明
maxPagesNointeger本次请求翻几页，默认 1，最大 5，按实际返回条数计费，更多数据用返回的游标续取
默认值: 1
最小值: 1
最大值: 5
cursorNostring | null续页: 上次输出的 pagination.cursor
semanticNoboolean语义搜索 (experiment=semantic_search_enabled), 召回更宽; 默认 false (关键词)

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

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

​
响应值

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

​
返回参数 data 说明

返回值类型说明
businessesobject[]搜索结果
countnumber本次返回条数
querystring搜索词
searchModestring | nullkeyword / semantic
totalResultsnumber | null结果总数
paginationobjectPagination

​
data.businesses[] 字段说明

返回值类型说明
idstring | null商家 id
namestring | null商家名
identifyingNamestring | null商家域名
urlstring | nullTrustpilot 商家页, 可传给 trustpilot-post
trustScorenumber | nullTrustScore
starsnumber | null星级
reviewsCountnumber | null评论数
locationany地址 (上游原样)
contactanywebsite / email / phone (上游原样)
categoriesobject[]类目
isRecommendedInCategoriesboolean是否类目推荐
ranknumber结果排名 (从 1 开始)

​
data.businesses[].categories[] 字段说明

返回值类型说明
idstring | null类目 id
namestring | null类目名
isPrimaryboolean是否主类目
isPredictedboolean是否推测类目

​
data.pagination 字段说明

返回值类型说明
cursorstring | null下一页游标, 传回 options.cursor 续取
hasMoreboolean是否还有更多

​
请求示例

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

​
返回示例

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

{
  "code": 0,
  "message": "ok",
  "pointCost": 4.0,
  "data": {
    "businesses": [
      {
        "id": "5c99e2af592c22000106c917",
        "name": "Roborock",
        "identifyingName": "roborock.com.au",
        "url": "https://www.trustpilot.com/review/roborock.com.au",
        "trustScore": 1.5,
        "stars": 1.5,
        "reviewsCount": 333,
        "location": {
          "address": null,
          "city": null,
          "zipCode": null,
          "country": null
        },
        "contact": {
          "website": "https://roborock.com.au",
          "email": null,
          "phone": null
        },
        "categories": [
          {
            "id": "electronics_store",
            "name": "Electronics Store",
            "isPrimary": false,
            "isPredicted": false
          }
        ],
        "isRecommendedInCategories": false,
        "rank": 1
      }
    ],
    "count": 5,
    "query": "Roborock",
    "searchMode": "keyword",
    "totalResults": 22,
    "pagination": {
      "cursor": "1.5",
      "hasMore": true
    }
  },
  "meta": {
    "requestId": "pg-audit-r1-trustpilot-search-1793954372021021200",
    "durationMs": 3243
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 5,
    "pointCost": 4.0
  }
}

​
积点消耗说明

每条主体结果消耗 0.8 积点。

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

在线调试