Realtime prospecting APIs, scoped to the United Arab Emirates by default. Search leads, fetch full profiles, and combine both — all returned in the same person shape as the People search APIs.
Prospect: Realtime lead search (UAE)
Realtime lead search, returned in the same person shape as /v2/person/search. The request body carries lead-search filters (search, currentJobTitles, locations, currentCompanies, page, etc.). When no locations or geoIds filter is provided, results are scoped to the United Arab Emirates by default.
Authentication: All requests require the X-API-Key header.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.X-API-Keystring · requiredYour API key for authentication.
Request Body optional
searchstringFree-text or boolean search string. Supports boolean operators (AND, OR, NOT), quoted phrases for exact matches, and parentheses for grouping — e.g.
("software engineer" OR developer) AND (python OR golang) NOT intern.pageinteger · min: 1Page number (1-based, max 100).
Default: 1sessionIdstringOptional session id for consistent results across paginated requests.
currentJobTitlesstringCurrent job titles, comma-separated (max 70).
pastJobTitlesstringPast job titles, comma-separated (max 70).
currentCompaniesstringCurrent company URLs/IDs, comma-separated (max 50).
pastCompaniesstringPast company URLs/IDs, comma-separated (max 50).
locationsstringLocation text, comma-separated (max 70). Defaults to United Arab Emirates when omitted.
geoIdsstringLinkedIn Geo IDs, comma-separated (overrides locations).
schoolsstringSchool URLs/IDs, comma-separated (max 50).
firstNamesstringFirst name filters, comma-separated (max 70).
lastNamesstringLast name filters, comma-separated (max 70).
industryIdsstringIndustry IDs, comma-separated (max 70).
seniorityLevelIdsstringSeniority level IDs, comma-separated.
functionIdsstringJob function IDs, comma-separated.
companyHeadcountstringCompany size filter, comma-separated.
recentlyChangedJobsbooleanOnly people who changed jobs within 90 days.
postedOnLinkedinbooleanOnly people who posted on LinkedIn in the last 30 days.
salesNavUrlstringLinkedIn Sales Navigator URL (overrides other filters except page).
Responses
Lead search results returned successfully
dataobject[]Array of person records.
totalintegerTotal number of matching leads.
pageintegerCurrent page number (1-based).
sizeintegerPage size.
total_pagesintegerTotal number of pages.
enriched_countintegerNumber of records enriched with a full profile (search-profile only).
Prospect: Realtime lead search + full profile (UAE)
Realtime lead search, with each lead enriched by its full profile, returned in the same person shape as /v2/person/search. Same filter body as /v1/prospect/search; location defaults to the United Arab Emirates when omitted. Enriches up to limit leads (default 10, max 25); leads beyond the limit are returned with lead-only data.
Authentication: All requests require the X-API-Key header.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.X-API-Keystring · requiredYour API key for authentication.
Request Body optional
searchstringFree-text or boolean search string. Supports boolean operators (AND, OR, NOT), quoted phrases for exact matches, and parentheses for grouping — e.g.
("software engineer" OR developer) AND (python OR golang) NOT intern.pageinteger · min: 1Page number (1-based, max 100).
Default: 1sessionIdstringOptional session id for consistent results across paginated requests.
currentJobTitlesstringCurrent job titles, comma-separated (max 70).
pastJobTitlesstringPast job titles, comma-separated (max 70).
currentCompaniesstringCurrent company URLs/IDs, comma-separated (max 50).
pastCompaniesstringPast company URLs/IDs, comma-separated (max 50).
locationsstringLocation text, comma-separated (max 70). Defaults to United Arab Emirates when omitted.
geoIdsstringLinkedIn Geo IDs, comma-separated (overrides locations).
schoolsstringSchool URLs/IDs, comma-separated (max 50).
firstNamesstringFirst name filters, comma-separated (max 70).
lastNamesstringLast name filters, comma-separated (max 70).
industryIdsstringIndustry IDs, comma-separated (max 70).
seniorityLevelIdsstringSeniority level IDs, comma-separated.
functionIdsstringJob function IDs, comma-separated.
companyHeadcountstringCompany size filter, comma-separated.
recentlyChangedJobsbooleanOnly people who changed jobs within 90 days.
postedOnLinkedinbooleanOnly people who posted on LinkedIn in the last 30 days.
salesNavUrlstringLinkedIn Sales Navigator URL (overrides other filters except page).
limitinteger · min: 1 · max: 25Maximum number of leads to enrich with a full profile (default 10, max 25).
Default: 10findEmailstringFind and verify email via SMTP when enriching profiles.
skipSmtpstringSkip SMTP verification when finding emails.
includeAboutProfilestringInclude the 'About this profile' popup data.
Responses
Enriched lead search results returned successfully
dataobject[]Array of person records.
totalintegerTotal number of matching leads.
pageintegerCurrent page number (1-based).
sizeintegerPage size.
total_pagesintegerTotal number of pages.
enriched_countintegerNumber of records enriched with a full profile (search-profile only).
Prospect: Realtime profile
Fetch a single profile in realtime, returned in the same person shape as /v2/person/search. Provide at least one of url, publicIdentifier, or profileId. Optional findEmail, skipSmtp, main, and includeAboutProfile flags are supported.
Authentication: All requests require the X-API-Key header.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.X-API-Keystring · requiredYour API key for authentication.
Request Body
urlstringLinkedIn profile URL.
publicIdentifierstringPublic identifier of the profile (the /in/
slug). profileIdstringLinkedIn profile ID.
findEmailstringFind and verify email via SMTP.
skipSmtpstringSkip SMTP verification when finding emails.
mainstringReturn only the main version with limited data for fewer credits.
includeAboutProfilestringInclude the 'About this profile' popup data.
Responses
Profile returned successfully
dataobject[]Array with the single person record.