> ## 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 Sales Navigator company search URLs to scrape using the lobstr.io API

Add Sales Navigator company search URLs as tasks to your squid. The scraper will export all companies matching your search filters.

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

## URL Format

The scraper accepts three types of Sales Navigator company URLs:

* **Search URL** — a filtered company search: `https://www.linkedin.com/sales/search/company?query=(keywords:technology)`
* **Custom list URL** — a saved company list: `https://www.linkedin.com/sales/lists/company/YOUR_LIST_ID`
* **All Saved Accounts dashboard** — your full saved accounts list: `https://www.linkedin.com/sales/accounts/dashboard`

Build your search or open a saved list in Sales Navigator, then copy the URL from your browser.

## Request Body

| Field   | Type   | Required | Description                                                                              |
| ------- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| **url** | string | Yes      | Sales Navigator company search URL, custom list URL, or All Saved Accounts dashboard URL |

<Tip>
  Build your search in Sales Navigator first, apply all filters, then copy the URL to ensure accurate results.
</Tip>

<Warning>
  This scraper requires a linked Sales Navigator account. Connect your account in lobstr.io settings first.
</Warning>

<Note>
  Each search URL can return up to 2,500 companies (100 pages × 25 results per page).
</Note>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.lobstr.io/api/v2/squid/YOUR_SQUID_ID/task" \
    -H "Authorization: Token YOUR_API_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "url": "https://www.linkedin.com/sales/search/company?query=(keywords:technology)"
    }'
  ```

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

  API_TOKEN = "YOUR_API_TOKEN"
  SQUID_ID = "YOUR_SQUID_ID"

  url = f"https://api.lobstr.io/api/v2/squid/{SQUID_ID}/task"
  headers = {
      "Authorization": f"Token {API_TOKEN}",
      "Content-Type": "application/json"
  }
  data = {
      "url": "https://www.linkedin.com/sales/search/company?query=(keywords:technology)"
  }

  response = requests.post(url, headers=headers, json=data)
  print(response.json())
  ```
</CodeGroup>

## Response

```json 200 theme={null}
{
  "id": "task_abc123def456",
  "status": "pending",
  "created_at": "2025-01-15T10:30:00Z",
  "url": "https://www.linkedin.com/sales/search/company?query=(keywords:technology)"
}
```