How to enrich your data via Snov.io API

This guide explains how to send your data for enrichment and get valuable B2B data in return via Snov.io API.

How data enrichment works:

Send the data you have to Snovio via an API request. We match your information against our database or find it for you. You get back the enriched data in return.

This process automatically enriches your existing information with fresh sales data. Using API makes this scalable, whether you need to enrich 10 records or 10,000.

Find domains from company names

Using Domain name enrichment, find a company's domain (website) by providing its exact official name.

How it works:

1) Send company names to the API.

2) Receive corresponding company domains in return.

Step 1. Send your data (provide company names)

---

Request’s URL: https://api.snov.io/v2/company-domain-by-name/start

Request’s type: POST

---

In the “names[]” parameter, enter the company name for which you want to receive the domain

You can enrich up to 10 companies per request. Add each company name in a separate parameter.

To receive the results automatically, add the "webhook_url" parameter with your destination URL where Snov.io will send enriched data.

Using the webhook is optional. If you skip it, you can retrieve results with a separate API request.

The response will provide a "task_hash": a unique identifier for your request. You will need this ID to get your results via a follow-up API request.

Step 2. Get results (receive company domains)

There are two ways to receive your enriched data:

1. Webhook: If you've added a webhook to the previous request, we'll send results there when ready.
2. Separate API request: Use the following request.

---

Request type: GET

URL: https://api.snov.io/v2/company-domain-by-name/result?task_hash={hash_from_1}

---

In the "task_hash" parameter, add the unique ID from your previous request where you sent data.

For every company you requested, Snov.io API will return the following data fields:

• "name": The original company name you provided
• "domain": The domain address of the company

For more details, refer to the request and response examples in our API documentation.

Find email addresses from names and domains

Using the Email Finder API, you can find verified business email addresses by providing a prospect's name and their company's domain.

How it works:

1. Send the prospect’s first name, last name and their company’s domain name to the API.
2. Receive the email address and verification status in return.

Step 1. Send your data (provide name and domain)

---

Request type: POST

URL: https://api.snov.io/v2/emails-by-domain-by-name/start

---

In the “rows” parameter, provide information about the prospect: first name, last name and domain.

For each prospect in your request, include an array of data with the following fields:

In the "first_name" and "last_name" fields, provide the prospect's first name and last name.

In the "domain" field, provide the domain name of the company for which the prospect works.

The response will provide a "task_hash": a unique identifier for your request. You'll need this ID to get results when making a follow-up API request.

Step 2. Get results (receive a verified email address)

There are two ways to get results:

1. Webhook: If you've added a webhook to the previous request, we will send the results there when the search is completed.
2. Separate API request:

---

Request type: GET

URL: https://api.snov.io/v2/emails-by-domain-by-name/start/result?task_hash={hash_from_1}

---

In the "task_hash" parameter for this request, add the unique ID you received from your previous request where you sent data.

For every prospect you added to a request, Snov.io will return the following data:

• The email address
• Verification status (valid, invalid, or unknown)
• The results of additional checks that either confirm validity or explain why the status is unknown

For more details, refer to our API documentation.

Verify email status

Using the Email Verifier API, you can check if your email addresses are valid. Our verification confirms that your email list has no deliverability risks and is ready for use in campaigns.

How to use it:

1. Provide email addresses you want to verify to the API.
2. Receive their email verification statuses.

Step 1. Send your data (provide email addresses for verification)

---

Request type: POST

URL: https://api.snov.io/v2/email-verification/start

---

In the "emails[]" parameter, enter the email addresses for which you want to check the status.

You can check up to 10 emails per request. Add each email address in a separate parameter.

To receive the verification results automatically, add the "webhook_url" parameter with your destination URL where Snov.io will send them. Using the webhook is optional. If you skip it, you can retrieve results with a separate API request.

The response will provide a "task_hash": a unique identifier for your request. You'll need this ID to retrieve your results when making a follow-up API request.

Step 2. Get results (receive email status)

There are two ways to receive your enriched data:

1. Webhook: If you've added a webhook to the previous request, we'll send results there when ready.
2. API request: Use the following request.

---

Request type: GET

URL: https://api.snov.io/v2/email-verification/result?task_hash={hash_from_1}'

---

In the "task_hash" parameter, add the unique ID received from your previous request where you sent data.

For each email address you added for verification, Snov.io will check and return one of three statuses:

• valid: The email address exists and can receive messages
• not_valid: The email doesn't exist or cannot receive messages
• unknown (Unverifiable): The email address couldn't be verified with 100% certainty, but is still likely valid.

For emails with "unknown" status, we provide a detailed reason as determined during verification. It could be one of the following:

Banned: High deliverability risk – the email address couldn't be verified with 100% certainty.

Catchall: Sender reputation risk – the email server uses a "catch-all policy", making it impossible to confirm the email exists.

Connection error: High bounce risk due to technical issues on the recipient's side.

Greylisted: The email server uses graylisting filters, making it hard to verify the email address.

Hidden by owner: The email owner or the company that owns the domain requested its removal from Snov.io results.

See the full list of enriched fields in the API documentation.

Get complete data from LinkedIn profile links

Using LinkedIn profile enrichment, get information about the prospect by providing a link to their profile.

How it works:

1. Provide the LinkedIn profile URL to the API.
2. Receive complete prospect details with job title and other information.

Step 1. Send your data (provide LinkedIn URLs)

---

Request type: POST

URL: https://api.snov.io/v2/li-profiles-by-urls/start

---

In the "urls[]" parameter, add LinkedIn URLs for which you want to receive the info. You can add up to 10 URLs per request. Each URL should be in a separate parameter. 

To receive the results automatically, add the "webhook_url" parameter with your destination URL where Snov.io will send enriched data. Using the webhook is optional. If you skip it, you can retrieve results with a separate API request.

The response for this request will provide a "task_hash": a unique identifier for your request. You'll need this ID to get results when making a follow-up API request.

Step 2. Get results (receive prospect profile info)

There are two ways to receive your enriched data:

1. Webhook: If you've added a webhook to the previous request, we'll send results there when ready.
2. Separate API request: Use the following request.

---

Request type: GET

URL: https://api.snov.io/v2/li-profiles-by-urls/result?task_hash={hash_from_1}

---

In the "task_hash" parameter, add the unique ID from your previous "send data" request.

For every LinkedIn profile link you added for enrichment, Snov.io will return the complete data for the prospect it belongs to and their company.

Prospect data:

• Full name, first name, last name
• Industry
• Country, city of location
• Job title

Company data:

• Company name
• Company LinkedIn URL
• Company domain
• Industry
• Country and city of location

For more details, refer to the request and response examples in our API documentation.

Data Enrichment API credit cost

In the table below, we'll provide details on how Snov.io charges credits from your account balance when using requests for enrichment, Email Finder and Email Verifier APIs.

Enrichment	API request	Credits
Find domain names from company names	https://api.snov.io/v2/company-domain-by-name/start	1 credit for each company for which Snovio provided a domain address.
Get LinkedIn profile info from URL	https://api.snov.io/v2/li-profiles-by-urls/start	1 credit for each LinkedIn profile URL for which Snovio provided prospect information.
Email Verifier: enrich email status	https://api.snov.io/v2/email-verification/start	1 credit for each email address checked in the request, regardless of the verification results (whether status is valid, unknown, or not_valid).
Email Finder: enrich email address from prospect's name and domain	https://api.snov.io/v2/emails-by-domain-by-name/start	1 credit for each prospect in the request for which we found a valid (green) or unknown (yellow) email address. If the email address is not_valid, we don't charge credits for it.
Enrich person profile from email	https://api.snov.io/v1/get-profile-by-email	1 credit per request in which we find prospect information for the provided email address. If we find no information about the email owner, you will not be charged for the request.