> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mavera.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Trustpilot

> Integrate Mavera with Trustpilot — brand voice from reviews, TrustScore monitoring, star-based persona segmentation, competitor comparison, and review response generation

## Overview

Pull data from **Trustpilot** (Reviews, TrustScores, Star Distributions, Competitor Data) → analyze with **Mavera** (Brand Voice, Mave Agent, Personas, Focus Groups, Generate) → turn consumer review data into brand intelligence, persona-validated messaging, and automated review responses.

<Info>
  **Trustpilot API** — Base URL: `https://api.trustpilot.com/v1/`. Auth: **API Key** (public endpoints) or **OAuth 2.0** (private/business endpoints). Rate limits: vary by endpoint and plan tier. Pagination via `page` and `perPage` params.
</Info>

***

## Prerequisites

<Steps>
  <Step title="Trustpilot API credentials">Register at [Trustpilot Business](https://businessapp.b2b.trustpilot.com/) → Integrations → API. You'll get an API key (public) and OAuth credentials (private endpoints).</Step>
  <Step title="Business Unit ID">Find your business unit ID via `GET /business-units/find?name=yourdomain.com`.</Step>
  <Step title="Mavera API key">Get your key from [Mavera dashboard](https://app.mavera.io/settings/api-keys).</Step>

  <Step title="Environment variables">
    ```bash theme={"dark"}
    export TRUSTPILOT_API_KEY="your_trustpilot_api_key"
    export TRUSTPILOT_SECRET="your_trustpilot_secret"
    export TRUSTPILOT_BU_ID="your_business_unit_id"
    export MAVERA_API_KEY="mvra_live_xxxxx"
    ```
  </Step>
</Steps>

***

## Jobs

| # | Job                                                                           | Trustpilot Data             | Mavera Surface          | Output                                |
| - | ----------------------------------------------------------------------------- | --------------------------- | ----------------------- | ------------------------------------- |
| 1 | [Review Text → Brand Voice](review-brand-voice)                               | Positive reviews (4-5 star) | Brand Voice             | Voice profile from customer language  |
| 2 | [TrustScore Monitoring → Reputation Response](trustscore-reputation-response) | Score trends                | Mave Agent + Generate   | Root cause analysis + response drafts |
| 3 | [Star Distribution → Persona Segmentation](star-persona-segmentation)         | Reviews by star rating      | Personas + Focus Groups | "What would move you to 5 stars?"     |
| 4 | [Competitor TrustScore Comparison](competitor-comparison)                     | Competitor domains          | Mave Agent              | Competitive positioning analysis      |
| 5 | [Review Response Generation](review-response-generation)                      | 1-3 star reviews            | Brand Voice + Generate  | Personalized review responses         |

***

## Rate Limits & Production Notes

| Trustpilot Endpoint     | Auth                 | Strategy                                        |
| ----------------------- | -------------------- | ----------------------------------------------- |
| Public review endpoints | API key (`?apikey=`) | Rate varies by plan; add 200ms delays           |
| Business unit lookup    | API key              | Cache results — business data changes slowly    |
| Reply to review         | OAuth 2.0            | Rate limited per business unit; queue responses |
| Star-filtered reviews   | API key              | Separate call per star level required           |

<Warning>
  Trustpilot rate limits vary by plan tier and aren't always documented precisely. Start with 200ms delays between calls and back off on 429. For high-volume review monitoring, use Trustpilot webhooks instead of polling.
</Warning>

**Checklist:**

* Use API key for read operations, OAuth for write (replies, flags)
* Business Unit ID required for most endpoints — find via domain lookup
* Star filters require one call per star value
* Cache TrustScore and competitor data (changes slowly)
* Queue generated responses for human review before posting
* Monitor Mavera credits at [Dashboard](https://app.mavera.io/settings/usage)

***

<CardGroup cols={3}>
  <Card title="All Integrations" icon="plug" href="/integrations" />

  <Card title="Trustpilot API" icon="star" href="https://documentation-apidocumentation.trustpilot.com/" />

  <Card title="Brand Voice" icon="microphone" href="/features/brand-voice" />

  <Card title="Personas" icon="user" href="/features/personas" />

  <Card title="Focus Groups" icon="users" href="/features/focus-groups" />

  <Card title="Mave Agent" icon="brain" href="/features/mave-agent" />
</CardGroup>