POST /v1/reviews
Google Reviews API
Fetch Google reviews for any business by place ID or CID: rating, date, text, reviewer and the owner's reply. You get the first reviews Google shows a logged-out visitor (usually 5), in its most relevant order.
Overview
What the Google Reviews API does
The Google Reviews API returns public reviews for one place. Identify the place with place_id, cid or fid (all three come back from the Maps and Places APIs). Google Maps shows logged-out visitors at most the first 10 reviews of a place in its most relevant order, and since October 2026 usually only the first 5, so that is what the API returns: sort other than most_relevant is a 400, and paging ends where Google's list does (no next_page_token).
Pricing follows the data: 1 credit per 10 reviews. A full page of 10 reviews is 1 credit.
Runnable Python and Node.js examples are on GitHub in SerpKite/google-reviews-api.
What you get
-
reviews[]array - rating, date, iso_date, snippet (review text), likes, user {name, thumbnail, reviews}, response {snippet, date}.
-
next_page_tokenstring - Pass back as page_token to get the next page. Absent once the first 10 reviews are reached.
-
requestobject - Echo of the normalized request (endpoint, engine, q, country, language, page…), handy for logging.
-
metaobject - request_id, credits_used, cached, engine, latency_ms, resolved_urls and parse_quality. parse_quality=empty means the call was not billed.
Request
curl https://api.serpkite.com/v1/reviews \
-H "Authorization: Bearer $SERPKITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"place_id":"ChIJLU7jZClu5kcR4PcOOO6p3I0"}'Response (illustrative, placeholder domains)
{
"request": {
"endpoint": "reviews",
"engine": "google",
"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0",
"sort": "most_relevant",
"language": "en"
},
"results": [
{
"rating": 5,
"date": "3 days ago",
"iso_date": "2026-09-26T09:14:00Z",
"snippet": "Best flat white in the neighborhood. Staff explained the single-origin options without being pushy.",
"likes": 2,
"user": {
"name": "Alex P.",
"reviews": 37
},
"response": {
"snippet": "Thanks Alex, see you soon!",
"date": "2 days ago"
}
},
{
"rating": 3,
"date": "1 week ago",
"iso_date": "2026-09-21T15:02:00Z",
"snippet": "Great beans, but the queue on Saturday morning was 20 minutes.",
"user": {
"name": "Sam K.",
"reviews": 4
}
}
],
"meta": {
"request_id": "req_01J8ZK4M6Q2V7",
"credits_used": 1,
"engine": "google",
"cached": false,
"latency_ms": 812,
"resolved_urls": true,
"parse_quality": "ok"
}
}
Every response also carries X-Credits-Used, X-Credits-Remaining,
X-Cache and X-Tokens-Estimate headers.
Run this query in the playground
Reference
Parameters
The parameters /v1/reviews accepts, in the JSON body or the query string.
| Name | Type | Default | Description |
|---|---|---|---|
place_id
required
|
string | – | Google place ID. Or pass cid or fid instead (one of the three is required). |
cid
|
string | – | Google customer ID (CID) of the place. |
fid
|
string | – | Google feature ID of the place. |
sort
|
string | most_relevant | most_relevant. Google shows other orders only to signed-in visitors, so newest, highest_rating and lowest_rating return 400 (not charged). |
num
|
integer | 10 | Reviews per call. At most 10: Google shows logged-out visitors the first 10 reviews of a place. Billed 1 credit per 10. |
page_token
|
string | – | next_page_token from the previous response, for the next page. |
language
|
string | en | Interface language, as a language code with an optional region (en, de, pt-BR, zh-TW…). |
format
|
string | json | Response format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. Values: json, compact, markdown. |
fields
|
string | – | Comma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens. |
max_age
|
integer | – | Accept a cached result up to this many seconds old. Cache hits cost 50% of the credits. |
Full reference, error codes and headers are in the /v1/reviews reference. Queue up to 100 requests at half price with POST /v1/batches.
Use cases
What people build with the Google Reviews API
Review monitoring
Check the top reviews of your locations daily and alert on new 1–2 star ones.
Sentiment analysis
Feed review text to an LLM to extract themes and complaints.
Competitor benchmarking
Compare ratings and recurring topics across competing locations.
Reputation dashboards
Aggregate reviews for all your locations in one place.
Pricing
Google Reviews API pricing
Cost per call
1 credit
per 10 reviews
- From $0.60 per 1,000 calls at volume.
- Credits never expire. No subscription.
- Failed, empty and blocked calls are refunded.
- 2,500 free credits = 2,500 calls, then 1,000 credits a month.
For reference: Serper lists Google searches at $1.00 per 1k on its entry tier and $0.30 at its best tier, and its credits expire after 6 months. SerpKite credits cost $1.00 to $0.60 per 1k.
| Pack | Price | Per 1k credits | Per 1k calls | Calls per pack |
|---|---|---|---|---|
| Starter | $10 | $1.00 | $1.00 | 10,000 |
| Growth | $50 | $0.80 | $0.80 | 62,500 |
| Pro | $300 | $0.60 | $0.60 | 500,000 |
FAQ
Google Reviews API: common questions
Keep exploring
Related APIs and integrations
Start building
Start with the Google Reviews API
2,500 free credits, then 1,000 every month. No credit card.