Use the Enrich API to update existing contact or company records with the latest data from the Cognism database.
Unlike the Search API, which searches for new prospects, the Enrich API is designed to find the best matching Cognism record for an existing contact or company using the information you already have.
The Enrich API returns a preview of the matched record together with a Redeem ID. You can use the Redeem ID to retrieve the complete profile through the Redeem API.
When to use the Enrich API
Use the Enrich API when you want to:
- Enrich existing CRM records.
- Update customer or prospect data.
- Append missing contact or company information.
- Improve the quality of your existing database.
- Find the best Cognism match for an existing record.
If you are looking for new prospects, use the Search API instead.
How the Enrich API works
The Enrich API compares the information you provide against the Cognism database to identify the best matching contact or company.
If a suitable match is found, the API returns:
- A preview of the matched record.
- A Match Score.
- A Redeem ID.
Use the Redeem ID with the Redeem API to retrieve the complete profile.
Improving match accuracy
Providing unique identifiers improves matching accuracy.
For contacts
For the best results, include unique identifiers such as:
- Email address
- LinkedIn URL
If these are not available, provide as much information as possible, such as:
- First name
- Last name
- Job title
- Company name
- Company website
For companies
For the most accurate company matches, include identifiers such as:
- Company website
- Company domain
- LinkedIn URL
Providing additional company information improves the likelihood of an accurate match.
Match Score
Each matched record includes a Match Score, which indicates how closely the submitted information matches a Cognism record.
By default:
- The minimum Match Score is 30.
- Records with a score below 30 are not returned.
- Scores below 27 are generally considered low-quality matches.
If required, you can configure a different minimum Match Score (minMatchScore) for your requests.
Preview data
The Enrich API returns a preview showing which data is available for the matched record.
For example, the response may indicate whether the record includes:
- Email address
- Mobile phone number
- Direct dial
- LinkedIn profile
- Company information
- Technologies
- Skills
The Redeem API returns the actual values after you redeem the record.
Credits
Enrich requests do not consume Credits.
Credits are only consumed if you choose to redeem a matched contact using the Redeem API.
Company redemptions do not consume Credits.
Next step
Once you've reviewed the preview response and confirmed you've found the correct record, use the Redeem API to retrieve the complete contact or company profile.