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.
Max results. 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. Allowed values: 2.0, 2.5, 3.0, 3.5, 4.0, 4.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").
Filter for places with accessibility options.
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"}}