{"id":36237,"date":"2024-02-03T10:38:24","date_gmt":"2024-02-03T07:38:24","guid":{"rendered":"https:\/\/snov.io\/knowledgebase\/?p=36237"},"modified":"2025-08-26T10:03:12","modified_gmt":"2025-08-26T07:03:12","slug":"how-to-use-domain-search-api","status":"publish","type":"post","link":"https:\/\/snov.io\/knowledgebase\/how-to-use-domain-search-api\/","title":{"rendered":"How to find domain contacts in Domain Search API"},"content":{"rendered":"<p><span style=\"font-weight: 400;\">This article describes Snovio\u2019s <\/span><a href=\"https:\/\/snov.io\/api#DomainSearch2\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Domain Search API<\/span><\/a><span style=\"font-weight: 400;\"> and<\/span> <span style=\"font-weight: 400;\">how to make API requests to get domain contacts.<\/span><\/p>\n<div class=\"notification-block note-gray\">\n<div class=\"notification-block__text\">\n<p><span style=\"font-weight: 400;\">This is the API version of the <\/span><a href=\"https:\/\/app.snov.io\/domain-search\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Domain Search<\/span><\/a><span style=\"font-weight: 400;\"> 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.<\/span><\/p>\n<\/div>\n<\/div>\n<p><a href=\"#request-company-info-api\">Domain Search (request company info)<\/a><\/p>\n<p><a href=\"#get-company-info-api\">Domain Search (get company info)<\/a><\/p>\n<p><a href=\"#search-prospects-by-domain\">Search prospects by domain<\/a><\/p>\n<p><a href=\"#get-prospects-from-domain\">Get prospects from the domain<\/a><\/p>\n<p><a href=\"#search-prospects-email\">Search for prospect's email address<\/a><\/p>\n<p><a href=\"#get-prospects-email\">Get prospect\u2019s email address<\/a><\/p>\n<p><a href=\"#search-emails-by-domain\">Search emails by domain<\/a><\/p>\n<p><a href=\"#get-domain-emails\">Get domain emails<\/a><\/p>\n<p><span style=\"font-weight: 400;\">Let\u2019s review the endpoints available in the Domain Search API, their purpose within the overall workflow, and look at their main parameters.<\/span><\/p>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\"><span style=\"font-weight: 400;\">Before making any request to Snov.io, use <\/span><a href=\"https:\/\/api.snov.io\/v1\/oauth\/access_token\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">the authentication endpoint<\/span><\/a><span style=\"font-weight: 400;\"> to get the <\/span><i><span style=\"font-weight: 400;\">access_token<\/span><\/i><span style=\"font-weight: 400;\">. Use it as a <em>bearer<\/em> type token for your next requests. The <em>access_token<\/em> lifespan is 1 hour (3600 seconds).<\/span><\/div>\n<\/div>\n<h2 id=\"request-company-info-api\"><strong>Domain Search (request company info)<\/strong><\/h2>\n<p><b>Request\u2019s type: <\/b><span style=\"font-weight: 400;\">POST<\/span><\/p>\n<p><b>Request\u2019s URL: <\/b><a href=\"https:\/\/api.snov.io\/v2\/domain-search\/start\/\"><span style=\"font-weight: 400;\">https:\/\/api.snov.io\/v2\/domain-search\/start<\/span><span style=\"font-weight: 400;\">\/<\/span><\/a><\/p>\n<p>This is a base endpoint that sends a request to the Snov.io API to search for company information using a provided domain.<\/p>\n<p><b>Input parameters:<\/b><span style=\"font-weight: 400;\">\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">In the <\/span><b>\"domain\" <\/b><span style=\"font-weight: 400;\">field for this request,<\/span> <span style=\"font-weight: 400;\">enter the domain name (company website) you want to search.<\/span><\/p>\n<p><strong>The response contains two key items:<\/strong><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A unique <strong>\"task_hash\" <\/strong>that identifies your request. You\u2019ll use it in the next request to get the search results.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A direct URL (in the <strong>\"result\"<\/strong>\u00a0field) to retrieve the search results (get company information).<\/span><\/li>\n<\/ul>\n<h2 id=\"get-company-info-api\"><strong>Domain Search (get company info)<\/strong><\/h2>\n<p><b>Request\u2019s type: <\/b><span style=\"font-weight: 400;\">GET<\/span><\/p>\n<p><b>Request\u2019s URL:<\/b> <a href=\"https:\/\/api.snov.io\/v2\/domain-search\/result\/f8561e15032474388d67f5b60233477c\"><span style=\"font-weight: 400;\">https:\/\/api.snov.io\/v2\/domain-search\/result\/<\/span><\/a><span style=\"font-weight: 400;\">{task_hash}<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Use this request to retrieve the search results generated by the previous request.<\/span><\/p>\n<p><b>Input parameters: <\/b><span style=\"font-weight: 400;\">This request does not require any parameters. Add the <strong>\u201ctask_hash\u201d<\/strong> to the URL or use the direct link provided in the previous response.<\/span><\/p>\n<p><strong>This request\u2019s response contains:<\/strong><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Company details<\/b><span style=\"font-weight: 400;\"> (location, website, name, HQ phone number, industry, size, etc.).<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Contact counts<\/b><span style=\"font-weight: 400;\"> by type (prospects, domain emails, generic contacts).<\/span><\/li>\n<\/ul>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<p>In the <strong>\u201clinks\u201d<\/strong> field of the response, you\u2019ll find direct URLs to search and filter contacts by type: <strong>\u201cprospects\u201d<\/strong>, <strong>\u201cdomain_emails\u201d<\/strong>, <strong>\u201cgeneric_contacts\u201d<\/strong>. Use these URLs for your subsequent requests.<\/p>\n<\/div>\n<\/div>\n<h2 id=\"search-prospects-by-domain\"><strong>Search prospects by domain<\/strong><\/h2>\n<p><b>Request\u2019s type: <\/b><span style=\"font-weight: 400;\">POST<\/span><\/p>\n<p><b>Request\u2019s URL:<\/b> <a href=\"https:\/\/api.snov.io\/v2\/domain-search\/prospects\/start?domain=\"><span style=\"font-weight: 400;\">https:\/\/api.snov.io\/v2\/domain-search\/prospects\/start?domain=<\/span><\/a><\/p>\n<p><span style=\"font-weight: 400;\">Use this endpoint to send a request to Snov.io API to search prospect profiles on the provided domain.<\/span><\/p>\n<p><b>Input parameters:<\/b><\/p>\n<p><span style=\"font-weight: 400;\">In the <\/span><b>\"domain\" <\/b><span style=\"font-weight: 400;\">field for this request,<\/span> <span style=\"font-weight: 400;\">enter the domain name (company website) you want to search.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Use the <strong>\"<\/strong><\/span><b>page\"<\/b><span style=\"font-weight: 400;\">\u00a0parameter to specify which page of results you want to search for prospects.<\/span><\/p>\n<p><b>Pagination in API results:<\/b><span style=\"font-weight: 400;\"> By default, any request without a <strong>\"page\"<\/strong> parameter automatically searches the first page of results. To search on another page, specify its number in the request\u2019s parameters.<\/span><\/p>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<p>In the <strong>\u201cpositions\u201d<\/strong> 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: <em>positions[]: [Developer, Product Manager, Software Engineer]<\/em><\/p>\n<\/div>\n<\/div>\n<p><strong>The response contains two key items:<\/strong><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A unique <\/span><b>\u201ctask_hash\u201d<\/b><span style=\"font-weight: 400;\"> that identifies your request. You\u2019ll use it in the next request to get the search results.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A direct URL for the next request (in the <\/span><b>\u201cresult\u201d<\/b><span style=\"font-weight: 400;\"> field) to retrieve the search results.<\/span><\/li>\n<\/ul>\n<h2 id=\"get-prospects-from-domain\"><strong>Get prospects from domain<\/strong><\/h2>\n<p><b>Request type:<\/b><span style=\"font-weight: 400;\"> GET<\/span><\/p>\n<p><b>Request URL: <\/b><a href=\"https:\/\/api.snov.io\/v2\/domain-search\/prospects\/result\"><span style=\"font-weight: 400;\">https:\/\/api.snov.io\/v2\/domain-search\/prospects\/result<\/span><\/a><span style=\"font-weight: 400;\">\/{task_hash}<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Use this request to retrieve the prospect search results generated by the previous request.<\/span><\/p>\n<p><b>Input parameters: <\/b><span style=\"font-weight: 400;\">This request does not require any parameters. Add the <strong>\"task_hash\"<\/strong> to the URL or use the direct link provided in the previous response.<\/span><\/p>\n<p><strong>This request\u2019s response contains:<\/strong><\/p>\n<p><span style=\"font-weight: 400;\">The response provides details about the prospects found on the domain. Each <\/span><b>prospect<\/b><span style=\"font-weight: 400;\"> contains the following fields:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>\"first_name\"<\/b><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>\"last_name\"<\/b><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>\"position\"<\/b><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>\"source_page\"<\/b><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>\"search_emails_start\"<\/b><\/li>\n<\/ul>\n<p><b>Pagination in API results: <\/b><span style=\"font-weight: 400;\">Each request returns results for one page. If you don\u2019t specify a <strong>\"<\/strong><\/span><b>page\"<\/b><span style=\"font-weight: 400;\"> parameter in your previous request, the first page is returned by default.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">The <strong>\"<\/strong><\/span><b>total_count\"<\/b><span style=\"font-weight: 400;\"> field shows the total number of prospects for the domain. If more pages are available, you\u2019ll see a <strong>\"<\/strong><\/span><b>next\"<\/b><span style=\"font-weight: 400;\"> field with the URL to retrieve the next page of results.<\/span><\/p>\n<div class=\"notification-block tip\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/academicons_ideas-repec.svg\" alt=\"tip\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<p><strong>Important:<\/strong><\/p>\n<p>Email addresses are not included in this request's response. To find a prospect\u2019s email address, use the URL provided in the <strong>\"search_emails_start\"<\/strong> field for that prospect. The link includes a unique \"prospect_hash\"\u00a0for each prospect. Each prospect is queried with a separate request.<\/p>\n<\/div>\n<\/div>\n<h2 id=\"search-prospects-email\"><strong>Search for prospect\u2019s email address<\/strong><\/h2>\n<p><b>Request\u2019s type: <\/b><span style=\"font-weight: 400;\">POST<\/span><\/p>\n<p><b>Request\u2019s URL:<\/b> <a href=\"https:\/\/api.snov.io\/v2\/domain-search\/prospects\/search-emails\/start\/%7Bprospect_hash\"><span style=\"font-weight: 400;\">https:\/\/api.snov.io\/<\/span><span style=\"font-weight: 400;\">v2\/domain-search\/prospects\/search-emails\/start\/<\/span><\/a><span style=\"font-weight: 400;\">{prospect_hash}<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Use this request to find the email address of a prospect (returned in the results of the previous request <\/span><b>Get prospects from domain<\/b><span style=\"font-weight: 400;\">).<\/span><\/p>\n<p><b>Input parameters:<\/b><\/p>\n<p><span style=\"font-weight: 400;\">This request does not require any additional parameters. A unique <\/span><strong>\"prospect_hash\" <\/strong>(prospect-id) <span style=\"font-weight: 400;\">is automatically added to the URL, using the value from the <strong>\"search_emails_start\"<\/strong><\/span><span style=\"font-weight: 400;\">\u00a0field in the previous response.<\/span><\/p>\n<p><strong>The response contains two key items:<\/strong><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A unique <strong>\"<\/strong><\/span><b>task_hash\"<\/b><span style=\"font-weight: 400;\">\u00a0that identifies your request. You\u2019ll use it in the next request to get the search results.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A direct URL for the next request (in the <\/span><b>\u201cresult\u201d<\/b><span style=\"font-weight: 400;\"> field) to check the search status and retrieve the prospect\u2019s email address.<\/span><\/li>\n<\/ul>\n<h2 id=\"get-prospects-email\"><strong>Get prospect\u2019s email address<\/strong><\/h2>\n<p><b>Request\u2019s type: <\/b><span style=\"font-weight: 400;\">GET<\/span><\/p>\n<p><b>Request\u2019s URL: <\/b><a href=\"https:\/\/api.snov.io\/v2\/domain-search\/prospects\/search-emails\/result\/\"><span style=\"font-weight: 400;\">https:\/\/api.snov.io\/v2\/domain-search\/prospects\/search-emails\/result\/<\/span><\/a><span style=\"font-weight: 400;\">{task_hash}<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Use this request to <\/span>retrieve the email address<span style=\"font-weight: 400;\"> for the prospect found in the previous request.<\/span><\/p>\n<p><b>Input parameters<\/b><span style=\"font-weight: 400;\">:<\/span><\/p>\n<p><span style=\"font-weight: 400;\">This request does not require any additional parameters. A unique<\/span> <strong>\"task_hash\"<\/strong> <span style=\"font-weight: 400;\">is automatically added to the URL, using the value from the previous response.<\/span><\/p>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<p>If the search is still running, the response will show \u201cin_progress\u201d. Once the search is \"completed\" and the email address is found, it will be included in the response.<\/p>\n<\/div>\n<\/div>\n<p><strong>This request\u2019s response contains:<\/strong><\/p>\n<p><span style=\"font-weight: 400;\">This request\u2019s response includes the prospect\u2019s email address and its verification status, which can be <\/span><span style=\"font-weight: 400;\">valid<\/span><span style=\"font-weight: 400;\"> (green) or <\/span><span style=\"font-weight: 400;\">unknown<\/span><span style=\"font-weight: 400;\"> (yellow). <\/span><a href=\"https:\/\/snov.io\/knowledgebase\/email-statuses\/\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Learn more about email statuses.<\/span><\/a><\/p>\n<h2 id=\"search-emails-by-domain\"><strong>Search emails by domain<\/strong><\/h2>\n<p><b>Request\u2019s type: <\/b><span style=\"font-weight: 400;\">POST<\/span><\/p>\n<p><b>Request\u2019s URL:<\/b> <a href=\"https:\/\/api.snov.io\/v2\/domain-search\/domain-emails\/start?domain=snov.io\"><span style=\"font-weight: 400;\">https:\/\/api.snov.io\/v2\/domain-search\/domain-emails\/start?domain=<\/span><\/a><\/p>\n<p><span style=\"font-weight: 400;\">Use this endpoint to send a request to the Snovio API to search for domain emails on the provided domain.<\/span><\/p>\n<div class=\"notification-block note-gray\">\n<div class=\"notification-block__text\">\n<p>A domain email is an unverified email address that belongs to a company\u2019s domain. It could be an employee's email address or a generic email address.<\/p>\n<\/div>\n<\/div>\n<p><b>Input parameters:<\/b><\/p>\n<p><span style=\"font-weight: 400;\">In the <\/span><b>\"domain\" <\/b><span style=\"font-weight: 400;\">field for this request,<\/span> <span style=\"font-weight: 400;\">enter the domain name (company website) you want to search.<\/span><\/p>\n<p><b>The response contains two key items:<\/b><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A unique <\/span><b>\u201ctask_hash\u201d<\/b><span style=\"font-weight: 400;\"> that identifies your request. You\u2019ll use it in the next request to get the search results.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A direct URL (in the <\/span><b>\u201cresult\u201d<\/b><span style=\"font-weight: 400;\"> field) to retrieve the search results.<\/span><\/li>\n<\/ul>\n<h2 id=\"get-domain-emails\"><strong>Get domain emails<\/strong><\/h2>\n<p><b>Request type:<\/b><span style=\"font-weight: 400;\"> GET<\/span><\/p>\n<p><b>Request URL:<\/b> <a href=\"https:\/\/api.snov.io\/v2\/domain-search\/domain-emails\/result\/\"><span style=\"font-weight: 400;\">https:\/\/api.snov.io\/v2\/domain-search\/domain-emails\/result\/<\/span><\/a><span style=\"font-weight: 400;\">{task_hash}<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Use this request to retrieve the email search results generated by the previous request.<\/span><\/p>\n<p><b>Input parameters<\/b><span style=\"font-weight: 400;\">: This request does not require any parameters. Add the <strong>\"<\/strong><\/span><b>task_hash\"<\/b><span style=\"font-weight: 400;\">\u00a0at the end of the URL or use the direct link provided in the previous response.<\/span><\/p>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<p>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.<\/p>\n<\/div>\n<\/div>\n<p><strong>This request\u2019s response contains:<\/strong><\/p>\n<p><span style=\"font-weight: 400;\">The response provides a list of email addresses found on the domain.<\/span><\/p>\n<div class=\"notification-block note-gray\">\n<div class=\"notification-block__text\">\n<p>Pagination in API results: One request provides up to 50 emails (one page of results).The first page is returned by default.<\/p>\n<\/div>\n<\/div>\n<p><span style=\"font-weight: 400;\">The <strong>\"<\/strong><\/span><b>total_count\"<\/b><span style=\"font-weight: 400;\"> field in the response shows the total number of emails available.If more pages are available, you\u2019ll get the URL to retrieve the next page of results in the <strong>\"<\/strong><b>next\"<\/b><\/span><span style=\"font-weight: 400;\">\u00a0field.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">The <strong>\"<\/strong><\/span><b>next\"<\/b><span style=\"font-weight: 400;\">\u00a0field in the response provides the URL that you can use to request the next page of results.<\/span><\/p>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\"><b>Note:<\/b><span style=\"font-weight: 400;\"> The email verification status is not included in this response. To verify domain emails, use the<\/span><a href=\"https:\/\/snov.io\/api#EmailVerifier\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\"> Email Verifier API<\/span><\/a><span style=\"font-weight: 400;\">.<\/span><\/div>\n<\/div>\n<h2><strong>Search generic contacts by domain<\/strong><\/h2>\n<p><b>Request\u2019s type: <\/b><span style=\"font-weight: 400;\">POST<\/span><\/p>\n<p><b>Request\u2019s URL:<\/b> <a href=\"https:\/\/api.snov.io\/v2\/domain-search\/generic-contacts\/start\"><span style=\"font-weight: 400;\">https:\/\/api.snov.io\/v2\/domain-search\/generic-contacts\/start<\/span><\/a><\/p>\n<p><span style=\"font-weight: 400;\">Use this endpoint to send a request to the Snovio API to search for generic contacts on the provided domain.<\/span><\/p>\n<div class=\"notification-block note-gray\">\n<div class=\"notification-block__text\">\n<p>A generic contact is an unverified email address for the company\u2019s domain, often technical or service emails such as info@domain.com.<\/p>\n<\/div>\n<\/div>\n<p><b>Input parameters:<\/b><\/p>\n<p><span style=\"font-weight: 400;\">In the <\/span><b>\"domain\" <\/b><span style=\"font-weight: 400;\">field for this request,<\/span> <span style=\"font-weight: 400;\">enter the domain name (company website) you want to search.<\/span><\/p>\n<p><strong>The response contains two key items:<\/strong><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A unique <strong>\"<\/strong><\/span><b>task_hash\"<\/b><span style=\"font-weight: 400;\">\u00a0that identifies your request. You\u2019ll use it in the next request to get the search results.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A direct URL (in the <strong>\"<\/strong><\/span><b>result\"<\/b><span style=\"font-weight: 400;\">\u00a0field) to retrieve the search results.<\/span><\/li>\n<\/ul>\n<h2><strong>Get generic contacts from domain<\/strong><\/h2>\n<p><b>Request\u2019s type: <\/b><span style=\"font-weight: 400;\">GET<\/span><\/p>\n<p><b>Request\u2019s URL:<\/b> <a href=\"https:\/\/api.snov.io\/v2\/domain-search\/generic-contacts\/result\/\"><span style=\"font-weight: 400;\">https:\/\/api.snov.io\/v2\/domain-search\/generic-contacts\/result\/<\/span><\/a><span style=\"font-weight: 400;\">task_hash<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Use this request to retrieve the search results generated by the previous request.<\/span><\/p>\n<p><b>Input parameters<\/b><span style=\"font-weight: 400;\">: This request does not require any parameters. Add the <strong>\"<\/strong><\/span><b>task_hash\"<\/b><span style=\"font-weight: 400;\"> at the end of the URL or use the direct link provided in the previous response.<\/span><\/p>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<p>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.<\/p>\n<\/div>\n<\/div>\n<p><strong>This request\u2019s response contains:<\/strong><\/p>\n<p><span style=\"font-weight: 400;\">The response provides a list of generic email contacts found on the domain.\u00a0<\/span><\/p>\n<div class=\"notification-block note-gray\">\n<div class=\"notification-block__text\">\n<p>Pagination in API results: One request provides up to 50 contacts (one page of results).The first page is returned by default.<\/p>\n<\/div>\n<\/div>\n<p><span style=\"font-weight: 400;\">The <strong>\"<\/strong><\/span><b>total_count\"<\/b><span style=\"font-weight: 400;\"> field in the response shows the total number of contacts available. If more pages are available, you\u2019ll get the URL to retrieve the next page of results in the <strong>\"<\/strong><\/span><b>next\"<\/b><span style=\"font-weight: 400;\">\u00a0field.<\/span><\/p>\n<div class=\"notification-block learn\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\" alt=\"learn\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\"><b>Note:<\/b><span style=\"font-weight: 400;\"> The email verification status is not included in this response. To verify domain emails, use the<\/span> <a href=\"https:\/\/snov.io\/api#EmailVerifier\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Email Verifier API<\/span><\/a><span style=\"font-weight: 400;\">.<\/span><\/div>\n<\/div>\n<h2><strong>Domain Search API credit cost<\/strong><\/h2>\n<p><span style=\"font-weight: 400;\">Each <\/span><b>POST <\/b><span style=\"font-weight: 400;\">type request to the Domain Search API will deduct one credit from <\/span><a href=\"https:\/\/app.snov.io\/account\/billing\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">your account quota<\/span><\/a><span style=\"font-weight: 400;\">.<\/span><\/p>\n<p>The request won't deduct any credits in the following cases:<\/p>\n<ol>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">The request does not provide any results (e.g., no company information, no prospects, or no emails in the response).<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">The search request doesn\u2019t find any verified (green or yellow) emails for a prospect.<\/span><\/li>\n<\/ol>\n<table style=\"border-color: #a8a8a8; width: 100%;\" border=\"1\">\n<tbody>\n<tr>\n<td style=\"width: 47.5028%;\"><strong>Request URL<\/strong><\/td>\n<td style=\"width: 51.6093%;\"><strong>Credit usage<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"width: 47.5028%;\"><span style=\"font-weight: 400;\"><strong>Domain Search (request company info): <\/strong>https:\/\/api.snov.io\/v2\/domain-search<\/span><\/td>\n<td style=\"width: 51.6093%;\"><span style=\"font-weight: 400;\">1 credit for each request with type <\/span><b>\u201cPOST\u201d<\/b><span style=\"font-weight: 400;\">.<\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"width: 47.5028%;\"><strong>Search prospects by domain: <\/strong><span style=\"font-weight: 400;\">https:\/\/api.snov.io\/v2\/domain-search\/prospects<\/span><\/td>\n<td style=\"width: 51.6093%;\"><span style=\"font-weight: 400;\">1 credit for each request with type <\/span><b>\u201cPOST\u201d<\/b><span style=\"font-weight: 400;\"> (up to 20 prospect profiles without emails per request).<\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"width: 47.5028%;\"><span style=\"font-weight: 400;\"><strong>Search emails by domain:<\/strong><br \/>\nhttps:\/\/api.snov.io\/v2\/domain-search\/domain-emails<\/span><\/td>\n<td style=\"width: 51.6093%;\"><span style=\"font-weight: 400;\">1 credit for each request with type <\/span><b>\u201cPOST\u201d<\/b><span style=\"font-weight: 400;\"> (up to 50 unverified domain emails per request).<\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"width: 47.5028%;\"><strong>Search generic contacts by domain:<\/strong><\/p>\n<p><span style=\"font-weight: 400;\">https:\/\/api.snov.io\/v2\/domain-search\/generic-contacts<\/span><\/td>\n<td style=\"width: 51.6093%;\"><span style=\"font-weight: 400;\">1 credit for each request with type <\/span><b>\u201cPOST\u201d<\/b><span style=\"font-weight: 400;\"> (up to 50 unverified generic contacts per request).<\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"width: 47.5028%;\"><span style=\"font-weight: 400;\"><strong>Search for prospect\u2019s email address:<\/strong><br \/>\nhttps:\/\/api.snov.io\/v2\/domain-search\/prospects\/search-emails<\/span><\/td>\n<td style=\"width: 51.6093%;\"><span style=\"font-weight: 400;\">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.<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>See complete technical information in our <a href=\"https:\/\/snov.io\/api#DomainSearch2\" target=\"_blank\" rel=\"noopener\">Domain Search API documentation<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This article describes Snovio\u2019s Domain Search API and how to make API requests to get domain contacts. 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 [&hellip;]<\/p>\n","protected":false},"author":16,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1986],"tags":[],"_links":{"self":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/36237"}],"collection":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/users\/16"}],"replies":[{"embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/comments?post=36237"}],"version-history":[{"count":20,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/36237\/revisions"}],"predecessor-version":[{"id":41905,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/36237\/revisions\/41905"}],"wp:attachment":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/media?parent=36237"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/categories?post=36237"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/tags?post=36237"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}