Database Search API methods<\/a><\/p>\n The Database Search API<\/a> lets you access the same prospect and company database behind Database Search in the app<\/a>.<\/p>\n Use it to find prospects and companies through API requests.<\/p>\n Here are the API methods broken down by workflow stage:<\/p>\n These methods search Snov.io's prospect database using your filters.<\/p>\n Send your filters to start a prospect search. You'll get a task hash to retrieve the results in the next step.<\/p>\n Required input:<\/strong><\/strong> Retrieve the prospects that matched your filters.<\/p>\n Each prospect in the response includes their job title, location, industry, and company details. The last name and LinkedIn URL are partially hidden until you start an email search.<\/p>\n Required input:<\/strong><\/strong> These methods get a prospect's email address, full last name, and full LinkedIn URL.<\/p>\n Request the hidden contact details for a prospect you found: use their Required input:<\/strong><\/strong> Get the prospect's email address and their full profile details.<\/p>\n The response includes the prospect's full name, LinkedIn URL, and email address with its status (valid or unknown).<\/p>\n Required input:<\/strong><\/strong> These methods search Snov.io's company database. Use company search to build a target account list before you search for people inside those accounts.<\/p>\n Send your filters to start a company search.<\/p>\n You'll get a task hash to retrieve the results in the next step. Filters cover company name, location, industry, size, revenue, specialties, and founded year.<\/p>\n Required input:<\/strong><\/strong> Retrieve the companies that matched your filters.<\/p>\n Each company in the response includes its domain, location, industry, size, revenue range, and logo.<\/p>\n Required input:<\/strong><\/strong> Once you've found the emails you want, add those prospects to a Snov.io list with this method. Then launch an outreach campaign the same way you would with prospects added through the app.<\/p>\n Build and launch multichannel outreach sequences for the prospects you found. See the Campaigns API<\/a>.<\/p>\n In the table below, we'll provide details on how Snov.io charges credits from <\/span>your account balance<\/span><\/a> when using requests for the Database Search API.<\/span><\/p>\n\n
![\"note\"](\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/ph_circle-wavy-warning.svg\")
<\/div>\n<\/div>\nDatabase Search API methods<\/strong><\/h2>\n
Search for prospects<\/strong><\/h2>\n
Start a prospect search<\/strong><\/h3>\n
\nAt least one filter. filters<\/code><\/span>
\nFilter your search down to the prospects who fit your ICP. You can combine prospect-level and company-level filters in the same request:<\/p>\n\n
![\"tip\"](\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/academicons_ideas-repec.svg\")
<\/div>\nGet prospect search results<\/strong><\/h3>\n
\ntask_hash<\/code><\/span> \u2014 the task hash from your search request, in the URL<\/p>\n![\"learn\"](\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\")
<\/div>\nFind a prospect's email<\/strong><\/h2>\n
Start the email search<\/strong><\/h3>\n
email_and_hidden_info_reveal<\/code><\/span> URL to get the email address, full last name, and full LinkedIn URL.<\/p>\n
\ntask_hash<\/code><\/span> \u2014 the prospect's task hash, in the URL<\/p>\nGet the email search results<\/strong><\/h3>\n
\ntask_hash<\/code><\/span> \u2014 the task hash from the previous request, in the URL<\/p>\nSearch for companies<\/strong><\/h2>\n
Start a company search<\/strong><\/h3>\n
\nAt least one filter. filters<\/code><\/span><\/p>\nGet company search results<\/strong><\/h3>\n
\ntask_hash<\/code><\/span> \u2014 the task hash from your search request, in the URL<\/p>\n<\/div>\nAdd prospects to a list<\/strong><\/h3>\n
Next steps in API<\/strong><\/h2>\n
Run outreach campaigns<\/strong><\/h3>\n
Database Search API credit cost<\/strong><\/h2>\n
\n\n
\n \nMethod<\/td>\n API request<\/td>\n Credits<\/td>\n<\/tr>\n<\/thead>\n \n Start a prospect search<\/td>\n https:\/\/api.snov.io\/v2\/database-search\/prospects\/start<\/span><\/a><\/td>\n Free.<\/span><\/td>\n<\/tr>\n \n Get prospect search results<\/td>\n https:\/\/api.snov.io\/v2\/database-search\/prospects\/result\/{task_hash}<\/span><\/a><\/td>\n Free.<\/span><\/td>\n<\/tr>\n \n Start the email search<\/td>\n https:\/\/api.snov.io\/v2\/database-search\/prospects\/search-emails\/start\/{task_hash}<\/span><\/a><\/td>\n Free.<\/span><\/td>\n<\/tr>\n \n Get the email search results<\/td>\n https:\/\/api.snov.io\/v2\/database-search\/prospects\/search-emails\/result\/{task_hash}<\/span><\/a><\/td>\n 1 credit<\/strong> for each prospect for which we find a valid<\/em> or unverifiable<\/em> email address. If no email is found, we don't charge credits for it.<\/span><\/td>\n<\/tr>\n \n Start a company search<\/td>\n https:\/\/api.snov.io\/v2\/database-search\/companies\/start<\/span><\/a><\/td>\n Free.<\/span><\/td>\n<\/tr>\n \n Get company search results<\/td>\n https:\/\/api.snov.io\/v2\/database-search\/companies\/result\/{task_hash}<\/span><\/a><\/td>\n 1 credit<\/strong> for each unique request in which we return at least one company. If no companies match, we don't charge credits for it.<\/span><\/td>\n<\/tr>\n \n Add prospects to a list<\/td>\n https:\/\/api.snov.io\/v1\/add-prospect-to-list<\/span><\/a><\/td>\n Free.<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n