AgentSky
Log in

Google Maps results

by DataForSEO

dataforseo/serp_google_maps_live
Get an API key All Tools

Return local business listings for a query in a specific place.

Billed per
call
Price
Price: $0.0024
Provider
DataForSEO
Timeout
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.

FieldTypeRequiredDescription
keywordstringYesThe search query to run, up to 700 characters.
location_codeintegerYesWhich market to search from.
language_codestringYesInterface and result language.
depthintegerNoHow many results to parse.
Default: 100
Maximum: 700
location_coordinatestringNoSearch from an exact point, as `latitude,longitude,zoom`.
search_this_areabooleanNoConfine results to the displayed map area.
Default: true

Requests up to 1 MB.

Example

Use your own API key and a saved idempotency key for each new job. Replace image or media placeholders with your own publicly reachable HTTPS URLs. Keep the same key and request body when recovering a timeout.

# Set once per job; reuse this key and the identical body after a timeout.
: "${AGENTSKY_IDEMPOTENCY_KEY:?Set a unique, saved key for this job}"
curl --fail-with-body https://gateway.agentsky.dev/v1/run \
  -H "authorization: Bearer $AGENTSKY_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $AGENTSKY_IDEMPOTENCY_KEY" \
  -d '{"provider":"dataforseo","endpoint":"serp_google_maps_live","input":{"keyword":"coffee shop","location_code":2840,"language_code":"en","depth":20}}'
# If status is READY/RUNNING, poll GET /v1/runs/{runId} with the same API key.

Pricing

$0.0024 per call using your plan when signed in. Reported usage is billed under your account plan. Read the final customer charge from price.amount.value after the run finishes. A RUNNING response is not the final bill.

Questions