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

  • POSTSearch
  • 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

Max results. 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. Allowed values: 2.0, 2.5, 3.0, 3.5, 4.0, 4.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").

accessibilityboolean

Filter for places with accessibility options.

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"
}
}