Skip to main content
POST
Search people

Authorizations

Authorization
string
header
required

Your API key, sent as is (no Bearer prefix). Create it in the Leadsforge app under Settings -> API & MCP.

Query Parameters

cursor
string

Cursor from the previous page

Body

application/json

Search request

Search request

limit
integer
required
Required range: 1 <= x <= 2000
companyBusinessModels
object
companyDomains
object
companyEmployeeNumberRange
object
companyFoundedYearRange
object
companyFundingRounds
object
companyIDs
object
companyIndustries
object
companyKeywords
object
companyLocations
object
companyNames
object
companyNiches
object
companyRequired
boolean

CompanyRequired true returns only people with a known company.

companyRevenueRanges
enum<string>[]
Available options:
very_small,
small_lower,
small_upper,
lower_mid_sized,
mid_sized_lower,
mid_sized_upper,
large_lower,
large_upper,
enterprise_lower,
enterprise_upper,
global_giants_lower,
global_giants_upper,
super_enterprises
companyTechnologies
object
companyTypes
object
companyYearsInBusinessRange
object
leadDepartments
object
leadIDs
object
leadJobTitles
object
leadLanguages
object
leadLocations
object
leadSeniorities
object
leadTenure
object
maxContactsPerCompany
integer

MaxContactsPerCompany caps the people returned per company, up to 100; 0 or absent means no cap.

Required range: 0 <= x <= 100

Response

Search response

cursor
string
leads
object[]
warnings
object[]