Data Catalog

This catalog provides a comprehensive overview of the available data fields in the Lusha API. Each section represents a specific capability, with detailed information about data fields, their purpose, structure, and accessibility.

For each field, you'll find:

Field Name – the user-friendly label
API Path – the exact path in the API response
Description – explanation of the field's meaning and context
Data Type – the data format (String, Integer, Boolean, Array, Object)

Enrichment

Add missing contact and company data

CAPABILITY	PERSON ENRICHMENT	BULK PERSON ENRICHMENT	COMPANY ENRICHMENT	BULK COMPANY ENRICHMENT
Endpoint	`GET /v2/person`	`POST /v2/person`	`GET /v2/company`	`POST /v2/company`
Description	Enrich individual contacts with verified data	Enrich up to 100 contacts in one request	Enrich individual companies with firmographic data	Enrich up to 100 companies in one request
Inputs	Email, LinkedIn URL, or Name + Company	Array of contact objects	Domain, Company name, or Company ID	Array of company objects (domain, name, or ID)
Outputs	Contact profile, verified email/phone, job details, social profiles	Batch contact data, company info per contact, structured profiles	Company profile, firmographics, technographics, employee counts	Batch company data, firmographics per company, technology stack, industry data
Best for	Form enrichment, real-time lookups, CRM completion, webhook enrichment	Bulk CRM enrichment, data cleanup, backfills	ABM, single account enrichment, real-time lookups	Bulk account enrichment, territory planning, market analysis

Rate limit: 25 req/sec per endpoint

Prospecting

Search for new contacts and companies matching your ICP

CAPABILITY	CONTACT SEARCH	CONTACT ENRICH	COMPANY SEARCH	COMPANY ENRICH
Endpoint	`POST /prospecting/contact/search`	`POST /prospecting/contact/enrich`	`POST /prospecting/company/search`	`POST /prospecting/company/enrich`
Description	Find contacts matching your ICP criteria	Get full details from contact search results	Find companies matching your criteria	Get full details from search results
Inputs	Filters (title, seniority, location, signals), company filters, signal filters	Contact IDs + requestId from search, optional revealEmails/revealPhones	Filters (industry, size, location, signals), intent topics, technologies	Company IDs + requestId from search
Outputs	Contact IDs, preview data, match count, requestId	Full profiles, verified data points, company details, credit charged	Company IDs, preview data, match count, requestId	Full company profiles, firmographics, tech stack, credit charged
Best for	Prospect lists, ICP-based workflows, lead gen	Selective enrichment, credit optimization	Market analysis, account discovery, TAM expansion	Firmographics after search, account list building

Typical workflow: Search → Review preview data → Enrich selected results

Signals

Track professional changes and business events

CAPABILITY	CONTACT SIGNALS BY ID	CONTACT SIGNALS SEARCH	COMPANY SIGNALS BY ID	COMPANY SIGNALS SEARCH
Endpoint	`POST /api/signals/contacts`	`POST /api/signals/contacts/search`	`POST /api/signals/companies`	`POST /api/signals/companies/search`
Description	Track professional changes for known contacts	Find and enrich contacts with change signals	Monitor company growth and hiring signals	Find and enrich companies with business signals
Inputs	Contact IDs, signal types, start date	Email/LinkedIn/Name + Company, signal types, date range	Company IDs, signal types, start date	Domain/Company name, signal types, date range
Outputs	Promotions, job changes, company moves, timestamps	Contact data + signals, transitions, credit charged	Headcount growth, job postings, new hires, velocity	Company data + signals, growth indicators, credit charged
Best for	Champion tracking, renewal risk alerts, monitoring	Trigger-based outreach, warm intros	Expansion signals, hiring intent tracking	Finding high-intent accounts, timed campaigns

Default behavior: If no startDate is specified, signals return the last 6 months.

Lookalikes

Find similar contacts and companies based on your best customers

CAPABILITY	CONTACT LOOKALIKE	COMPANY LOOKALIKE
Endpoint	`POST /api/recommendations/contacts`	`POST /api/recommendations/companies`
Description	Find contacts similar to your best performers	Find companies similar to your best accounts
Inputs	Reference contact IDs or profile attributes	Reference company IDs or firmographic criteria
Outputs	Similar contacts with similarity scores, matched attributes	Similar companies with similarity scores, matched attributes
Best for	Expanding into new personas, finding more champions	TAM expansion, new market entry, account-based targeting

Data Points Reference

Complete field-by-field breakdown of API responses organized by endpoint.

Contacts

Enrichment

Returns comprehensive contact and company data for a single person lookup.

Enrichment Metadata

Field Name	API Path	Description	Data Type
Error	`contact.error`	Returns error details if the request failed; null if successful	Object
Credit Charged	`contact.isCreditCharged`	Boolean indicating if a Lusha credit was consumed	Boolean

Contact Personal Identity

Field Name	API Path	Description	Data Type
Person ID	`data.personId`	Lusha's unique internal identifier for the individual	Integer
First Name	`data.firstName`	The contact's first name	String
Last Name	`data.lastName`	The contact's last name	String
Full Name	`data.fullName`	The concatenated first and last name	String
Contact Tags	`data.contactTags[]`	Custom labels (e.g., "Decision maker", "Opportunity") with id, name, color	Array [Object]
LinkedIn	`data.socialLinks.linkedin`	Validated URL for the contact's LinkedIn profile	URL

Contact Information

Field Name	API Path	Description	Data Type
Email	`data.emailAddresses[].email`	The verified email address	String
Email Type	`data.emailAddresses[].emailType`	Classification (e.g., work, personal)	String
Email Update Date	`data.emailAddresses[].updateDate`	The date this specific email was last verified	Date
Email Confidence	`data.emailAddresses[].emailConfidence`	Confidence score for deliverability (e.g., A+)	String
Phone Number	`data.phoneNumbers[].number`	Phone number in international format	String
Phone Type	`data.phoneNumbers[].phoneType`	Classification (e.g., mobile, direct, office)	String
Do Not Call	`data.phoneNumbers[].doNotCall`	Boolean flag for DNC (Do Not Call) registry status	Boolean
Phone Update Date	`data.phoneNumbers[].updateDate`	The date this specific phone was last verified	Date

Contact Location

Field Name	API Path	Description	Data Type
Continent	`data.location.continent`	Continent name of the contact	String
Country	`data.location.country`	Country name of the contact	String
Country ISO2	`data.location.country_iso2`	Two-letter ISO country code	String
City	`data.location.city`	City name	String
City ID	`data.location.city_id`	Lusha internal city identifier	Integer
EU Contact	`data.location.is_eu_contact`	Boolean indicating if the contact is in the European Union	Boolean
Coordinates	`data.location.location_coordinates`	Array [Longitude, Latitude] for the contact	Array [Float]

Current Professional Data

Field Name	API Path	Description	Data Type
Job Title	`data.jobTitle.title`	The full, raw job title string	String
Seniority	`data.jobTitle.seniority`	Standardized seniority (e.g., Vice President, Manager)	String
Departments	`data.jobTitle.departments`	Array of functional business units (e.g., General Management)	Array
Job Start Date	`data.jobStartDate`	The date the contact started their current role	Date
Update Date	`data.updateDate`	The last time the contact record was updated	Date

Career History

Field Name	API Path	Description	Data Type
Previous Company	`previousJob.company.name`	Name of the previous employer organization	String
Previous Domain	`previousJob.company.domain`	The web domain of the previous employer	String
Previous Title	`previousJob.jobTitle.title`	The title held at the previous company	String
Previous Seniority	`previousJob.jobTitle.seniority`	The seniority level of the previous role	String

Company Firmographics

Field Name	API Path	Description	Data Type
Company ID	`company.companyId`	Lusha's unique global identifier for the account	Integer
Company Name	`company.name`	The full legal or trade name of the company	String
Description	`company.description`	A summary of the company's business and value prop	String
Homepage URL	`company.homepageUrl`	Primary website URL	URL
FQDN	`company.fqdn`	Fully Qualified Domain Name	String
Homepage Domain	`company.domains.homepage`	Root domain for the website	String
Email Domain	`company.domains.email`	Root domain for email server	String
Company Size	`company.companySize`	Array [Min, Max] of employee count	Array [Integer]
Revenue Range	`company.revenueRange`	Array [Min, Max] of annual revenue (e.g., [1B, 10B])	Array [Integer]
Logo URL	`company.logoUrl`	URL for the organization's logo image	URL
Main Industry	`company.mainIndustry`	The primary industry vertical	String
Sub Industry	`company.subIndustry`	Granular industry niche	String

Company Industry Codes

Field Name	API Path	Description	Data Type
SIC Codes	`company.industryPrimaryGroupDetails.sics[]`	Standardized SIC codes and their descriptions	Array [Object]
NAICS Codes	`company.industryPrimaryGroupDetails.naics[]`	Standardized NAICS codes and their descriptions	Array [Object]

Company Location

Field Name	API Path	Description	Data Type
Continent	`company.location.continent`	Continent of the company HQ	String
Country	`company.location.country`	Country of the company HQ	String
State	`company.location.state`	State name for the HQ	String
State Code	`company.location.stateCode`	Two-letter state code	String
City	`company.location.city`	HQ City	String
Raw Location	`company.location.rawLocation`	Full unformatted address string	String
Coordinates	`company.location.locationCoordinates`	Array [Longitude, Latitude] for the company HQ	Array [Float]

Company Socials

Field Name	API Path	Description	Data Type
LinkedIn	`company.social.linkedin`	Company LinkedIn profile URL	URL
Crunchbase	`company.social.crunchbase`	Company Crunchbase profile URL	URL

Company Funding

Field Name	API Path	Description	Data Type
Total Rounds	`company.funding.totalRounds`	Total number of funding events	Integer
Total Amount	`company.funding.totalRoundsAmount`	Total capital raised (Sum of all rounds)	Integer
Currency	`company.funding.currency`	Currency code used for funding (e.g., USD)	String
Last Round Type	`company.funding.lastRoundType`	E.g., Private Equity Round, Series C	String
Last Round Amount	`company.funding.lastRoundAmount`	Capital raised in the most recent round	Integer
Last Round Date	`company.funding.lastRoundDate`	Date of the most recent funding event	String
Is IPO	`company.funding.isIpo`	Boolean: True if the company is public	Boolean
Funding Rounds	`company.funding.rounds[]`	Detailed historical funding round data (roundAmount, roundType, roundDate)	Array [Object]

Technographics & Intent

Field Name	API Path	Description	Data Type
Technologies	`company.technologies[].name`	Software/tools detected in the company's stack	Array [Object]
Intent Topic Count	`company.intent.topicCount`	Total number of active intent topics	Integer
Detected Topics	`company.intent.detectedTopics[]`	Specific topics of research interest and their scores/trends (topicName, metadata)	Array [Object]

Prospecting Search

Returns a list of contacts matching your search criteria with preview data and availability indicators.

Search Metadata

Field Name	API Path	Description	Data Type
Request ID	`requestId`	Unique ID assigned to the specific search query session	String
Current Page	`currentPage`	The current page index of the results set	Integer
Page Length	`pageLength`	Number of results returned per page (e.g., 50)	Integer
Total Results	`totalResults`	Total number of contacts found matching the search criteria	Integer

Contact Identity

Field Name	API Path	Description	Data Type
Name	`data[].name`	The full name of the contact	String
Contact ID	`data[].contactId`	Lusha's unique internal UUID for the contact record	String (UUID)
Person ID	`data[].personId`	Numerical identifier for the contact	Integer

Contact Job Data

Field Name	API Path	Description	Data Type
Job Title	`data[].jobTitle`	The raw professional title of the contact	String

Company Information

Field Name	API Path	Description	Data Type
Company ID	`data[].companyId`	Lusha's unique global identifier for the company	Integer
Company Name	`data[].companyName`	Legal or trade name of the employer	String
FQDN	`data[].fqdn`	Fully Qualified Domain Name of the company website	String
Description	`data[].companyDescription`	Brief textual bio of the organization	String
Logo URL	`data[].logoUrl`	CDN link to the company's brand logo	URL

Data Availability Indicators

Use these boolean flags to understand what data is available before enrichment.

Field Name	API Path	Description	Data Type
Is Shown	`data[].isShown`	Boolean indicating if this record is currently visible/accessible	Boolean
Has Department	`data[].hasDepartment`	True if department classification is available	Boolean
Has Seniority	`data[].hasSeniority`	True if seniority level data is available	Boolean
Has Contact Location	`data[].hasContactLocation`	True if the contact's location is known	Boolean
Has Social Link	`data[].hasSocialLink`	True if a LinkedIn or social profile is available	Boolean

Email Availability

Field Name	API Path	Description	Data Type
Has Emails	`data[].hasEmails`	True if Lusha has at least one email for this contact	Boolean
Has Work Email	`data[].hasWorkEmail`	True if a verified corporate email is available	Boolean
Has Private Email	`data[].hasPrivateEmail`	True if a personal email address is available	Boolean

Phone Availability

Field Name	API Path	Description	Data Type
Has Phones	`data[].hasPhones`	True if Lusha has at least one phone number	Boolean
Has Mobile Phone	`data[].hasMobilePhone`	True if a direct mobile number is available	Boolean
Has Direct Phone	`data[].hasDirectPhone`	True if a direct office/desk line is available	Boolean

Company Data Availability

Field Name	API Path	Description	Data Type
Has Employees Count	`data[].hasCompanyEmployeesCount`	True if company size data is available	Boolean
Has Revenue	`data[].hasCompanyRevenue`	True if estimated revenue data is available	Boolean
Has Main Industry	`data[].hasCompanyMainIndustry`	True if high-level industry data is available	Boolean
Has Sub Industry	`data[].hasCompanySubIndustry`	True if granular industry data is available	Boolean
Has Funding	`data[].hasCompanyFunding`	True if the company has recorded funding rounds	Boolean
Has Intent	`data[].hasCompanyIntent`	True if active intent signals are being tracked	Boolean
Has Technologies	`data[].hasCompanyTechnologies`	True if tech stack data is available	Boolean
Has City	`data[].hasCompanyCity`	True if the HQ city is known	Boolean
Has Country	`data[].hasCompanyCountry`	True if the HQ country is known	Boolean

Billing Metadata

Field Name	API Path	Description	Data Type
Credits Charged	`billing.creditsCharged`	Number of credits deducted for the search request	Integer
Results Returned	`billing.resultsReturned`	Number of data objects included in the current response	Integer

Prospecting Enrich

Returns full contact details for selected contacts from search results.

Request Metadata

Field Name	API Path	Description	Data Type
Request ID	`requestId`	Unique ID for the enrichment session	String
Credits Charged	`creditsCharged`	Number of credits consumed for this specific enrichment	Integer

Status Flags

Field Name	API Path	Description	Data Type
Contact ID	`contacts[].id`	The Contact UUID (links back to search results)	String (UUID)
Is Success	`contacts[].isSuccess`	Boolean: Indicates if the enrichment was successful	Boolean
Error	`contacts[].error`	Error details if isSuccess is false	Object/Null

Contact Identity

Field Name	API Path	Description	Data Type
Person ID	`data.personId`	Lusha's numerical unique ID for the person	Integer
First Name	`data.firstName`	Individual's given name	String
Last Name	`data.lastName`	Individual's family name	String
Full Name	`data.fullName`	Concatenated name	String
Is Shown	`data.isShown`	Boolean indicating if the contact is visible in the UI	Boolean

Contact Job Data

Field Name	API Path	Description	Data Type
Job Title	`data.jobTitle`	The full raw professional title	String
Departments	`data.departments[]`	Array of functional business units (e.g., Engineering)	Array [String]
Seniority	`data.seniority[]`	Array of seniority objects containing id and value	Array [Object]

Contact Location

Field Name	API Path	Description	Data Type
Country	`data.location.country`	Country name for the contact	String
Continent	`data.location.continent`	Continent name for the contact	String

Contact Information

Field Name	API Path	Description	Data Type
Email	`data.emailAddresses[].email`	The revealed email address	String
Email Type	`data.emailAddresses[].emailType`	Classification (work/personal)	String
Email Confidence	`data.emailAddresses[].emailConfidence`	Deliverability grade	String
Email Update Date	`data.emailAddresses[].updateDate`	ISO Timestamp of the last email verification	DateTime
Phone Number	`data.phoneNumbers[].number`	Revealed phone string	String
Phone Type	`data.phoneNumbers[].phoneType`	Phone classification	String
LinkedIn	`data.socialLinks.linkedin`	The contact's LinkedIn profile URL	URL

Company Information

Field Name	API Path	Description	Data Type
Company ID	`data.companyId`	Global ID of the organization	Integer
Company Name	`data.companyName`	Legal name of the organization	String
FQDN	`data.company.fqdn`	Fully Qualified Domain Name	String
Description	`data.company.description`	Company bio	String
Logo URL	`data.company.logoUrl`	Brand logo URL	URL
Employees	`data.company.employees`	String representation of headcount (e.g., "100-500")	String
Revenue Range	`data.company.revenueRange`	Array [Min, Max] of estimated annual revenue	Array [Integer]
Main Industry	`data.company.mainIndustry`	High-level industry sector	String
Sub Industry	`data.company.subIndustry`	Granular industry vertical	String

Company Location

Field Name	API Path	Description	Data Type
City	`data.company.location.city`	HQ City	String
State	`data.company.location.state`	HQ State name	String
State Code	`data.company.location.state_code`	2-letter state code	String
Country	`data.company.location.country`	HQ Country name	String
Country ISO2	`data.company.location.country_iso2`	ISO country code	String
Raw Location	`data.company.location.raw_location`	Full unformatted HQ address string	String
Coordinates	`data.company.location.location_coordinates`	HQ [Longitude, Latitude] array	Array [Float]

Company Socials

Field Name	API Path	Description	Data Type
LinkedIn	`data.company.linkedin`	Official company LinkedIn page	URL
Crunchbase	`data.company.crunchbase`	Company Crunchbase profile	URL

Signals

Returns professional change signals (promotions, job changes) for tracked contacts.

Usage Metadata

Field Name	API Path	Description	Data Type
Start Date	`startDate`	The beginning of the signal tracking window	Date (YYYY-MM-DD)
End Date	`endDate`	The end of the signal tracking window	Date (YYYY-MM-DD)
Credit Charged	`creditCharged`	Total credits consumed for this batch retrieval	Integer

Contact ID Key

Field Name	API Path	Description	Data Type
Person ID	`contacts.{id}.personId`	The unique Lusha identifier for the contact	Integer/String

Company Change Signal

Triggered when a contact moves to a new organization.

Field Name	API Path	Description	Data Type
Person ID	`contacts.{id}.companyChange[].personId`	Person identifier within the signal object	Integer/String
Current Company ID	`contacts.{id}.companyChange[].currentCompanyId`	Lusha ID of the new organization	Integer
Current Company Name	`contacts.{id}.companyChange[].currentCompanyName`	Name of the organization the person joined	String
Current Domain	`contacts.{id}.companyChange[].currentDomain`	Web domain of the new organization	String
Current Title	`contacts.{id}.companyChange[].currentTitle`	The person's new job title	String
Current Seniority	`contacts.{id}.companyChange[].currentSeniorityLabel`	Standardized seniority level (e.g., "c-suite", "director")	String
Current Departments	`contacts.{id}.companyChange[].currentDepartments`	Functional business unit(s) for the new role	Array [Object/String]
Previous Company Name	`contacts.{id}.companyChange[].previousCompanyName`	Name of the employer the person recently left	String
Previous Domain	`contacts.{id}.companyChange[].previousDomain`	Web domain of the previous employer	String
Signal Date	`contacts.{id}.companyChange[].signalDate`	Date the change was detected or became effective	Date (YYYY-MM-DD)

Promotion Signal

Triggered when a contact is promoted within their organization.

Field Name	API Path	Description	Data Type
Current Company ID	`contacts.{id}.promotion[].currentCompanyId`	Lusha ID of the organization where the promotion occurred	Integer
Current Company Name	`contacts.{id}.promotion[].currentCompanyName`	Name of the organization where the promotion occurred	String
Current Domain	`contacts.{id}.promotion[].currentDomain`	Web domain of the organization	String
Current Title	`contacts.{id}.promotion[].currentTitle`	The contact's new, higher-level title	String
Current Seniority	`contacts.{id}.promotion[].currentSeniorityLabel`	Updated standardized seniority level	String
Current Departments	`contacts.{id}.promotion[].currentDepartments`	Functional business unit(s) for the promoted role	Array [Object/String]
Signal Date	`contacts.{id}.promotion[].signalDate`	Date the promotion was detected	Date (YYYY-MM-DD)

Lookalikes

Returns contacts similar to your reference contacts based on professional attributes.

Search Metadata

Field Name	API Path	Description	Data Type
Request ID	`requestId`	Unique session identifier for the lookalike query	String
Count	`count`	Total number of lookalike contacts returned in the response	Integer
Credits Charged	`creditsCharged`	Number of credits consumed to generate the lookalike list	Integer

Contact Details

Field Name	API Path	Description	Data Type
Person ID	`contacts[].personId`	Lusha's numerical unique identifier for the lookalike contact	String/Integer
Name	`contacts[].name`	Full name of the lookalike contact	String
Job Title	`contacts[].jobTitle`	The raw professional title of the lookalike contact	String
Company ID	`contacts[].companyId`	Lusha's unique global identifier for the lookalike's organization	String/Integer
Company Name	`contacts[].companyName`	The full name of the organization where the lookalike works	String

Companies

Enrichment

Returns comprehensive company data including firmographics, funding, and intent signals.

Platform IDs

Field Name	API Path	Description	Data Type
LinkedIn Company ID	`id`	Permanent unique identifier for the company on LinkedIn	Integer
Lusha Company ID	`lushaCompanyId`	Lusha's unique internal global identifier for the organization	String

Firmographics

Field Name	API Path	Description	Data Type
Name	`name`	Legal or common trade name of the company	String
FQDN	`fqdn`	Fully Qualified Domain Name (e.g., www.citigroup.com)	String
Founded	`founded`	The year the organization was established	String
Description	`description`	Comprehensive textual bio or mission statement	String
Logo URL	`logoUrl`	CDN link to the company's brand logo image	URL

Size & Revenue

Field Name	API Path	Description	Data Type
Company Size	`companySize`	Array containing [Min, Max] employee count range	Array [Integer]
Revenue Range	`revenueRange`	Array containing [Min, Max] annual revenue range	Array [Integer]

Industry & Focus

Field Name	API Path	Description	Data Type
Main Industry	`mainIndustry`	High-level industry sector (e.g., Finance, Technology)	String
Sub Industry	`subIndustry`	Granular industry niche (e.g., Software Development)	String
Specialities	`specialities`	Array of keywords defining core business activities	Array [String]

Industry Codes

Field Name	API Path	Description	Data Type
SIC Code	`industryPrimaryGroupDetails.sics[].sic`	SIC code	Integer
SIC Description	`industryPrimaryGroupDetails.sics[].description`	Human-readable SIC description	String
NAICS Code	`industryPrimaryGroupDetails.naics[].naics`	NAICS code	Integer
NAICS Description	`industryPrimaryGroupDetails.naics[].description`	Human-readable NAICS description	String

Location

Field Name	API Path	Description	Data Type
City	`city`	HQ City	String
State	`state`	HQ State/Province name	String
Country	`country`	Full country name	String
Country ISO2	`countryIso2`	Two-letter ISO country code	String
Continent	`continent`	Continent of the organization's HQ	String
Raw Location	`rawLocation`	Full unformatted address string	String

Social Links

Field Name	API Path	Description	Data Type
LinkedIn	`linkedin`	URL for the company's official LinkedIn page	URL
Crunchbase	`crunchbase`	URL for the company's Crunchbase profile	URL

Funding

Field Name	API Path	Description	Data Type
Total Rounds	`funding.totalRounds`	Count of unique funding events	Integer
Total Amount	`funding.totalRoundsAmount`	Cumulative capital raised across all historical rounds	Integer
Currency	`funding.currency`	Normalized currency for totals (usually USD)	String
Is IPO	`funding.isIpo`	Boolean: True if the company is publicly traded	Boolean
Last Round Type	`funding.lastRoundType`	Type of most recent event (e.g., Post-IPO Debt)	String
Last Round Amount	`funding.lastRoundAmount`	Capital raised in the most recent event	Integer
Last Round Date	`funding.lastRoundDate`	Date of the most recent funding event	String
Round Currency	`funding.rounds[].currency`	Specific currency for a historical round	String
Round Amount	`funding.rounds[].roundAmount`	Amount for a historical round	Integer
Round Type	`funding.rounds[].roundType`	Classification for a historical round	String
Round Date	`funding.rounds[].roundDate`	Date for a historical round	String

Intent Data

Field Name	API Path	Description	Data Type
Topic Count	`intent.topicCount`	Number of topics showing active research interest	Integer
Topic Name	`intent.detectedTopics[].topicName`	Specific topic name (e.g., Sales Intelligence)	String
Topic Score	`intent.detectedTopics[].topicScore`	Strength of the intent signal (0-100)	Integer
Topic Trend	`intent.detectedTopics[].topicTrend`	Trend velocity (e.g., "+17", "New", "-8")	String

Prospecting Search

Returns a list of companies matching your search criteria with preview data.

Search Metadata

Field Name	API Path	Description	Data Type
Request ID	`requestId`	Unique session identifier for the specific query	String
Current Page	`currentPage`	The current page number in the paginated results	Integer
Page Length	`pageLength`	The number of results returned per page	Integer
Total Results	`totalResults`	Total number of companies matching the search criteria	Integer

Company Identity

Field Name	API Path	Description	Data Type
ID	`data[].id`	LinkedIn Company ID, permanent unique identifier	String/Integer
Name	`data[].name`	The full legal or common name of the company	String
FQDN	`data[].fqdn`	Fully Qualified Domain Name, e.g. www.oatey.com	String
Description	`data[].description`	A textual overview of the company's business and mission	String
Logo URL	`data[].logoUrl`	Public URL for the company's logo asset	URL

Data Availability Flags

Use these boolean flags to understand what data is available before enrichment.

Field Name	API Path	Description	Data Type
Has Employees Count	`data[].hasCompanyEmployeesCount`	True if headcount range data is available	Boolean
Has Revenue	`data[].hasCompanyRevenue`	True if annual revenue data is available	Boolean
Has Main Industry	`data[].hasCompanyMainIndustry`	True if the primary industry sector is identified	Boolean
Has Sub Industry	`data[].hasCompanySubIndustry`	True if the granular industry niche is identified	Boolean
Has Funding	`data[].hasCompanyFunding`	True if the company has recorded funding rounds	Boolean
Has Intent	`data[].hasCompanyIntent`	True if active intent topics are being tracked	Boolean
Has Technologies	`data[].hasCompanyTechnologies`	True if tech stack or technography data is available	Boolean
Has City	`data[].hasCompanyCity`	True if the HQ city location is available	Boolean
Has Country	`data[].hasCompanyCountry`	True if the HQ country location is available	Boolean

Prospecting Enrich

Returns full company details for selected companies from search results.

Search Metadata

Field Name	API Path	Description	Data Type
Request ID	`requestId`	Unique ID for the enrichment session	String

Company Identity

Field Name	API Path	Description	Data Type
ID	`companies[].id`	LinkedIn Company ID, unique identifier on the LinkedIn platform	Integer
Name	`companies[].name`	The full legal or common name of the company	String
FQDN	`companies[].fqdn`	Fully Qualified Domain Name, e.g. www.jameshardie.com	String
Description	`companies[].description`	Comprehensive textual bio or mission statement	String
Founded	`companies[].founded`	The year the organization was established	Integer
Logo URL	`companies[].logoUrl`	CDN link to the company's brand logo image	URL

Web Domains

Field Name	API Path	Description	Data Type
Homepage Domain	`companies[].domains.homepage`	Root domain for the corporate website	String
Email Domain	`companies[].domains.email`	Primary domain used for corporate email addresses	String

Size & Revenue

Field Name	API Path	Description	Data Type
Size Min	`companies[].companySize.min`	Lower bound of employee headcount	Integer
Size Max	`companies[].companySize.max`	Upper bound of employee headcount	Integer
LinkedIn Employees	`companies[].companySize.employees_in_linkedin`	Actual count of employees identified on LinkedIn	Integer
Employees	`companies[].employees`	Formatted string of the headcount range, e.g. "5001 - 10000"	String
Revenue Range	`companies[].revenueRange`	Estimated annual revenue range as [Min, Max]	Array [Integer]

Industry & Focus

Field Name	API Path	Description	Data Type
Main Industry	`companies[].mainIndustry`	High-level industry sector	String
Sub Industry	`companies[].subIndustry`	Granular industry niche	String
Specialities	`companies[].specialities`	Keywords defining core business activities	Array [String]

Industry Codes

Field Name	API Path	Description	Data Type
SIC Code	`industryPrimaryGroupDetails.sics[].sic`	SIC code	Integer
SIC Description	`industryPrimaryGroupDetails.sics[].description`	Human-readable SIC description	String
NAICS Code	`industryPrimaryGroupDetails.naics[].naics`	NAICS code	Integer
NAICS Description	`industryPrimaryGroupDetails.naics[].description`	Human-readable NAICS description	String

HQ Location

Field Name	API Path	Description	Data Type
City	`companies[].city`	HQ city	String
State	`companies[].state`	HQ state name	String
State Code	`companies[].stateCode`	Two-letter state or province code, e.g. IL	String
Country	`companies[].country`	Full country name	String
Country ISO2	`companies[].countryIso2`	Two-letter ISO code	String
Continent	`companies[].continent`	Continent of the organization's HQ	String
Raw Location	`companies[].rawLocation`	Full unformatted address string	String
Coordinates	`companies[].coordinates`	HQ coordinates as [Longitude, Latitude]	Array [Float]

Social Links

Field Name	API Path	Description	Data Type
LinkedIn	`companies[].social.linkedin`	URL for the company's official LinkedIn page	URL
Crunchbase	`companies[].social.crunchbase`	URL for the company's Crunchbase profile	URL

Intent Data

Field Name	API Path	Description	Data Type
Topic Count	`intent.topicCount`	Number of topics currently showing research interest	Integer
Topic Name	`intent.detectedTopics[].topicName`	Specific topic name, e.g. Sales Intelligence Platform	String
Topic Score	`intent.detectedTopics[].metadata.topicScore`	Strength of the intent signal from 0 to 100	Integer
Topic Trend	`intent.detectedTopics[].metadata.topicTrend`	Trend velocity, e.g. "New", "-13"	String

Signals

Returns business change signals (headcount growth, job postings, news events) for tracked companies.

Usage Metadata

Field Name	API Path	Description	Data Type
Start Date	`startDate`	The start of the timeframe tracked for these signals	Date
End Date	`endDate`	The end of the timeframe tracked for these signals	Date
Credit Charged	`creditCharged`	Total credits consumed for this request	Integer

Base Company Data

Field Name	API Path	Description	Data Type
Company ID	`companies.{id}.companyId`	Lusha's unique numerical ID for the organization	String
Company Name	`companies.{id}.companyName`	The full legal or common name of the company	String
Domain	`companies.{id}.domain`	The primary web domain of the organization	String

Job Posting Signal

Triggered when there's significant change in hiring activity.

Field Name	API Path	Description	Data Type
Signal Type	`newJobsOpen[].signalType`	Always "new_jobs_count"	String
Score	`newJobsOpen[].score`	Intensity of hiring activity (low, medium, high)	String
Signal Date	`newJobsOpen[].signalDate`	The date the job count change was recorded	Date
New Value	`newJobsOpen[].newValue`	Current number of active job openings	Integer
Old Value	`newJobsOpen[].oldValue`	Previous number of active job openings	Integer
Historical Avg	`newJobsOpen[].historicalAvg`	The baseline average job count for this company	Float

Headcount Growth Signal

Triggered when a company's employee count changes significantly.

Field Name	API Path	Description	Data Type
Signal Type	`headcountGrowth[].signalType`	The type of growth detected (e.g., size_increase)	String
New Bucket	`headcountGrowth[].newBucket`	The updated employee size range (e.g., "201-500")	String
Old Bucket	`headcountGrowth[].oldBucket`	The previous employee size range (e.g., "1-10")	String

News Event Signal

Triggered when significant company news is detected.

Field Name	API Path	Description	Data Type
Event Type	`newsEvent[].eventType`	Granular event type (e.g., product launch, partnership)	String
Event Category	`newsEvent[].eventCategory`	Broad business grouping (e.g., Business Milestones)	String
Event Summary	`newsEvent[].eventSummary`	A short, AI-generated summary of the event	String
Event Effective Date	`newsEvent[].eventEffectiveDate`	The actual date the event took place (if known)	Date/Null
Article Title	`newsEvent[].articleTitle`	The headline of the news source	String
Article Sentence	`newsEvent[].articleSentence`	A specific quote/snippet from the news article	String
Article URL	`newsEvent[].articleUrl`	Direct link to the source news article	URL
Article Published Date	`newsEvent[].articlePublishedDate`	The date the article was published	Date

Lookalikes

Returns companies similar to your reference companies based on firmographic attributes.

Search Metadata

Field Name	API Path	Description	Data Type
Request ID	`requestId`	Unique session identifier for the lookalike request	String
Count	`count`	Total number of similar companies returned, typically 25	Integer
Credits Charged	`creditsCharged`	Number of credits consumed for this search operation	Integer

Company Details

Field Name	API Path	Description	Data Type
Company ID	`companies[].companyId`	Lusha's unique global identifier for the organization	String
Name	`companies[].name`	The full legal or common name of the organization	String
FQDN	`companies[].fqdn`	Fully Qualified Domain Name, e.g. www.newsday.com	String
Description	`companies[].description`	Textual overview of the company's business model and mission	String

Need help?

Full API Reference – Complete endpoint documentation with examples
Getting Started Guide – Learn how to authenticate and make your first request
Changelog – Track new endpoints, parameter changes, deprecations
Q&A – FAQs and clarifications

Data Catalog

Enrichment

Prospecting

Signals

Lookalikes

Data Points Reference

Need help?

Was this helpful?