Review site catalogue

The review sites we support, with the id you'll use to connect each one, plus tools for managing site logins across many locations.

The review sites we support, with the id you'll use to connect each one, plus tools for managing site logins across many locations.

Prerequisites

  • A bearer token in the Authorization header. Any endpoint that needs no token says so on its own page.
  • The id of each record the call targets. Every endpoint page lists the ids it needs.

Errors

StatusMeaning
401The bearer token is missing, expired or invalid
403The token is valid but the record sits outside your account
422The request failed validation — the response names the fields
500Unexpected server error

Individual endpoints may return more; each page lists its own.

Endpoints

MethodEndpointDescription
POSTList supported review sitesReturns the selectable review-site catalog (value/label pairs) available to an account — the union of review sites attached (via plan_review_sites) to the plans assigned to the account's account(s) — with partner-specific sites first, then Google (44) and Yelp (1).
POSTApply one site login to many locationsBulk-sets username + password for one review site across every store under an account, switching review collection on for each, and optionally persists the credentials so future stores inherit them.
GETGet an account's saved site loginsGet the saved review-site login (username only, never the password) stored at the company/account level for a given review site.
DELETERemove an account's saved site loginDelete a saved company-level review-site login (a company_meta_data row of category review_site).
POSTExport site setup to a spreadsheetGenerate an Excel export of all review-site credentials for the stores under the given Account, stores the file on S3, and returns its public download URL.
POSTImport site setup from a spreadsheetUpload a filled-in review-site credentials Excel file for an Account, validates its header row, stores it on S3, and emails a confirmation to the support address for back-office processing.
POSTList an account's locationsReturns a paginated list of stores accessible to the authenticated user, each joined to full location, account, and geo detail plus the active store_plan (with plan features) and a generated connect_page_url.