POST /google_maps_reviews_scraper_sync • Credits: 0.1 credits per review returned

Google Maps Reviews returns the reviews of one Google Maps place as a JSON array. Each review holds the review text, the star rating, the reviewer name, the publish date, and the review ID. Each review costs 0.1 credits, so 50 reviews cost 5 credits.

What Google Maps Reviews does

Google Maps Reviews reads the review list of a single place on Google Maps. The input is the Google Maps URL of that place. Two jobs use this endpoint. The first job watches the reputation of a place: read the newest reviews for your own locations, and find every new one-star review. The second job analyzes reviews in bulk. Pull a large sample of reviews, then run text analysis over the review text. The analysis finds the complaints and the praise that repeat. The limit parameter caps the number of reviews in the response, and it therefore caps the cost of the call.

Endpoint

Method:POST
URL:https://api.richapi.ai/api/v1/google_maps_reviews_scraper_sync
Authentication:x-api-key header
Response: Synchronous JSON array
Credits: 0.1 per review returned

How to send a Google Maps Reviews request

Create an API key in the RichAPI dashboard.
Open the place in Google Maps, then copy the place URL from the address bar.
Set the x-api-key header to your API key.
Set the Content-Type header to application/json.
Add the place URL to google_map_review_url in the request body.
Set limit to the number of reviews that you need.
Set review_sort to the review order that you need.
Send the request to https://api.richapi.ai/api/v1/google_maps_reviews_scraper_sync.
Read the reviews from the JSON array in the response.

CAUTION: Set limit to the number of reviews that you need. RichAPI charges 0.1 credits for every review in the response.

Which parameters does Google Maps Reviews accept?

Parameter	Type	Required	Default	Description
`google_map_review_url`	string	Yes	none	The Google Maps URL of the place.
`limit`	integer	Yes	`5`	The maximum number of reviews to return.
`review_sort`	string	No	`newest`	The review order: `mostRelevant`, `newest`, `highestRanking` or `lowestRanking`.

Google Maps Reviews rejects any other parameter name with 400 and the message Unknown input field(s).

cURL

curl -X POST https://api.richapi.ai/api/v1/google_maps_reviews_scraper_sync   
  -H "x-api-key: YOUR_API_KEY"   
  -H "Content-Type: application/json"   
  -d '{
    "google_map_review_url": "https://www.google.com/maps/place/Starbucks/@40.7128,-74.0060,17z",
    "limit": 10,
    "review_sort": "newest"
  }'

What does Google Maps Reviews return?

Google Maps Reviews returns a JSON array with one object per review. Each review object holds these fields:

Field	Type	Description
`text`	string	The review text.
`stars`	number	The star rating of the review.
`reviewerName`	string	The name of the reviewer.
`publishAt`	string	When the review was published.
`reviewId`	string	The Google ID of the review.

How much does Google Maps Reviews cost?

Google Maps Reviews costs 0.1 credits per review returned, with no base charge. At $0.02 a credit, the rate on the 1,000 and 5,000 credit packs, one review costs $0.002. Larger packs cost less per credit. RichAPI reserves limit x 0.1 credits before the call, charges for the reviews in the response and releases the rest. A call that returns no review costs 0 credits.

Which errors can Google Maps Reviews return?

Status	Meaning	What to do
`400`	The request body failed validation.	Correct the parameter that the error message names.
`401`	The API key is missing, wrong or revoked.	Send a valid key in the `x-api-key` header.
`402`	The organization has no credits left, or the team reached its monthly spend limit.	Buy credits in the RichAPI dashboard.
`403`	`Endpoint not available on your plan`: this API key has no access to this endpoint.	Call `GET /api/v1/my-endpoints` to list the endpoints this key can use. For access, write to [email protected].
`405`	The request used a method other than `POST`.	Send the request again with the `POST` method.
`429`	Too many requests.	Read the `Retry-After` header. Wait that many seconds, then send the request again.
`500`	The API failed.	Send the request again. If the failure repeats, write to [email protected].
`502`	The Google Maps review read failed or was refused.	Send the request again. If the failure repeats, write to [email protected].
`504`	The review read took too long.	Lower `limit`, then send the request again.

RichAPI charges no credit for any response outside the 200 range.