Skip to main content
POST
Search local businesses on Google Maps

Authorizations

Authorization
string
header
required

Your API key, sent as is (no Bearer prefix). Create it in the Leadsforge app under Settings -> API & MCP.

Headers

Idempotency-Key
string

Idempotency key - if a job with this key already exists in your account, the existing job is returned as is; use a new key to start a new job

Body

application/json

Search request

Search request

limit
integer
required
Required range: 1 <= x <= 5000
Example:

200

radiusKm
number
required

RadiusKm is the search radius in kilometres, greater than 0 and at most 500.

Required range: x <= 500
Example:

5

categories
string[]

Categories restrict results to Google Maps categories (GET /maps-discovery/filters/categories). Without keywords, a value that is not a Google category is searched as a keyword; with keywords it is rejected with 400.

Maximum array length: 100
Example:
clientRequestID
string
Maximum string length: 128
Example:

"req_12345"

keywords
string[]

Keywords are free-text Google Maps searches; every place Google returns for them is kept. At least one keyword or category is required.

Maximum array length: 100
Example:
language
string
Maximum string length: 10
Example:

"en"

lat
number

Lat is the latitude of the search center. Send it explicitly: an omitted value is read as 0.

Required range: -90 <= x <= 90
Example:

40.758

lng
number

Lng is the longitude of the search center. Send it explicitly: an omitted value is read as 0.

Required range: -180 <= x <= 180
Example:

-73.9855

webhookURL
string
Example:

"https://example.com/webhooks/maps-search"

Response

Job created

categories
string[]
Example:
clientRequestID
string
Example:

"req_12345"

completedAt
string
consumedCredits
number
createdAt
string
Example:

"2026-09-13T12:00:00Z"

error
string

Error is set on failed and no_results jobs.

foundCount
integer
Example:

143

jobID
string
Example:

"5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60"

keywords
string[]
Example:
language
string
Example:

"en"

lat
number
Example:

40.758

limit
integer
Example:

200

lng
number
Example:

-73.9855

radiusKm
number
Example:

5

reservedCredits
number
resultsURL
string
Example:

"/public/v1/maps-discovery/jobs/5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60/results"

status
enum<string>
Available options:
in_progress,
completed,
failed,
no_results
Example:

"in_progress"

statusURL
string
Example:

"/public/v1/maps-discovery/jobs/5f1c2e3a-0b1d-4c2e-9f3a-1b2c3d4e5f60"

updatedAt
string
Example:

"2026-09-13T12:01:00Z"

webhookURL
string
Example:

"https://example.com/webhooks/maps-search"