Maps and placesAvailable

Google Maps Reviews

The first page of Google Maps reviews for a place (by data_id): rating, text, date, photos and reviewer details. Owner replies are not included yet.

Browse every endpoint with request samples, parameters and its per-request price. One API key calls them all; account limits apply.

API reference Open in Playground

At a glance

Endpoint: POST https://api.serpbase.dev/google/maps/reviews
Price: 2 credits / request
Authentication: X-API-Key
Result type: schemas.source_data

Endpoint and billing rules

POSThttps://api.serpbase.dev/google/maps/reviews

Per-request cost

2 credits / request

Each customer request uses the fixed catalog price, not a per-page rate. Web Crawl and User Agent currently cost 1 credit per request each; User Agent is not free. Genuine not-found results confirmed by source and resource identity are charged. no_results, HTTP 404 or missing hydration/parsed data alone cannot prove absence. Executed failures may currently consume credits; refunds are not guaranteed for every failure. credits_charged reports the actual charge: 0 means reported zero; null or missing means unknown. charge_status UNKNOWN remains unknown even with a numeric charge. Check account records and contact support with request_id; never assume a refund or retry blindly.

Example request parameters

Samples are not the complete parameter list or required-field rules. Known fields are validated; additional parameters are allowed.

Example request parameters
Parameter	Example type	Example value
data_id	string	"0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"

JSON

{
  "data_id": "0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"
}

Samples are not the complete parameter list or required-field rules. Known fields are validated; additional parameters are allowed.
Alias	Parameter	Type
country	locale.country	string
cursor	pagination.cursor	string
dataID	data_id	string
device	options.device	string
gl	locale.country	string
google_domain	locale.engine_domain	string
gooogle_domain	locale.engine_domain	string
hl	locale.language	string
html	include_html	boolean
language	locale.language	string
limit	pagination.limit	integer
markdown	include_markdown	boolean
mobile	options.device	boolean
next_page_token	next_token	string
num	pagination.limit	integer
page	pagination.page	integer
q	query	string
results	pagination.limit	integer
topic_id	attributes.topic_id	string

Supported devices: desktop; default: desktop.

Request examples

cURL

curl -X POST 'https://api.serpbase.dev/google/maps/reviews' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"data_id":"0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"}'

JavaScript

const response = await fetch("https://api.serpbase.dev/google/maps/reviews", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
  },
  "body": "{\"data_id\":\"0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa\"}"
});
const result = await response.json();
// Check result.status and result.error for the API outcome.
console.log(result);

Response and API outcome

Responses are JSON. HTTP 200 is not proof of search success: inspect status and error. Fields depend on the product contract and upstream data.

View response documentation

Frequently asked questions

How much does the Google Maps Reviews API cost?

Each request costs 2 credits. Credits come from prepaid packs or the monthly plan, and new accounts start with free credits.

How do I call the Google Maps Reviews API?

Send a POST request to https://api.serpbase.dev/google/maps/reviews with your API key in the X-API-Key header. The response is JSON; check status (0 means success).

Which devices does it support?

Supported devices: desktop. The default is desktop.

Is the Google Maps Reviews API available now?

Yes. Any active API key can call it.