Google Maps Place search
Search Google Maps for places matching a query or location
Endpoint
One endpoint for every offer below. Omit provider and the router picks with automatic failover — the response's served_by tells you which one ran.
https://api.socialrouter.io/v1/extract/googlemaps/place.searchOffers
Every offer below returns the same normalized output, in failover order — the first one serves unless you pin another with the provider field.
apify/compassvia Apifydefault routeUp to 100 queries per request
$0.0055per record
Parameters
JSON body of the request. Unknown fields and unknown options are rejected with the valid list, so a wrong guess costs nothing.
| Parameter | Type | Description |
|---|---|---|
queriesRequired | string[] | Search queries to process. Accepted shape:Free-text search query, as you would type it in Google MapsExample: best pizza in Brooklyn, NYA single query string is accepted too. |
providerOptional | string | Pin one offer, e.g. apify/compass. Omit it and the router picks with failover. |
limitOptional | integer | Max records to return per query. |
optionsOptional | object | Service-specific options, listed below. |
options.languageOptional | ISO 639-1 | Language for the search query and the returned place data, as a two-letter code, e.g. "fr", "de", "es". Google Maps localizes both the ranking and the text fields (category, address, opening-hours labels) to it. Defaults to "en". Defaults to en. |
options.countryCodeOptional | ISO 3166-1 alpha-2 (lowercase) | Restrict the search to one country, as a lowercase two-letter code, e.g. "us", "fr", "gb". The coarse geographic scope — combine with city/state for a tighter area. |
options.cityOptional | string | City to focus the search on, as free text, e.g. "Brooklyn". Best combined with countryCode. |
options.stateOptional | string | State / region to focus the search on, as free text, e.g. "New York". |
options.countyOptional | string | County to focus the search on, as free text, e.g. "Kings County". |
options.postalCodeOptional | string | Postal / ZIP code to focus the search on, e.g. "11201". The actor only honours it together with countryCode and city, and only for a single search term. |
Output
Each record has the fields below, whichever offer serves the request. Offers may include additional platform-specific fields on top.
namestringPlace name
addressstringStreet address
ratingnumberAverage rating (1-5)
reviews_countnumberTotal number of reviews
category_namestringPrimary category
place_urlurlCanonical Google Maps URL for the place
sourcestringPlatform the record was extracted from (e.g. "linkedin")
extracted_atiso8601UTC timestamp when the record was produced
Going further
Auth, error semantics, and every other endpoint live in the API reference — including the machine-readable OpenAPI spec at /v1/openapi.json.
Frequently asked questions
How much does Google Maps place search cost?
Prices start at $0.0055 per record, depending on the offer that serves the request. You are only charged for records actually returned.
Which offers serve googlemaps/place.search?
apify/compass — 1 offer is available behind the same endpoint. Pin one with the optional "provider" field, or omit it and the router picks with automatic failover. The response's "served_by" field names the offer that ran.
What input does it need?
The "queries" field of the JSON body, as an array of strings: Free-text search query, as you would type it in Google Maps. For example: best pizza in Brooklyn, NY
Is the output format the same for every offer?
Yes. Every offer returns the normalized record schema documented on this page; some add extra platform-specific fields on top, but the documented fields are always present.
How many queries can I send per request?
Up to 100 queries in a single request, depending on the offer.
What happens if an offer fails?
SocialRouter automatically fails over to the next offer serving the same service, so a single upstream outage doesn't break your integration.
What options does it take?
language (string): Language for the search query and the returned place data, as a two-letter code, e.g. "fr", "de", "es". Google Maps localizes both the ranking and the text fields (category, address, opening-hours labels) to it. Defaults to "en". countryCode (string): Restrict the search to one country, as a lowercase two-letter code, e.g. "us", "fr", "gb". The coarse geographic scope — combine with city/state for a tighter area. city (string): City to focus the search on, as free text, e.g. "Brooklyn". Best combined with countryCode. state (string): State / region to focus the search on, as free text, e.g. "New York". county (string): County to focus the search on, as free text, e.g. "Kings County". postalCode (string): Postal / ZIP code to focus the search on, e.g. "11201". The actor only honours it together with countryCode and city, and only for a single search term.