Reviews API

Review Management API

Pull reviews from Google Business Profile, Facebook, Trustpilot, and all major sources. Replies post straight to the source from your app, no second login required. Run sentiment, embed widgets, and trigger SMS or email campaigns. One REST API.

// Fetch recent reviews and post a reply
const headers = {
  'Authorization': 'API your_api_key',
  'Content-Type': 'application/json'
};

const locationId = 'TG9jYXRpb246MTI0MjE=';

// 1. Fetch recent reviews
const list = await fetch(
  `https://api.synup.com/api/v4/locations/${locationId}/reviews?startDate=2026-04-01`,
  { headers }
).then(r => r.json());

const interactionId = list.data.interactions.edges[0].node.id;

// 2. Reply: interaction ID goes in the body
await fetch(
  'https://api.synup.com/api/v4/locations/reviews/respond',
  {
    method: 'POST',
    headers,
    body: JSON.stringify({
      interactionId,
      responseContent: 'Thanks, Alex.'
    })
  }
);
Sources

Aggregate reviews from Google, Facebook, Trustpilot, and all major sources

Synup aggregates reviews across the platforms that matter for local: Google Business Profile, Facebook, Trustpilot, and a long tail of industry-specific sources covering travel, healthcare, home services, automotive, and more. Reviews from any source come back through a single response payload with a normalized schema, so your code paths don't fork by platform.

Google Business ProfileFacebookTrustpilot

Need a source we don't list? Add a custom interaction source through the API and reviews from that source flow through the same interactions schema.

Direct posting

Post review responses directly to Google Business Profile and Facebook

When a connected account is in place, POST /api/v4/locations/reviews/respond posts the reply directly to Google Business Profile or Facebook. The customer sees the response in the same place they left the review. No redirect, no second login, no "open Google to respond" friction in your UI.

Without direct posting

"Click here to log into Google to respond."

Most agencies and SMB tools punt the user out of the product. Reply rates drop. Coverage breaks down at scale.

With Synup

One API call. Response posts to the source.

Edits and archives also go through the API. Reply velocity stays high even when one operator is covering 200 locations.

Endpoints

Review Management API endpoints

Reviews show up in Synup as interactions. It's a unified type that covers reviews and ratings from every connected source.

GET/api/v4/locations/{locationId}/reviewsFetch reviews and ratings for a location, with date, source, and rating filters
GET/api/v4/locations/reviewsList reviews by IDs across the account
POST/api/v4/locations/reviews/respondPost a reply to the source platform
POST/api/v4/locations/reviews/respond/editEdit a posted response
POST/api/v4/locations/reviews/respond/archiveArchive a response
GETinteraction analyticsSentiment, ratings, response rate, source breakdown
GETrollup review APIPre-aggregated review metrics for dashboards
GETinteraction sourcesList configured review sources for a location
POSTadd or edit interaction sourceOnboard a custom review source
POSTadd or edit review widgetCreate or update an embeddable review widget
POSTcreate review campaignCreate an SMS or email review request campaign
POSTadd customers to campaignAdd customers to a campaign
Built in

Review Management API capabilities beyond aggregation

Aggregation is the baseline. Direct response posting, sentiment analytics, embeddable widgets, SMS or email campaigns, and custom source onboarding all run through the same API surface.

Direct response posting

Connected-account OAuth means responses post to Google or Facebook directly. Edit and archive flow through the same surface.

Sentiment and rollup analytics

Sentiment breakdowns, average rating, response rate, source mix, and time-series trends. The rollup endpoint pre-aggregates for fast dashboard queries.

Embeddable review widgets

Create a widget config, get a JS snippet, drop it on a customer's site. Sources, minimum rating, and styling are all configurable per widget.

SMS and email campaigns

Trigger review requests after a transaction. Reusable templates carry between campaigns, each one shipping to a branded landing page with its own delivery and performance metrics. Hand the platform a list and it handles the send window and follow-ups.

Custom review sources

Industry-specific platform you need to track? Add it through the interaction-source endpoint and reviews from that source flow through the same interactions schema.

Built for

Use cases for the Review Management API

CRM-triggered review requests

Order ships in Shopify, Synup fires a review campaign. Stripe payment succeeds, SMS goes out 48 hours later. Whatever the trigger, the request lands.

AI agents and MCP

Synup MCP lets Claude or GPT pull every client's reviews, draft responses in the brand's voice, flag reputation risks, and post replies through the same API.

Agency reputation desks

One operator covering hundreds of clients across every platform, in a single inbox. Reply, escalate, or archive through the API or the white-label dashboard built on top of it.

Embedded reputation features

SMB SaaS products that want to add “see your reviews” or “respond to reviews” without building 80 scrapers and OAuth flows.

Reporting and BI

Pipe interactions and interactions/analytics into BigQuery, Looker, or whatever the dashboard layer is. Sentiment over time, response SLA, source distribution.

Start shipping reputation features today

Get an API key and test against our sandbox in minutes. Wire up review aggregation and direct response before any sales call.