How to use Database Search API

This guide explains how to find prospects and companies from the Database Search API.

Database Search API methods

• Search for prospects
• Find a prospect's email
• Search for companies
• Add prospects to a list

The Database Search API is one of several API categories available to automate your work in Snov.io.

The Database Search API lets you access the same prospect and company database behind Database Search in the app.

Use it to find prospects and companies through API requests.

Checking how many prospects are available is free, and you spend credits only when you find a verified email and full profile. The API returns the same data you'd see in the app.

Database Search API methods

Here are the API methods broken down by workflow stage:

Search for prospects

These methods search Snov.io's prospect database using your filters.

Start a prospect search

Send your filters to start a prospect search. You'll get a task hash to retrieve the results in the next step.

Required input:
At least one filter. filters
Filter your search down to the prospects who fit your ICP. You can combine prospect-level and company-level filters in the same request:

• Prospect filters: job title, management level, department, skills, location, first and last name
• Company filters: name, location, industry, size, revenue range, specialties, founded year

Job title filters recognize common variations, so "CEO" also matches "Chief Executive Officer." Location filters match Snov.io's verified location list; if nothing matches, the API returns up to 15 similar options instead of an empty result.

Get prospect search results

Retrieve the prospects that matched your filters.

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.

Required input:
task_hash — the task hash from your search request, in the URL

Results come paginated, with up to 20 prospects per page. You get page 1 by default; change the page number to get results from later pages. The total count shows how many prospects and pages match your filters.

Find a prospect's email

These methods get a prospect's email address, full last name, and full LinkedIn URL.

Start the email search

Request the hidden contact details for a prospect you found: use their email_and_hidden_info_reveal URL to get the email address, full last name, and full LinkedIn URL.

Required input:
task_hash — the prospect's task hash, in the URL

Get the email search results

Get the prospect's email address and their full profile details.

The response includes the prospect's full name, LinkedIn URL, and email address with its status (valid or unknown).

Required input:
task_hash — the task hash from the previous request, in the URL

Search for companies

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.

Start a company search

Send your filters to start a company search.

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.

Required input:
At least one filter. filters

Get company search results

Retrieve the companies that matched your filters.

Each company in the response includes its domain, location, industry, size, revenue range, and logo.

Required input:
task_hash — the task hash from your search request, in the URL

You're charged 1 credit for each unique request, and only if the results include at least one company.

Add prospects to a list

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.

Next steps in API

Run outreach campaigns

Build and launch multichannel outreach sequences for the prospects you found. See the Campaigns API.

Database Search 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 the Database Search API.