Examples
Add Task URLs
Add Google Maps search URLs to scrape places from
The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
POST
https://api.lobstr.io/v1/tasksUse this format if you already have a direct Google Maps search or place URL. This is best for manual inputs or small-scale targeted searches.
Crawler ID:
4734d096159ef05210e0e1677e8be823Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Content-TypestringheaderrequiredRequest body format. Value: application/json
URL Format
Google Maps search URL:
https://www.google.com/maps/search/restaurant/@43.3928346,5.2662584,14z
The URL contains the search query and coordinates for the search area.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| squid | string | Yes | Hash of your squid configured with the google-maps-leads-scraper crawler |
| tasks | array | Yes | Array of task objects, each containing a url field |
Only the url key is required in each task object.
URLs must match Google Maps search or place format.
Code Examples
curl -X POST "https://api.lobstr.io/v1/tasks" \ -H "Authorization: Token YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "tasks": [ { "url": "https://www.google.com/maps/search/restaurant/@43.3928346,5.2662584,14z" } ], "squid": "YOUR_SQUID_HASH" }'
Response
200
{ "duplicated_count": 0, "tasks": [ { "id": "4ed8a673a01ba193cc43476e60abc5c0", "created_at": "2025-06-24T11:13:05.720012", "is_active": true, "params": { "url": "https://www.google.com/maps/search/restaurant/@43.3928346,5.2662584,14z" }, "module": 5, "object": "task" } ] }