API reference / People reads

Search leads (live)

Written and maintained by The ProspectAPIs team

POST/v1/leads/search

POST /v1/leads/search is the ProspectAPIs operation searchLeads, in the People reads group of the REST API. Search people as sales leads by keywords and lead filters, read fresh. Each lead carries name, location, summary, person_ref, network_distance, open_profile, premium, current_role (title, company, company_id, started, months_in_role, months_at_company) and signals (changed_jobs_recently, posted_recently; null when unknown). Returns the first 2,500 results per query; page with start; a start at or past 2,500 is 400 result_window_exceeded. $0.0035 per result returned; an empty search is free. Not available yet: the call answers 503 temporarily_unavailable and nothing is charged until GET /pricing reports lead_search.available. Cost: Not available yet. Send your API key as a Bearer token in the Authorization header.

The quickstart shows this call in context, next to the first requests most integrations make.

Parameters

Request body

JSON. Give keywords or at least one filter.

{}

Responses

Every error answers with the same JSON body, an error string and sometimes a code; the errors page lists each status and when it happens. A per-key 429 carries Retry-After; see rate limits.

200 response fields

The matching leads and the page envelope, read fresh. The body is a PeopleReadResult.

Code samples

Each sample sends the same request. Set PROSPECTAPIS_KEY in your environment first. Values come from the spec's examples; replace them with your own.

curl -X POST https://api.prospectapis.com/v1/leads/search \
  -H "Authorization: Bearer $PROSPECTAPIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

const res = await fetch("https://api.prospectapis.com/v1/leads/search", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PROSPECTAPIS_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});
if (!res.ok) throw new Error(`${res.status}: ${(await res.json().catch(() => ({}))).error ?? res.statusText}`);
const data = await res.json();
console.log(data);

import os, requests

res = requests.post(
    "https://api.prospectapis.com/v1/leads/search",
    headers={"Authorization": f"Bearer {os.environ['PROSPECTAPIS_KEY']}"},
    json={},
    timeout=30,
)
res.raise_for_status()
data = res.json()
print(data)

Billing

Billing reserves before it serves: the call holds what it may cost, serves at most what that hold covers, and refunds the rest when the response closes. Any non-2xx answer refunds the whole hold, so a failed call costs nothing. The response reports your balance in X-Credits-Remaining.

Related

Previous operation: List a page's employees (live). Next operation: Search lead companies (live). Every operation, grouped by area, is on the API reference index.

Create a free account to get a key, then run the samples above with your own values (this call acts for real, so use real inputs).