.png)
Trustpilot Integration Guide
Connect Trustpilot business profiles, reviews, invitations, and consumer data with enterprise applications through REST APIs, selected webhook events, and Martini workflows.
Trustpilot integration options at a glance
Trustpilot provides REST APIs for Business Units, Service Reviews, Product Reviews, Review Invitations, Consumers, and related business data. Applications authenticate with API keys or OAuth 2.0 bearer access tokens, subject to the relevant API product and account permissions. Trustpilot also supports webhook-style notifications for selected events, although coverage is limited and should be confirmed for each account. Martini can consume these APIs, receive supported callbacks, schedule incremental synchronization, paginate through review data, and expose normalized REST endpoints to downstream applications. Where webhook coverage is insufficient, Martini workflows can poll Trustpilot, checkpoint progress, apply transformations, and handle throttling and retries.
Common Trustpilot integration patterns
Common Trustpilot data objects used in integrations
Authentication and security considerations
Authentication options
Trustpilot documents API-key authentication and OAuth 2.0 bearer access tokens, depending on the API product, account, and granted permissions. Exact scopes should be confirmed before implementation.
Credential protection
Store Trustpilot API keys, OAuth client secrets, and access tokens in Martini environment configuration or secrets management. Do not embed credentials in workflows, mappings, or source payloads.
Data protection
Consumer names, email addresses, transaction references, and review content may be personal or sensitive data. Use HTTPS, least-privilege permissions, limited field storage, and defined retention and deletion policies.
Operational considerations for Trustpilot integrations
Rate limits and pagination
Confirm limits for the applicable Trustpilot API and account. Process paginated responses with controlled concurrency, exponential backoff for throttling, and checkpoints that advance only after successful downstream processing.
Idempotency and reconciliation
Use stable Trustpilot review and invitation identifiers for upserts. Invitation workflows should use an internal idempotency key. Periodic reconciliation is recommended because webhook coverage is limited and callbacks may be retried or delivered more than once.
Schema and content handling
Review content can contain Unicode, links, HTML-like text, localized fields, and optional properties. Preserve identifiers, ratings, timestamps, and status values while applying safe target-system escaping and validation.
Testing and operations
Test authentication, permissions, pagination, throttling, duplicate callbacks, edited or hidden reviews, and downstream failures. Monitor workflow logs and define retry, dead-letter, and manual-reconciliation procedures.
Why use Martini instead of scripts or point-to-point integrations?
Orchestration instead of isolated scripts
Martini coordinates Trustpilot API calls, webhook handling, scheduled polling, target-system writes, validation, and business rules in reusable workflows rather than distributing logic across one-off scripts.
Maintainable data transformation
Mappings and transformations can normalize reviews, invitations, Consumers, and Business Units for different applications while preserving source identifiers and audit fields.
Reliable enterprise processing
Martini supports controlled retries, checkpointing, idempotent upserts, secure environment configuration, and operational monitoring. This helps integrations remain dependable as destinations, rules, and Trustpilot API requirements evolve.
Reusable APIs
Martini can expose an internal REST API façade for invitation requests or normalized Trustpilot data, allowing enterprise applications to use a controlled contract without each application implementing Trustpilot authentication and pagination independently.