Review Management
Pull reviews from Google and Facebook into one place, then reply where the platform allows it, all from inside your own product. Your team works one set of endpoints instead of different consoles.
curl -X POST https://listingsapi.com/api/v4/locations/reviews/respond \
-H "Authorization: API $LISTINGSAPI_KEY" \
-d '{"interactionId":"9e26d2a8-a6ed-42ea-8454-47d1c92ea841","responseContent":"Thanks for the kind words, glad we could help."}' {
"interactionId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841",
"interactionStatus": "CREATED",
"responseContent": "Thanks for the kind words, glad we could help."
} What you can build
A review inbox for every client
Pull each location's reviews with one call and merge Google and Facebook into a single client view. Account managers reply to Google and Facebook in the same screen instead of logging into each source.
Reviews inside your own product
Add a reviews tab to the product your customers already use, backed by the reviews and reviewDetails endpoints. Post owner replies through one endpoint and read the status back so your UI can confirm the reply went live.
Edit or archive
Change a published reply or take it down with the edit and archive calls on the same endpoint set. A correction is one API call instead of a trip to the native dashboard.
Read the review, post the reply, same API
Best cortado in the Mission. Fast wifi, friendly staff.
Waited fifteen minutes at the counter on Saturday.
From API key to live in four steps
Send your API key
Every request carries your Listings API key in the Authorization header. The same key reads reviews and posts replies.
Authorization: API <key> Pull the review stream
Fetch reviews for a location and filter to what you need, such as source or rating. One response covers Google and Facebook.
GET /api/v4/locations/{locationId}/reviewsOpen a single review
Load full detail for one review when a user clicks in, so you can show the complete text and its metadata.
GET /api/v4/reviewDetailsPost the reply
Send interactionId and responseContent to publish a public owner reply on the source site. The response returns interactionStatus CREATED.
POST /api/v4/locations/reviews/respondFAQs
Which review sources can I aggregate?
The reviews endpoint pulls Google, Facebook, and Yelp into one response per location. Google and Facebook are available on every plan, and Yelp is available on Growth and Enterprise. You read them through the same call, so your product does not need a separate integration for each site.
Where can I post replies?
Owner replies post to Google and Facebook through a connected profile using POST /api/v4/locations/reviews/respond. Yelp reviews are available to read but not to reply to through the API. Check canRespond on the interaction before you call, because not every source accepts owner replies.
Can I discover the review sites my business is rated on?
Yes. We crawl most sites where your business is reviewed. Call GET /api/v4/locations/{locationId}/reviews/settings to see the review sources for a location, or GET /api/v4/reviews/site-config for the sources available on your account.
How do I edit or remove a reply?
Send the new text to POST /api/v4/locations/reviews/respond/edit to change a published reply, or call POST /api/v4/locations/reviews/respond/archive to take it down. Both act on a reply you have already posted.
What data does the analytics overview return?
GET /api/v4/locations/{locationId}/review-analytics-overview returns the review analytics for the monitored review sources configured on your account. The overview gives total-reviews, new-reviews, overall-rating and review response rate.
Ship review management within minutes
Point your product at the reviews and respond endpoints with one Listings API key and give your users Google and Facebook in a single stream.