Skip to content
Examples

Add Tasks

Add Google Maps place URLs to scrape reviews 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

Add Google Maps place URLs as tasks to your squid. The scraper will extract reviews from each place you provide.

You can use either the short CID format or the full Google Maps URL.

Crawler ID: e625ce52e98a6d4d1b53ef36dff7dacb

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Content-Typestringheaderrequired

Request body format. Value: application/json

Supported URL Formats

Short CID format: https://maps.google.com/?cid=1357935577401699828

Full Google Maps URL: https://www.google.com/maps/place/Restaurant+Name/@48.8499542,2.3524796,17z/...

Both formats work - use whichever is easier for your workflow.

Request Body

Field Type Required Description
squid string Yes Hash of your squid configured with the google-maps-reviews-scraper crawler
tasks array Yes Array of task objects, each containing a url field

You can add up to 1000 tasks in a single request for bulk operations.

The CID (Customer ID) can be found in the Google Maps URL after cid= or extracted from the place's share link.

Duplicate URLs are automatically detected and won't be added twice.

Code Examples

curl -X POST "https://api.lobstr.io/v1/tasks" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "squid": "b6ab0f03b02e472a8e2ab0b16b4fdd0f",
    "tasks": [
      {"url": "https://maps.google.com/?cid=1357935577401699828"},
      {"url": "https://www.google.com/maps/place/La+Tour+d'\''Argent/@48.8499542,2.3524796,17z"}
    ]
  }'

Response

200
{
  "duplicated_count": 0,
  "tasks": [
    {
      "id": "8c15009a391a79151873fe9451285e90",
      "created_at": "2025-03-17T11:56:51.691986",
      "is_active": true,
      "params": {
        "url": "https://maps.google.com/?cid=1357935577401699828"
      },
      "object": "task"
    },
    {
      "id": "a6ed45088d82beef3d254679457b5eb6",
      "created_at": "2025-03-17T11:56:51.692109",
      "is_active": true,
      "params": {
        "url": "https://www.google.com/maps/place/La+Tour+d'Argent/@48.8499542,2.3524796,17z"
      },
      "object": "task"
    }
  ]
}