Use the Search API to search the Cognism database for contacts and companies that match specific search criteria.
The Search API returns a preview of matching records so you can review available data before retrieving the complete profile using the Redeem API.
When to use the Search API
Use the Search API when you want to:
- Find new prospects that match specific criteria.
- Search for companies in the Cognism database.
- Build prospecting workflows.
- Review available data before redeeming records.
If you already have a contact or company and want to enrich it, use the Enrich API instead.
How the Search API works
The Search API searches the Cognism database using the filters you specify.
Matching records are returned as preview results together with a Redeem ID for each record.
Use the Redeem ID to retrieve the complete contact or company profile.
Search criteria
The Search API supports a wide range of search filters, including:
Contact filters
- First name
- Last name
- Job title
- Seniority
- Management level
- Job function
- Email quality
- Phone availability
- LinkedIn URL
- Location
Company filters
- Company name
- Industry
- Technologies
- Company size
- Revenue
- Website
- Domain
- Location
You can combine multiple filters to narrow your search results.
For a complete list of supported filters, refer to the Cognism Developer Portal.
Search results
The Search API returns:
- Matching contacts or companies
- A preview of available data
- A Match Score
- A Redeem ID for each matching record
The preview shows which data is available without returning the complete profile.
To access the complete record, use the Redeem ID with the Redeem API.
Preview data
Preview responses contain availability indicators for many fields.
For example, the response can indicate whether a record includes:
- Email address
- Mobile phone number
- Direct dial
- LinkedIn profile
- Skills
- Company information
The Redeem API returns the actual values after you redeem the record.
Search limits
The Search API supports:
- Between 20 and 100 records per request.
- Up to 1,000 records per minute.
Limits may change over time. Refer to the Cognism Developer Portal for the latest API specifications.
Credits
Search requests do not consume Credits.
Credits are only consumed if you later redeem a contact using the Redeem API.
Next step
Once you have identified the records you want, use the Redeem API to retrieve the complete contact or company profile.