Skip to main content
POST
/
v1
/
tasks
Add Tasks
curl --request POST \
  --url https://api.lobstr.io/v1/tasks \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>'
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.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY
​
Content-Type
string
required
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

FieldTypeRequiredDescription
squidstringYesHash of your squid configured with the google-maps-reviews-scraper crawler
tasksarrayYesArray 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"
    }
  ]
}