Search businesses
Returns up to 20 complete business records near a point: name, address, phone, website, hours, rating, attributes and photos in one call — 26 requests covers 500 businesses, not 526. Requires query, latitude and longitude. A parameter that can't be applied fails terminal, not retryable.
Authorization
ApiKeyAuth In: header
Query Parameters
Business type, product, service, or name to search for. interpreted_query reports how Google understood the text. Results are scoped to this query and the requested viewport.
length <= 200Latitude of the search viewport center. Use with longitude and span_metres to define the area to search.
-90 <= value <= 90Longitude of the search viewport center. Use with latitude and span_metres to define the area to search.
-180 <= value <= 180Width of the search viewport in metres. To cover a large area beyond one viewport's result limit, search several smaller adjacent viewports and deduplicate businesses by cid.
100 <= value <= 500000020000Page of 20 complete business records. Pages can overlap, so deduplicate by cid; use has_more to decide whether to request the next page.
1 <= value <= 101curl -X GET "https://example.com/v1/google-maps/search?query=coffee&latitude=37.7749&longitude=-122.4194" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "query": "coffee", "latitude": 37.7749, "longitude": -122.4194, "span_metres": 20000, "page": 1, "page_size": 20, "max_pages": 10, "has_more": true, "count": 20, "results": [ { "cid": "0x808587fb77f5f64d:0x25d564f177f99946", "name": "The Coffee Movement", "place_id": "ChIJ_2f19_uHhYARRpn5d_Fk1SU", "feature_id": "/g/11h547vvy9", "address": "1030 Washington St, San Francisco, CA 94108", "address_lines": [ "599 3rd St #100", "San Francisco, CA 94107" ], "address_components": [ null ], "neighborhood": "Chinatown", "city": "San Francisco, CA", "country_code": "US", "latitude": 37.7936, "longitude": -122.4116, "timezone": "America/Los_Angeles", "categories": [ "Coffee shop", "Cafe" ], "rating": 4.8, "phone": "(415) 780-1902", "phone_e164": "+14157801902", "website": "https://www.thecoffeemovement.com/", "website_domain": "thecoffeemovement.com", "description": "Cozy cafe serving single-origin espresso and pastries.", "hours": { "days": [ { "day": "Saturday", "hours": [ "9 AM–2 PM" ], "date": [ 2026, 8, 15 ] } ], "status": "Closed · Opens 8 AM Mon" }, "attributes": { "Accessibility": [ "Wheelchair accessible entrance", "Wheelchair accessible restroom" ], "Amenities": [ "Restroom", "Wi-Fi" ] }, "photos": [ "https://lh3.googleusercontent.com/p/AF1QipN-example=w408-h306-k-no" ], "maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJ_2f19_uHhYAR" } ], "interpreted_query": "coffee in San Francisco", "viewport": { "property1": null, "property2": null }, "usage_note": "Every result is a COMPLETE business record — phone, hours, website and coordinates included — not a stub needing a follow-up call. Each result's `cid` is the exact value /v1/google-maps/place takes. Two things to know when paging: the pages OVERLAP (200 rows across 10 pages held 182 distinct businesses, so deduplicate on `cid`), and the ceiling is per query AND viewport — to cover an area beyond ~182 places, tile it with several smaller `span_metres` rather than asking once with a large one." }}