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.
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.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.Prerequisites
Trustpilot API credentials
Register at Trustpilot Business → Integrations → API. You’ll get an API key (public) and OAuth credentials (private endpoints).
Mavera API key
Get your key from Mavera dashboard.
Jobs
| # | Job | Trustpilot Data | Mavera Surface | Output |
|---|---|---|---|---|
| 1 | Review Text → Brand Voice | Positive reviews (4-5 star) | Brand Voice | Voice profile from customer language |
| 2 | TrustScore Monitoring → Reputation Response | Score trends | Mave Agent + Generate | Root cause analysis + response drafts |
| 3 | Star Distribution → Persona Segmentation | Reviews by star rating | Personas + Focus Groups | ”What would move you to 5 stars?“ |
| 4 | Competitor TrustScore Comparison | Competitor domains | Mave Agent | Competitive positioning analysis |
| 5 | 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 |
- 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