> ## 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 Vinted catalog search URLs to scrape product listings

Add Vinted catalog search URLs to scrape product listings from the marketplace. The scraper extracts product details, pricing, and seller information.

Use Vinted's catalog URL with search filters applied. You can filter by category, brand, size, price range, and sort order directly in the 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>

## Request Body

| Field     | Type   | Required | Description                                                            |
| --------- | ------ | -------- | ---------------------------------------------------------------------- |
| **squid** | string | Yes      | Hash of your squid configured with the Vinted Products Scraper crawler |
| **tasks** | array  | Yes      | Array of task objects, each containing a `url` field                   |

## Task Object

| Field   | Type   | Required | Description                                                                                    |
| ------- | ------ | -------- | ---------------------------------------------------------------------------------------------- |
| **url** | string | Yes      | Vinted catalog URL (e.g., `https://www.vinted.fr/catalog?search_text=nike&order=newest_first`) |

<Tip>
  Apply filters on Vinted first, then copy the URL. All filter parameters will be preserved in the URL.
</Tip>

<Note>
  Vinted operates country-specific sites (vinted.fr, vinted.de, vinted.es, etc.). Use the appropriate domain for your target market.
</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": "YOUR_SQUID_HASH",
      "tasks": [
        {
          "url": "https://www.vinted.fr/catalog?search_text=nike&order=newest_first"
        }
      ]
    }'
  ```

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

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

  squid_id = "YOUR_SQUID_HASH"

  # Add Vinted catalog search URLs
  payload = {
      "squid": squid_id,
      "tasks": [
          {"url": "https://www.vinted.fr/catalog?search_text=nike&order=newest_first"}
      ]
  }

  response = requests.post(f"{BASE_URL}/tasks",
      headers=headers,
      json=payload
  )

  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": "82367f24d9450b2222080eed91662968",
      "created_at": "2025-07-17T09:06:47.287893",
      "is_active": true,
      "params": {
        "url": "https://www.vinted.fr/catalog?search_text=nike&order=newest_first"
      },
      "module": 115,
      "object": "task"
    }
  ]
}
```