> ## 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 Pages Jaunes search URLs as tasks for scraping French business directory listings

Add Pages Jaunes (French Yellow Pages) search URLs to your squid for scraping business directory listings. The scraper extracts company information including contact details, addresses, business registration numbers (SIRET/SIREN), and social media profiles from France's largest business directory.

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

## Task Format

Each task should contain a URL from a Pages Jaunes search results page. Search for businesses by category and location on the website, then use those search URLs as tasks.

## Supported URL Formats

The scraper supports Pages Jaunes search URLs:

<Tip>
  Pages Jaunes URLs use department codes (e.g., 'paris-75' for Paris). Apply location filters on the website to get properly formatted URLs.
</Tip>

<Note>
  Search by specific business categories (boulanger, plombier, restaurant) to get targeted results for your industry research.
</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.pagesjaunes.fr/annuaire/paris-75/boulanger"
        }
      ]
    }'
  ```

  ```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 Pages Jaunes search URLs as tasks
  response = requests.post(f"{BASE_URL}/tasks",
      headers=headers,
      json={
          "squid": squid_id,
          "tasks": [
              {"url": "https://www.pagesjaunes.fr/annuaire/paris-75/boulanger"},
              {"url": "https://www.pagesjaunes.fr/annuaire/lyon-69/plombier"}
          ]
      }
  )

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

  for task in data["tasks"]:
      print(f"  Task ID: {task['id']}")
      print(f"  URL: {task['params']['url']}")
  ```
</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.pagesjaunes.fr/annuaire/paris-75/boulanger"
      },
      "module": 115,
      "object": "task"
    }
  ]
}
```
