This article describes Snovio’s Domain Search API , the general process of using it, what requests are available, their parameters and responses.
This is the API version of the Domain Search tool in the Snov.io app. It provides the same search options through API requests. Using the API, you can request and get information about companies and their contacts (emails and prospect profiles) based on provided domains.
Domain Search (request company info)
Domain Search (get company info)
Search for prospect's email address
Let’s review the endpoints available in the Domain Search API, their purpose within the overall workflow, and look at their main parameters.
Domain Search (request company info)
Request’s type: POST
Request’s URL: https://api.snov.io/v2/domain-search/start/
This is a base endpoint that sends a request to the Snov.io API to search for company information using a provided domain.
Input parameters:
In the "domain" field for this request, enter the domain name (company website) you want to search.
The response contains two key items:
- A unique "task_hash" that identifies your request. You’ll use it in the next request to get the search results.
- A direct URL (in the "result" field) to retrieve the search results (get company information).
Domain Search (get company info)
Request’s type: GET
Request’s URL: https://api.snov.io/v2/domain-search/result/{task_hash}
Use this request to retrieve the search results generated by the previous request.
Input parameters: This request does not require any parameters. Add the “task_hash” to the URL or use the direct link provided in the previous response.
This request’s response contains:
- Company details (location, website, name, HQ phone number, industry, size, etc.).
- Contact counts by type (prospects, domain emails, generic contacts).
In the “links” field of the response, you’ll find direct URLs to search and filter contacts by type: “prospects”, “domain_emails”, “generic_contacts”. Use these URLs for your subsequent requests.
Search prospects by domain
Request’s type: POST
Request’s URL: https://api.snov.io/v2/domain-search/prospects/start?domain=
Use this endpoint to send a request to Snov.io API to search prospect profiles on the provided domain.
Input parameters:
In the "domain" field for this request, enter the domain name (company website) you want to search.
Use the "page" parameter to specify which page of results you want to search for prospects.
Pagination in API results: By default, any request without a "page" parameter automatically searches the first page of results. To search on another page, specify its number in the request’s parameters.
In the “positions” parameter, list the job titles you want to filter by, as an array (maximum 10). Put them within square brackets, separated by commas. For example: positions[]: [Developer, Product Manager, Software Engineer]
The response contains two key items:
- A unique “task_hash” that identifies your request. You’ll use it in the next request to get the search results.
- A direct URL for the next request (in the “result” field) to retrieve the search results.
Get prospects from domain
Request type: GET
Request URL: https://api.snov.io/v2/domain-search/prospects/result/{task_hash}
Use this request to retrieve the prospect search results generated by the previous request.
Input parameters: This request does not require any parameters. Add the "task_hash" to the URL or use the direct link provided in the previous response.
This request’s response contains:
The response provides details about the prospects found on the domain. Each prospect contains the following fields:
- "first_name"
- "last_name"
- "position"
- "source_page"
- "search_emails_start"
Pagination in API results: Each request returns results for one page. If you don’t specify a "page" parameter in your previous request, the first page is returned by default.
The "total_count" field shows the total number of prospects for the domain. If more pages are available, you’ll see a "next" field with the URL to retrieve the next page of results.
Important:
Email addresses are not included in this request's response. To find a prospect’s email address, use the URL provided in the "search_emails_start" field for that prospect. The link includes a unique "prospect_hash" for each prospect. Each prospect is queried with a separate request.
Search for prospect’s email address
Request’s type: POST
Request’s URL: https://api.snov.io/v2/domain-search/prospects/search-emails/start/{prospect_hash}
Use this request to find the email address of a prospect (returned in the results of the previous request Get prospects from domain).
Input parameters:
This request does not require any additional parameters. A unique "prospect_hash" (prospect-id) is automatically added to the URL, using the value from the "search_emails_start" field in the previous response.
The response contains two key items:
- A unique "task_hash" that identifies your request. You’ll use it in the next request to get the search results.
- A direct URL for the next request (in the “result” field) to check the search status and retrieve the prospect’s email address.
Get prospect’s email address
Request’s type: GET
Request’s URL: https://api.snov.io/v2/domain-search/prospects/search-emails/result/{task_hash}
Use this request to retrieve the email address for the prospect found in the previous request.
Input parameters:
This request does not require any additional parameters. A unique "task_hash" is automatically added to the URL, using the value from the previous response.
If the search is still running, the response will show “in_progress”. Once the search is "completed" and the email address is found, it will be included in the response.
This request’s response contains:
This request’s response includes the prospect’s email address and its verification status, which can be valid (green) or unknown (yellow). Learn more about email statuses.
Search emails by domain
Request’s type: POST
Request’s URL: https://api.snov.io/v2/domain-search/domain-emails/start?domain=
Use this endpoint to send a request to the Snovio API to search for domain emails on the provided domain.
A domain email is an unverified email address that belongs to a company’s domain. It could be an employee's email address or a generic email address.
Input parameters:
In the "domain" field for this request, enter the domain name (company website) you want to search.
The response contains two key items:
- A unique “task_hash” that identifies your request. You’ll use it in the next request to get the search results.
- A direct URL (in the “result” field) to retrieve the search results.
Get domain emails
Request type: GET
Request URL: https://api.snov.io/v2/domain-search/domain-emails/result/{task_hash}
Use this request to retrieve the email search results generated by the previous request.
Input parameters: This request does not require any parameters. Add the "task_hash" at the end of the URL or use the direct link provided in the previous response.
If the search is still running, the response will show "in_progress". Once the search is "completed", the email addresses will be included in the response.
This request’s response contains:
The response provides a list of email addresses found on the domain.
Pagination in API results: One request provides up to 50 emails (one page of results).The first page is returned by default.
The "total_count" field in the response shows the total number of emails available.If more pages are available, you’ll get the URL to retrieve the next page of results in the "next" field.
The "next" field in the response provides the URL that you can use to request the next page of results.
Search generic contacts by domain
Request’s type: POST
Request’s URL: https://api.snov.io/v2/domain-search/generic-contacts/start
Use this endpoint to send a request to the Snovio API to search for generic contacts on the provided domain.
A generic contact is an unverified email address for the company’s domain, often technical or service emails such as info@domain.com.
Input parameters:
In the "domain" field for this request, enter the domain name (company website) you want to search.
The response contains two key items:
- A unique "task_hash" that identifies your request. You’ll use it in the next request to get the search results.
- A direct URL (in the "result" field) to retrieve the search results.
Get generic contacts from domain
Request’s type: GET
Request’s URL: https://api.snov.io/v2/domain-search/generic-contacts/result/task_hash
Use this request to retrieve the search results generated by the previous request.
Input parameters: This request does not require any parameters. Add the "task_hash" at the end of the URL or use the direct link provided in the previous response.
If the search is still running, the response will show "in_progress". Once the search is "completed", the results will be included in the response.
This request’s response contains:
The response provides a list of generic email contacts found on the domain.
Pagination in API results: One request provides up to 50 contacts (one page of results).The first page is returned by default.
The "total_count" field in the response shows the total number of contacts available. If more pages are available, you’ll get the URL to retrieve the next page of results in the "next" field.
Domain Search API credit cost
Each POST type request to the Domain Search API will deduct one credit from your account quota.
The request won't deduct any credits in the following cases:
- The request does not provide any results (e.g., no company information, no prospects, or no emails in the response).
- The search request doesn’t find any verified (green or yellow) emails for a prospect.
| Request URL | Credit usage |
| https://api.snov.io/v2/domain-search | 1 credit for each request with type “POST”. |
| https://api.snov.io/v2/domain-search/prospects | 1 credit for each request with type “POST” (up to 20 prospect profiles without emails per request). |
| https://api.snov.io/v2/domain-search/domain-emails | 1 credit for each request with type “POST” (up to 50 unverified domain emails per request). |
| https://api.snov.io/v2/domain-search/generic-contacts | 1 credit for each request with type “POST” (up to 50 unverified generic contacts per request). |
| https://api.snov.io/v2/domain-search/prospects/search-emails | 1 credit for each prospect if a valid (green) or unknown (yellow) email is found. If no verified emails are found, no credits are charged. |
See complete technical information in our Domain Search API documentation.
Sorry about that 😢
How can we improve it?