Developer docs
The API and the Claude connector read TrustMetrics. They do not call Google and they do not post replies. Guides: API keys, events, REST, MCP. The OpenAPI document is /api/v1/openapi.json. A narrative page is also at /developers.
Plan gates
- events:write and POST /api/v1/events: growth.
- Read scopes and the read API: scale.
- MCP: growth.
- Scopes: events:write, read:reviews, read:stats, read:requests. 600 requests a minute per key, 50,000 a day per organization.
REST paths
| Method | Path | Summary |
|---|---|---|
| GET | /locations | List locations |
| GET | /reviews | List stored reviews |
| GET | /replies | List stored replies |
| GET | /ratings | Google rating totals stored at sync |
| GET | /stats | Report stats |
| GET | /review-requests | List review requests |
| GET | /review-requests/stats | Review request counts |
| GET | /leaderboard | Location leaderboard |
| POST | /events | Schedule a review request |
Coming soon: GET /reviews, GET /replies, and GET /ratings return 404. Stored Google review text is not available to organization API keys.
MCP
Connector URL https://trustmetrics-v2.vercel.app/api/mcp. Path /api/mcp. 60 requests a minute and 5,000 a day. Scopes: reviews:read — Read reviews, replies, and ratings stored in TrustMetrics. stats:read — Read response stats and review-request counts. insights:read — Read review themes.
- list_locations — List locations in the connected organization that this user can access. Read-only. Does not call Google.
- get_reviews — Read reviews stored in TrustMetrics for locations this user can access. Only reviews still inside the 30-day storage window are returned. Filters: location_id, since, until (ISO-8601, until is exclusive), min_rating, max_rating, has_reply, limit (max 100), cursor. Does not call Google.
- get_ratings_summary — Google's own average rating and total review count as last stored at sync, with an as-of time, worded on Google. This is not an average of stored review rows. Does not call Google.
- get_replies — Reply text stored in TrustMetrics, with manual or AI when that is known, and when it was updated. Does not include the review text. Does not call Google or post a reply.
- get_review_themes — Theme counts for stored reviews in a period. When Insights has no theme rows yet, says themes are available in Insights. Does not call Google. period: last_month, since_joining, or YYYY-MM.
- get_stats — New reviews, response rate, median response time, and request activity. Uses the same calculations as the in-app report, on reviews stored in TrustMetrics only. period: last_month, since_joining, or YYYY-MM. Does not call Google.
- get_review_requests_stats — Review requests TrustMetrics sent, link clicks, and follow-ups. These are TrustMetrics records, not a Google count. period: last_month, since_joining, or YYYY-MM.