AgentSky
Log inSign up
DataForSEO logo

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: —
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
keywordstringYesKeyword.
location_codeintegerNoSearch engine location code. Required if you don't specify location_name or location_coordinate.
language_codestringNoSearch engine language code. Required if you don't specify language_name.
location_namestringNoFull name of search engine location. Required if you don't specify location_code or location_coordinate.
language_namestringNoFull name of search engine language. Required if you don't specify language_code.
location_coordinatestringNoGPS coordinates of a location. Required if you don't specify location_name or location_code.
depthintegerNoHow many results to parse.
Default: 100
Maximum: 700
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":{"language_code":"en","location_code":2840,"keyword":"albert einstein"}}'
# If status is READY/RUNNING, poll GET /v1/runs/{runId} with the same API key.

Pricing

— 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