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

<Note>Crawler ID: `e625ce52e98a6d4d1b53ef36dff7dacb`</Note>

## 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
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
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
{
  "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"
    }
  ]
}
```
