# Search

**Search APIs:** Find contacts or companies using known identifiers.

Look up contacts by `id`, `linkedinUrl`, `email`, or `firstName` + `lastName` + `companyName`/`companyDomain`. Look up companies by `id`, `name`, or `domain`.

Returns a non-PII preview of each profile with a `has` field listing available data points and a `canReveal` field showing what can be unlocked via Enrich.

> **Billing:** Charged per successful result via the `api_search` action.


## Search Contacts

 - [POST /v3/contacts/search](https://docs.lusha.com/apis/openapi/search/searchcontacts.md): Look up contacts by identifier. Returns a non-PII preview of each profile — no emails or phone numbers.

Accepted identifiers (one required per contact):
- Lusha contact id
- linkedinUrl
- email
- firstName + lastName + companyName or companyDomain

Up to 100 contacts per request. Each result includes:
- has — data points available on this profile
- canReveal — what you can unlock via Enrich Contacts, and the credit cost

Pass a signals filter to narrow results to contacts with recent activity (e.g. promotion, job change).

> Billing: Charged per successful result via the api_search action.

## Search Companies

 - [POST /v3/companies/search](https://docs.lusha.com/apis/openapi/search/searchcompanies.md): Look up companies by identifier. Returns a preview of each company profile.

Accepted identifiers (at least one required per company):
- Lusha company id
- name
- domain

Up to 100 companies per request. Each result includes a has field listing the data available via Enrich Companies.

Pass a signals filter to narrow results to companies showing specific activity (e.g. headcount growth, hiring surge).

> Billing: Charged per successful result via the api_search action.