> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/search/sales-nav-search.md).

# Sales Nav Search

Input a Sales Navigator lead search URL and process the contacts into a list.

<mark style="color:green;">`POST`</mark> `/sales_nav_search_list`

{% hint style="info" %}
Sales Nav Search costs **10 credits** per page of 25 profiles returned. This is an async job, track it with Check List Status and pull results with Download List Data.
{% endhint %}

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name                          | Type    | Description                                                   |
| ----------------------------- | ------- | ------------------------------------------------------------- |
| `api_key`                     | string  | Your API Key.                                                 |
| `sales_nav_people_search_url` | string  | A Sales Navigator people-search URL.                          |
| `listname`                    | string  | The list to create or update with the results.                |
| `no_of_page`                  | integer | Optional. Pages to process (25 profiles each). Defaults to 0. |

**Response**

This endpoint starts a background job and answers with an acknowledgement, not the profiles. See [Response Format](/getting-started/response-format.md) for the fields every endpoint returns.

| Field       | Description                                                                        |
| ----------- | ---------------------------------------------------------------------------------- |
| `status`    | Job state: `queued`, `processing`, `done`, `not_found`, `cancelled` or `error`.    |
| `job_id`    | The job handle, as a string.                                                       |
| `list_name` | The list the results are being written to.                                         |
| `message`   | A short note about the job.                                                        |
| `view`      | Which part of the list the job covers. `all` unless you asked for a narrower view. |
| `truncated` | `true` when the job was cut down to fit a limit.                                   |

Poll `/check_list_status` until the list reports `done`, then download the rows.

**Example**

{% tabs %}
{% tab title="Input" %}

```json
{
  "api_key": "your_api_key",
  "sales_nav_people_search_url": "https://www.linkedin.com/sales/search/people?query=...",
  "no_of_page": 1,
  "listname": "Software Development in Chicago"
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "queued",
  "job_id": "918274",
  "list_name": "Software Development in Chicago",
  "message": "Job created.",
  "view": "all",
  "truncated": false,
  "credits_used": 0,
  "credits_remaining": 4823,
  "success": true
}
```

{% endtab %}

{% tab title="Error" %}

```json
{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "sales_nav_people_search_url: Field required; listname: Field required"
  },
  "success": false
}
```

{% endtab %}
{% endtabs %}

**Retrieving results**

* Check List Status
* Download List Data