Google Maps Search
2 creditsSearch for places on Google Maps.
/api/v1/tools/google/maps/searchParameters
Search query (e.g. "pizza near me", "hotels in Paris").
BCP-47 language code for localized results (e.g. "en", "ja", "fr"). Defaults to "en".
ISO 3166-1 alpha-2 region code (e.g. "us", "jp", "fr"). Defaults to "us".
Location context string.
Center latitude (-90 to 90).
Center longitude (-180 to 180).
Map zoom level (1-21). Defaults to 14.
Search radius in km. Defaults to 50.
Maximum results. Must be from 1 through 500. Defaults to 100.
Only return places that are currently open.
Only return places that are open 24 hours.
Only return places open at a specific day/time. Properties: day (1=Mon to 7=Sun), hour (0-23).
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.
Only return places matching these price levels. Values: "1" ($), "2" ($$), "3" ($$$), "4" ($$$$).
Google category ID to filter by (e.g. "sushi_restaurant", "italian_restaurant", "ramen_restaurant"). Available categories depend on query/location.
Sort order for results. One of "relevance" (default), "distance", "price", "rating".
Hotel star ratings to include (2-5). Example: [4, 5] for 4-star and 5-star hotels.
Hotel price range filter. Properties: min (number), max (number), currency (3-letter code, e.g. "USD", "JPY").
Fields per place. Omit for defaults: placeId, title, categories, rating, reviewCount, formattedAddress, latitude, longitude, phone, website, businessStatus, priceRange. Use ["*"] for all.
Response Schema
Google Maps search result
Array of place objects. Fields depend on the fields parameter. Default fields: placeId, title, categories, rating, reviewCount, formattedAddress, latitude, longitude, phone, website, businessStatus, priceRange.
Number of results returned
Request metadata
Tool name (google-maps-search)
Credits consumed (2)
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"}}