Get reviews

Get the reviews for a location, an account, or everything under your partner, with each review's current response, status, and connection state.

This is the core of the API. Once a location's review sites are connected, reviews are collected on your plan's schedule and this is where you read them. Everything else — responding, flagging, reporting — works on reviews you get from here.

Getting nothing back? A location only has reviews for a site once that site's URL is set. No URL, no data. Set it yourself in Connect review sites, or ask us to find it with the Review profile finder. The first collection usually completes within minutes for Google; other sites follow the plan's schedule.

Two ways to read: Get reviews for a location returns a paginated list you can filter by site, rating, date, response status, or keyword. Get one review returns a single review by its id, with full detail. Use the list to build a feed or sync into your system; use the single call when you already know which review you want.

You'll need a store_id (or your client_location_id), an account id, or nothing at all to read across your whole partner. Review ids come back in every list result.

Endpoints

Get reviews for a location

POST — Get reviews as a paginated list, newest first, each with its response (if any), the location and site it came from, its flag status, and whether you can respond to it.

Open →

Get one review

GET — Get a single review by its id, with its response, the location and site it belongs to, flag status, connection state, and what kinds of response are currently allowed.

Open →


Did this page help you?