# Trustpilot 评价 API (trustpilot.reviews)

- Canonical page: https://everyinfra.com/trustpilot-api/reviews
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "trustpilot", "action": "reviews", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 200 per call
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=trustpilot&action=reviews

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| company | not declared | yes | not declared | 待查公司的官网域名，例如 example.com，或完整 Trustpilot /review/域名 链接；不是任意公司中文名。reviews 读取该公司的具体评价。 |
| date | enum: last12months / last30days / last3months / last6months / last7days | no | not declared | 按发布时间取最近一段：last7days、last30days、last3months、last6months、last12months（往前推 7、30、92、183、366 天）；留空不限，别的值回 422，不接受具体日期。 |
| lang | not declared | no | not declared | 评价语言代码，两位 ISO 639-1，可传单个代码或数组，例如 en 或 ["en","de"]，覆盖 language。 |
| language | not declared | no | not declared | 单个评价语言代码，两位 ISO 639-1，例如 en/fr/de/es；不传时返回 Trustpilot 默认的英语评价；传 lang 时以 lang 为准。 |
| sort | enum: newest / recency / relevance | no | not declared | 评价排序：recency 或 newest 按最新评价（默认，两种写法同义），relevance 按相关性；别的值回 422。 |
| stars | not declared | no | not declared | 评价星级字符串数组，例如 ["1","2"] 只取一、二星，支持 1–5；留空不按星级筛选，不是最低星级数字。 |
| verified_only | not declared | no | not declared | 是否仅取已验证评价，使用布尔值 true / false；这是评价的验证标签，不代表公司经过 EveryInfra 审核。 |
| limit | integer (1–200) | no | 20 | 这次调用最多返回的条数，整数，1–200；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
| text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
| rating | 评分。**分制随平台而异**，同一行的 `rating_scale` 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。 |
| rating_scale | 上一列 `rating` 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。 |
| language | 内容语言代码（如 zh、en），由平台判定，可能不准。 |
| like_count | 点赞数。null 表示该平台或该接口不公开此数据，不等于 0。 |
| is_verified | 是否为平台认证账号（蓝V等）。null 表示无法判定。 |
| verification_level | 评价的验证等级（邀请评价/自发评价）。 |
| source | 评价来源。 |
| country | 国家或地区。可能是全称也可能是 ISO 代码，取决于平台，未归一。 |
| author_name | 作者昵称（显示名）。 |
| author_id | 作者在原平台的唯一 ID。 |
| author_image | 评价人头像。 |
| author_review_count | 评价人历史评价数。 |
| reply_text | 商家回复。 |
| reply_at | 商家回复时间。 |
| experience_at | 消费发生时间（区别于评价发布时间）。 |
| updated_at | 更新时间。 |
| posted_at | 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。 |
| company_name | 公司名称。 |
| company_domain | 公司域名。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "trustpilot",
  "action": "reviews",
  "params": {
    "company": "pipedrive.com"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "trustpilot",
        "action": "reviews",
        "params": {
            "company": "pipedrive.com",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "trustpilot",
  "action": "reviews",
  "results": [
    {
      "id": "6ab516bdf6b3a0e76ca64942",
      "url": "https://www.trustpilot.com/reviews/6ab516bdf6b3a0e76ca64942",
      "title": "Training from Walid was outstanding",
      "text": "Training from Walid was outstanding. He knows the system inside out and took the time to learn my business and to find the most useful and relevant tools to focus on. His sessions were engaging and I've been able to get PipeDrive working perfectly for us in a very short space of …",
      "rating": 5,
      "language": "en",
      "like_count": 0,
      "is_verified": false,
      "verification_level": "not-verified",
      "source": "Organic",
      "country": "IE",
      "author_name": "•••",
      "author_id": "•••",
      "author_review_count": 1,
      "reply_text": "Hi Paul,\n\nThank you so much for sharing your feedback!\n\nWe’re delighted to hear that the team provided such an outstanding training experience. It’s great to know that they took the time to understand your business and tailor the sessions to the tools and features most relevant t…",
      "reply_at": "2026-09-24T14:36:05+00:00",
      "experience_at": "2026-09-24T00:00:00+00:00",
      "posted_at": "2026-09-24T14:25:33+00:00",
      "company_name": "Pipedrive",
      "company_domain": "pipedrive.com",
      "platform": "trustpilot",
      "rating_scale": 5
    },
    {
      "id": "6ab39f79780950e2d7706185",
      "url": "https://www.trustpilot.com/reviews/6ab39f79780950e2d7706185",
      "title": "Useful and great session with PipeDrive",
      "text": "Rafael was very clear. Going through the session, he had some nice tips and insights. Was very helpful!",
      "rating": 5,
      "language": "en",
      "like_count": 0,
      "is_verified": false,
      "verification_level": "invited",
      "source": "BasicLink",
      "country": "NL",
      "author_name": "•••",
      "author_id": "•••",
      "author_review_count": 1,
      "reply_text": "Hi Lisa,\n\nThank you for sharing your feedback!\n\nWe’re delighted to hear that the team was clear and helpful throughout the session, and that his tips and insights were valuable to you.\n\nBest regards,\nPipedrive Team",
      "reply_at": "2026-09-23T11:55:49+00:00",
      "experience_at": "2026-09-23T00:00:00+00:00",
      "posted_at": "2026-09-23T11:44:25+00:00",
      "company_name": "Pipedrive",
      "company_domain": "pipedrive.com",
      "platform": "trustpilot",
      "rating_scale": 5
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=trustpilot
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md