Skip to main content
POST
Read reviews for known places (Google Maps)

Authorizations

Authorization
string
header
required

Workspace API key. Create one via the dashboard or POST /v1/auth/keys.

Headers

Idempotency-Key
string

Deduplicates BOTH the response and the credit deduction: it becomes the ledger reference, so a retried call cannot be charged twice. Max 255 characters.

Body

application/json
place_ids
string[]
required

Max 25 per request.

max_reviews_per_place
number
default:20

1-100, and it MULTIPLIES: 25 places x 100 reviews is 2,500 billed rows from one call.

sort
enum<string>
default:newest
Available options:
newest,
most_relevant,
highest_rating,
lowest_rating

Response

OK.

data
object[]
credits_used
number

3x what the provider run actually cost, empty results included. A failed run is never billed.

credits_remaining
number
provider
enum<string>

Which vendor answered. Named because this primitive has two, and provenance is the subject.

Available options:
apify_google_maps,
dataforseo
mock
boolean

Present and true only when the response came from fixtures.