scraper
Back to API docs

Overview

  • Overview

SERP

  • POSTSERP

Core

  • POSTGeocode
  • POSTTranslate
  • POSTSearch
  • POSTVision
  • POSTPlaces Search
  • POSTPlace Details
  • POSTPlaces Nearby
  • POSTAutocomplete

Maps

  • POSTSearch
  • POSTPlace Details
  • POSTReviews

Hotels

  • POSTSearch
  • POSTDetail
  • POSTReviews
  • POSTPhotos

Flights

  • POSTOne-way Search
  • POSTCalendar
  • POSTExplore

Finance

  • POSTQuote
  • POSTFundamentals
  • POSTChart
  • POSTNews
  • POSTSearch
  • POSTEstimates
  • POSTEarnings

Google Maps Search

2 credits

Search for places on Google Maps.

POST/api/v1/tools/google/maps/search

Parameters

querystringrequired

Search query (e.g. "pizza near me", "hotels in Paris").

languagestring

BCP-47 language code for localized results (e.g. "en", "ja", "fr"). Defaults to "en".

regionstring

ISO 3166-1 alpha-2 region code (e.g. "us", "jp", "fr"). Defaults to "us".

locationstring

Location context string.

latitudenumber

Center latitude (-90 to 90).

longitudenumber

Center longitude (-180 to 180).

zoomnumber

Map zoom level (1-21). Defaults to 14.

radiusKmnumber

Search radius in km. Defaults to 50.

maxResultsnumber

Maximum results. Must be from 1 through 500. Defaults to 100.

openNowboolean

Only return places that are currently open.

open24Hoursboolean

Only return places that are open 24 hours.

openAtobject

Only return places open at a specific day/time. Properties: day (1=Mon to 7=Sun), hour (0-23).

minRatingnumber

Only return places with at least this average rating. Must be from 2 through 4.5. The scraper rounds the filter to the nearest 0.5.

priceLevelsstring[]

Only return places matching these price levels. Values: "1" ($), "2" ($$), "3" ($$$), "4" ($$$$).

categorystring

Google category ID to filter by (e.g. "sushi_restaurant", "italian_restaurant", "ramen_restaurant"). Available categories depend on query/location.

sortBystring

Sort order for results. One of "relevance" (default), "distance", "price", "rating".

hotelClassnumber[]

Hotel star ratings to include (2-5). Example: [4, 5] for 4-star and 5-star hotels.

hotelPriceobject

Hotel price range filter. Properties: min (number), max (number), currency (3-letter code, e.g. "USD", "JPY").

fieldsstring[]

Fields per place. Omit for defaults: placeId, title, categories, rating, reviewCount, formattedAddress, latitude, longitude, phone, website, businessStatus, priceRange. Use ["*"] for all.

Response Schema

dataobject

Google Maps search result

resultsobject[]

Array of place objects. Fields depend on the fields parameter. Default fields: placeId, title, categories, rating, reviewCount, formattedAddress, latitude, longitude, phone, website, businessStatus, priceRange.

countnumber

Number of results returned

metaobject

Request metadata

toolstring

Tool name (google-maps-search)

creditsUsednumber

Credits consumed (2)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/maps/search \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"query": "best pizza",
"location": "New York, NY",
"maxResults": 10
}'

Response Example

{
"data": {
"results": [
{
"placeId": "ChIJWbGLc9JYwokRaGMkH7wlF3g",
"title": "Joe's Pizza",
"categories": [
"Pizza restaurant"
],
"rating": 4.5,
"reviewCount": 12450,
"formattedAddress": "7 Carmine St, New York, NY 10014",
"latitude": 40.7306,
"longitude": -74.0021,
"phone": "+1 212-366-1182",
"website": "https://www.joespizzanyc.com",
"businessStatus": "OPERATIONAL",
"priceRange": "$"
}
],
"count": 1
},
"meta": {
"tool": "google-maps-search",
"creditsUsed": 2,
"requestId": "req_abc123"
}
}