POST/v1/tasks

Add Task Params

Add structured search tasks using city, category, and location parameters

Use this format to dynamically define search inputs using structured metadata like city, category, and country. Location values can be obtained from the Get Geolocation endpoint. This method is ideal for automation and scaling across regions.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes
Content-Typeapplication/jsonYes

Task Parameters

city
Type:
string
Required:
Yes
Description:
City name with postal code (e.g., `Alpine 91901`)
category
Type:
string
Required:
Yes
Description:
Business category to search (e.g., `restaurant`)
country
Type:
string
Required:
No
Description:
Country name (e.g., `United States`)
region
Type:
string
Required:
No
Description:
State or province (e.g., `California`)
district
Type:
string
Required:
No
Description:
County or local district (e.g., `San Diego`)

Request Body

squid
Type:
string
Required:
Yes
Description:
Hash of your squid configured with the google-maps-leads-scraper crawler
tasks
Type:
array
Required:
Yes
Description:
Array of task objects with location parameters
Pro Tip

Pro Tip

Use the Get Geolocation endpoint to fetch valid values for city, region, and district.
Note

Note

The `city` field must include the postal code (e.g., `Anaheim 92801`).