# LinkedIn Lead Search (`linkedin.search_leads`)

Sales-prospecting people search with advanced inclusion and exclusion filters.

Docs: https://primaryapi.com/docs/api-reference/linkedin/search_leads

> **Planned.** This API is on the roadmap and cannot be called yet: `POST /v1/run/linkedin.search_leads` answers `404 not_found`. Ask for it with `POST https://api.primaryapi.com/v1/api-requests` or the MCP tool `send_feedback`.

- Endpoint: `POST https://api.primaryapi.com/v1/run/linkedin.search_leads`
- Category: Social · Platform: `linkedin` · Kind: search · Status: planned
- Price: Not priced yet: this API is planned and cannot be called.
- Billing unit: per successful call
- Reliability: routed to a healthy upstream and retried automatically when an attempt fails; live 30-day status: `GET https://api.primaryapi.com/v1/status/apis?sku=linkedin.search_leads`
- Execution: synchronous (answers 202 only if it outlives the wait window)
- Restricted: yes. Requires an approved account that accepted the permissible-purpose terms (`403 restricted_api` otherwise)

## Input

This API takes no input fields: send `{}`.

Unknown fields are rejected with `400 invalid_input`. The routing controls `preferLatencyUnderMs` and `maxCredits` may be sent in the same JSON body.

## Output

When `output.found` is `true`, `output.data` has this shape:

`output.data` is free-form JSON.

When the thing you asked about does not exist (or a search matches nothing) the call still succeeds: `output.found` is `false`, `output.data` is `null` and `output.reason` says why (`not_found`, `private`, `no_results`, …). Misses are free unless the notes below say misses are billed.

## Example request

_Input values are placeholders built from the schema._

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/linkedin.search_leads" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Errors to handle

`invalid_input`, `unauthorized`, `insufficient_balance`, `key_limit_reached`, `trial_cap_reached`, `forbidden`, `not_found`, `idempotency_conflict`, `rate_limited`, `all_sources_failed`, `service_unavailable`, `timeout`, `restricted_api`. See https://primaryapi.com/docs/errors.

## Legal

Restricted: needs an approved account and an accepted permissible purpose. Public LinkedIn data only. LinkedIn’s User Agreement restricts automated collection and LinkedIn enforces it; use the data for lawful purposes, keep copies only as long as you need them, and treat post and article text as the author’s content (analysis, not republication). Results contain personal data about identifiable people (GDPR, UK GDPR, CCPA): have a lawful basis, honour deletion requests, and never use it for spam or unsolicited bulk outreach.

