GET/v1/leadsscope: leads:read

Search leads

The flagship endpoint. Filter people records by country, industry, company size, seniority, and more.

All filter params accept a single value or a comma-separated list. Results are paginated and include only records that pass our global suppression list (GDPR / CCPA opt-outs).

Masked fields (e.g., email) come back as null until you unlock the lead via POST /v1/leads/unlock — unlocks are permanent and don't count against search quota.

Parameters

Name	Type	Required	Description
type	string	optional	"business" or "consumer" e.g. `business`
country	string \| list	optional	ISO-2 country codes e.g. `US,GB,DE`
industry	string \| list	optional	Industry label from our taxonomy e.g. `Software`
sector	string \| list	optional	Higher-level sector e.g. `Technology`
company_size	string \| list	optional	Size buckets e.g. `11-50,51-200`
department	string \| list	optional	Department of the contact
job_level	string \| list	optional	Seniority e.g. `director,vp,c_level`
state	string \| list	optional	US state abbreviation (US contacts only)
year_founded_min	integer	optional	Earliest founding year
year_founded_max	integer	optional	Latest founding year
employee_count_min	integer	optional	Minimum headcount
employee_count_max	integer	optional	Maximum headcount
niches	string \| list	optional	Fine-grained consumer interest tags (consumer type only)
page	integer	optional	Page number, default 1
per_page	integer	optional	Results per page, max 100. Default 25.

Example request

curl -H "Authorization: Bearer $LEADLEAP_KEY" \
  "https://api.leadleap.net/v1/leads?country=US&industry=Software&job_level=director,vp&per_page=5"

Example response

{
  "data": [
    {
      "id": "lead_01HRF...",
      "first_name": "Jamie",
      "last_name": "Okonkwo",
      "title": "VP Engineering",
      "company_name": "Northbeam",
      "company_domain": "northbeam.io",
      "country": "US",
      "state": "CA",
      "industry": "Software",
      "seniority": "vp",
      "email": null,
      "linkedin_url": "https://linkedin.com/in/jokonkwo"
    }
  ],
  "meta": {
    "request_id": "req_a1b2c3...",
    "timestamp": "2026-04-24T15:32:00.000Z",
    "total": 14283,
    "page": 1,
    "per_page": 5,
    "total_pages": 2857
  }
}

Pro tip: filter as narrowly as possible on first pass. A 14K-result search with per_page=100 takes 142 calls; adding state=CA typically drops that to < 10.