> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Tasks

> Add Google Maps place URLs to scrape reviews from

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

<ParamField header="Authorization" type="string" required>
  Your API authentication token. Value: `Token YOUR_API_KEY`
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Request body format. Value: `application/json`
</ParamField>

## 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                       |

<Tip>
  You can add up to 1000 tasks in a single request for bulk operations.
</Tip>

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

<Note>
  Duplicate URLs are automatically detected and won't be added twice.
</Note>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  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"}
      ]
    }'
  ```

  ```python Python theme={null}
  import requests

  API_KEY = "YOUR_API_KEY"
  BASE_URL = "https://api.lobstr.io/v1"
  headers = {"Authorization": f"Token {API_KEY}"}

  # Add Google Maps place URLs to scrape reviews
  response = requests.post(f"{BASE_URL}/tasks",
      headers=headers,
      json={
          "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"}
          ]
      }
  )

  data = response.json()
  print(f"Added {len(data['tasks'])} tasks")
  print(f"Duplicates skipped: {data['duplicated_count']}")
  ```
</CodeGroup>

## Response

```json 200 theme={null}
{
  "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"
    }
  ]
}
```