Google Maps results
dataforseo/serp_google_maps_liveReturn local business listings for a query in a specific place.
- call
- $0.004
- DataForSEO
- 3 min
Overview
Performs a live local search on the mapping surface and returns the ranked business listings it produces. Each result is a structured business record with name, category, street address, coordinates, phone number, opening hours, review count, and average rating. Location is central: you can target a named market, or drop an exact coordinate with a zoom level to search from a specific point, which is how local rankings are audited street by street. Both organic listings and promoted local ads come back, distinguished by type.
One search result set of business listings with their address, coordinates, contact details, hours, and rating.
Input
These go in the input object of the run request.
| Field | Type | Required | Description |
|---|---|---|---|
| keyword | string | Yes | The search query to run, up to 700 characters. |
| location_code | integer | Yes | Which market to search from. |
| language_code | string | Yes | Interface and result language. |
| depth | integer | No | How many results to parse. |
| location_coordinate | string | No | Search from an exact point, as `latitude,longitude,zoom`. |
| search_this_area | boolean | No | Confine results to the displayed map area. |
Requests up to 1 MB.
Example
A call that works, with your own key.
curl https://gateway.agentsky.dev/v1/run \
-H "authorization: Bearer $AGENTSKY_API_KEY" \
-H "content-type: application/json" \
-d '{"provider":"dataforseo","endpoint":"serp_google_maps_live","input":{"keyword":"coffee shop","location_code":2840,"language_code":"en","depth":20}}'Pricing
$0.004 per call on the default plan. That is the list price; when the provider reports what a call actually cost, you are billed that instead. Every run carries its price in the response.