Skip to main content

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

1

Trustpilot API credentials

Register at Trustpilot Business → Integrations → API. You’ll get an API key (public) and OAuth credentials (private endpoints).
2

Business Unit ID

Find your business unit ID via GET /business-units/find?name=yourdomain.com.
3

Mavera API key

Get your key from Mavera dashboard.
4

Environment variables

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"

Jobs

#JobTrustpilot DataMavera SurfaceOutput
1Review Text → Brand VoicePositive reviews (4-5 star)Brand VoiceVoice profile from customer language
2TrustScore Monitoring → Reputation ResponseScore trendsMave Agent + GenerateRoot cause analysis + response drafts
3Star Distribution → Persona SegmentationReviews by star ratingPersonas + Focus Groups”What would move you to 5 stars?“
4Competitor TrustScore ComparisonCompetitor domainsMave AgentCompetitive positioning analysis
5Review Response Generation1-3 star reviewsBrand Voice + GeneratePersonalized review responses

Rate Limits & Production Notes

Trustpilot EndpointAuthStrategy
Public review endpointsAPI key (?apikey=)Rate varies by plan; add 200ms delays
Business unit lookupAPI keyCache results — business data changes slowly
Reply to reviewOAuth 2.0Rate limited per business unit; queue responses
Star-filtered reviewsAPI keySeparate call per star level required
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.
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

All Integrations

Trustpilot API

Brand Voice

Personas

Focus Groups

Mave Agent