Skip to content
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.
POSThttps://api.lobstr.io/v1/tasks

Use 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: 4734d096159ef05210e0e1677e8be823

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Content-Typestringheaderrequired

Request 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"
    }
  ]
}