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, which can be used to retrieve the complete profile using the Redeem API. Enrich requests do not consume Bulk Credits.
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're looking for entirely 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.
The Redeem ID is then used 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 aren't 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 actual values are only returned after the record has been redeemed.
Bulk Credits
Enrich requests do not consume Bulk Credits.
Bulk Credits are only consumed if you choose to redeem a matched contact using the Redeem API.
Company redemptions do not consume Bulk 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.