Google Maps
Google Maps place.search
Search Google Maps places from a free-text query. Normalized JSON, one price per record, automatic failover across sources.
POST
/
v1
/
googlemaps
/
place.search
curl -X POST https://api.socialrouter.io/v1/googlemaps/place.search \
-H "Authorization: Bearer sr_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"query": "best pizza in Brooklyn, NY",
"limit": 50
}'
const response = await fetch(
"https://api.socialrouter.io/v1/googlemaps/place.search",
{
method: "POST",
headers: {
"Authorization": "Bearer sr_live_your_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
query: "best pizza in Brooklyn, NY",
limit: 50
}),
},
);
import requests
response = requests.post(
"https://api.socialrouter.io/v1/googlemaps/place.search",
headers={"Authorization": "Bearer sr_live_your_key"},
json={
"query": "best pizza in Brooklyn, NY",
"limit": 50
},
)
const run = await sr.run("googlemaps/place.search", {
query: "best pizza in Brooklyn, NY",
limit: 50
});
{
"id": "ext_a1b2c3d4",
"status": "completed",
"platform": "googlemaps",
"service": "place.search",
"query": "best pizza in Brooklyn, NY",
"served_by": "apify/compass",
"data": [
{
"name": "Paris Baguette",
"title": "Coffee shop",
"location": "1739 NJ-27, Edison, NJ 08817",
"profile_url": "https://www.google.com/maps/search/?api=1&query=Paris%20Baguette&query_place_id=ChIJ8ecqS9_Hw4kRoD_fs8YvNa8",
"source": "googlemaps",
"extracted_at": "2026-07-16T09:26:14.546Z",
"place_id": "ChIJ8ecqS9_Hw4kRoD_fs8YvNa8",
"fid": "0x89c3c7df4b2ae7f1:0xaf352fc6b3df3fa0",
"cid": "12625049660870836128",
"kgmid": "/g/11yvrn__q",
"address": "1739 NJ-27, Edison, NJ 08817",
"street": "1739 NJ-27",
"city": "Edison",
"postal_code": "08817",
"state": "New Jersey",
"country_code": "US",
"lat": 40.5129325,
"lng": -74.4082945,
"description": "Korean-run bakery offering cakes, croissants, French pastries and coffee, along with sandwiches.",
"category_name": "Coffee shop",
"categories": [
"Coffee shop",
"... 5 more"
],
"phone": "(732) 248-0044",
"phone_unformatted": "+17322480044",
"website": "https://parisbaguette.com/locations/nj/edison/1739-new-jersey-27/",
"total_score": 4.4,
"reviews_count": 1754,
"image_url": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWmhyguDyuPEsx_NgYtdQbP6LUk_o_deuHhGzl6-uncHehew5zZD_NKxIoHtLgIKehLeUw...",
"images_count": 2672,
"opening_hours": [
{
"day": "Monday",
"hours": "6 AM to 11 PM"
},
"... 6 more"
],
"rank": 1,
"search_string": "coffee paris",
"search_page_url": "https://www.google.com/maps/search/coffee%20paris?hl=en",
"language": "en",
"scraped_at": "2026-07-16T09:26:08.732Z",
"additional_info": {
"Service options": [
"... 6 item(s)"
],
"Accessibility": [
"... 4 item(s)"
],
"Offerings": [
"... 1 item(s)"
],
"Dining options": [
"... 1 item(s)"
],
"Amenities": [
"... 3 item(s)"
],
"Planning": [
"... 1 item(s)"
],
"Payments": [
"... 4 item(s)"
],
"Parking": [
"... 4 item(s)"
]
}
}
],
"pagination": {
"total": 1,
"returned": 1
},
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:03Z"
}
Search Google Maps places from a free-text query. The response is normalized, so it keeps the same shape whichever offer served it.
The call is synchronous and comes back
Prices are live in the catalogue:
completed or failed. Body fields and error codes shared by every service are documented on Run a service.
Body
string[]
required
The search queries to run, as
queries (array) or query (single string). Free text, exactly as you would type it on Google Maps.string
Single-input form of
queries.number
default:"100"
Maximum number of records to return. Integer, 1-250.
string
Pin one offer, as
source/name. Serving this service: apify/compass. Omit it (the default) to let the router walk the failover chain.object
This service declares no options. Any key sent here returns a corrective
400.Accepted queries
Free-text search query, as you would type it in Google Maps. Example:best pizza in Brooklyn, NY.
Offers
One offer serves this endpoint today. When a second one implements it, failover turns on with no change on your side.| Offer | Inputs per call |
|---|---|
apify/compass | 100 |
GET /v1/services/googlemaps/place.search. See Credits for how a call is billed.
Response
data[] holds the normalized records, served_by names the offer that answered, and credits_used carries the actual charge.
The example response is a real run with values shortened for readability. A field is present when Google Maps exposes it for that item, so the exact set varies record to record.
curl -X POST https://api.socialrouter.io/v1/googlemaps/place.search \
-H "Authorization: Bearer sr_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"query": "best pizza in Brooklyn, NY",
"limit": 50
}'
const response = await fetch(
"https://api.socialrouter.io/v1/googlemaps/place.search",
{
method: "POST",
headers: {
"Authorization": "Bearer sr_live_your_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
query: "best pizza in Brooklyn, NY",
limit: 50
}),
},
);
import requests
response = requests.post(
"https://api.socialrouter.io/v1/googlemaps/place.search",
headers={"Authorization": "Bearer sr_live_your_key"},
json={
"query": "best pizza in Brooklyn, NY",
"limit": 50
},
)
const run = await sr.run("googlemaps/place.search", {
query: "best pizza in Brooklyn, NY",
limit: 50
});
{
"id": "ext_a1b2c3d4",
"status": "completed",
"platform": "googlemaps",
"service": "place.search",
"query": "best pizza in Brooklyn, NY",
"served_by": "apify/compass",
"data": [
{
"name": "Paris Baguette",
"title": "Coffee shop",
"location": "1739 NJ-27, Edison, NJ 08817",
"profile_url": "https://www.google.com/maps/search/?api=1&query=Paris%20Baguette&query_place_id=ChIJ8ecqS9_Hw4kRoD_fs8YvNa8",
"source": "googlemaps",
"extracted_at": "2026-07-16T09:26:14.546Z",
"place_id": "ChIJ8ecqS9_Hw4kRoD_fs8YvNa8",
"fid": "0x89c3c7df4b2ae7f1:0xaf352fc6b3df3fa0",
"cid": "12625049660870836128",
"kgmid": "/g/11yvrn__q",
"address": "1739 NJ-27, Edison, NJ 08817",
"street": "1739 NJ-27",
"city": "Edison",
"postal_code": "08817",
"state": "New Jersey",
"country_code": "US",
"lat": 40.5129325,
"lng": -74.4082945,
"description": "Korean-run bakery offering cakes, croissants, French pastries and coffee, along with sandwiches.",
"category_name": "Coffee shop",
"categories": [
"Coffee shop",
"... 5 more"
],
"phone": "(732) 248-0044",
"phone_unformatted": "+17322480044",
"website": "https://parisbaguette.com/locations/nj/edison/1739-new-jersey-27/",
"total_score": 4.4,
"reviews_count": 1754,
"image_url": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWmhyguDyuPEsx_NgYtdQbP6LUk_o_deuHhGzl6-uncHehew5zZD_NKxIoHtLgIKehLeUw...",
"images_count": 2672,
"opening_hours": [
{
"day": "Monday",
"hours": "6 AM to 11 PM"
},
"... 6 more"
],
"rank": 1,
"search_string": "coffee paris",
"search_page_url": "https://www.google.com/maps/search/coffee%20paris?hl=en",
"language": "en",
"scraped_at": "2026-07-16T09:26:08.732Z",
"additional_info": {
"Service options": [
"... 6 item(s)"
],
"Accessibility": [
"... 4 item(s)"
],
"Offerings": [
"... 1 item(s)"
],
"Dining options": [
"... 1 item(s)"
],
"Amenities": [
"... 3 item(s)"
],
"Planning": [
"... 1 item(s)"
],
"Payments": [
"... 4 item(s)"
],
"Parking": [
"... 4 item(s)"
]
}
}
],
"pagination": {
"total": 1,
"returned": 1
},
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:03Z"
}
⌘I
curl -X POST https://api.socialrouter.io/v1/googlemaps/place.search \
-H "Authorization: Bearer sr_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"query": "best pizza in Brooklyn, NY",
"limit": 50
}'
const response = await fetch(
"https://api.socialrouter.io/v1/googlemaps/place.search",
{
method: "POST",
headers: {
"Authorization": "Bearer sr_live_your_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
query: "best pizza in Brooklyn, NY",
limit: 50
}),
},
);
import requests
response = requests.post(
"https://api.socialrouter.io/v1/googlemaps/place.search",
headers={"Authorization": "Bearer sr_live_your_key"},
json={
"query": "best pizza in Brooklyn, NY",
"limit": 50
},
)
const run = await sr.run("googlemaps/place.search", {
query: "best pizza in Brooklyn, NY",
limit: 50
});
{
"id": "ext_a1b2c3d4",
"status": "completed",
"platform": "googlemaps",
"service": "place.search",
"query": "best pizza in Brooklyn, NY",
"served_by": "apify/compass",
"data": [
{
"name": "Paris Baguette",
"title": "Coffee shop",
"location": "1739 NJ-27, Edison, NJ 08817",
"profile_url": "https://www.google.com/maps/search/?api=1&query=Paris%20Baguette&query_place_id=ChIJ8ecqS9_Hw4kRoD_fs8YvNa8",
"source": "googlemaps",
"extracted_at": "2026-07-16T09:26:14.546Z",
"place_id": "ChIJ8ecqS9_Hw4kRoD_fs8YvNa8",
"fid": "0x89c3c7df4b2ae7f1:0xaf352fc6b3df3fa0",
"cid": "12625049660870836128",
"kgmid": "/g/11yvrn__q",
"address": "1739 NJ-27, Edison, NJ 08817",
"street": "1739 NJ-27",
"city": "Edison",
"postal_code": "08817",
"state": "New Jersey",
"country_code": "US",
"lat": 40.5129325,
"lng": -74.4082945,
"description": "Korean-run bakery offering cakes, croissants, French pastries and coffee, along with sandwiches.",
"category_name": "Coffee shop",
"categories": [
"Coffee shop",
"... 5 more"
],
"phone": "(732) 248-0044",
"phone_unformatted": "+17322480044",
"website": "https://parisbaguette.com/locations/nj/edison/1739-new-jersey-27/",
"total_score": 4.4,
"reviews_count": 1754,
"image_url": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWmhyguDyuPEsx_NgYtdQbP6LUk_o_deuHhGzl6-uncHehew5zZD_NKxIoHtLgIKehLeUw...",
"images_count": 2672,
"opening_hours": [
{
"day": "Monday",
"hours": "6 AM to 11 PM"
},
"... 6 more"
],
"rank": 1,
"search_string": "coffee paris",
"search_page_url": "https://www.google.com/maps/search/coffee%20paris?hl=en",
"language": "en",
"scraped_at": "2026-07-16T09:26:08.732Z",
"additional_info": {
"Service options": [
"... 6 item(s)"
],
"Accessibility": [
"... 4 item(s)"
],
"Offerings": [
"... 1 item(s)"
],
"Dining options": [
"... 1 item(s)"
],
"Amenities": [
"... 3 item(s)"
],
"Planning": [
"... 1 item(s)"
],
"Payments": [
"... 4 item(s)"
],
"Parking": [
"... 4 item(s)"
]
}
}
],
"pagination": {
"total": 1,
"returned": 1
},
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:03Z"
}