{"id":14628,"date":"2025-05-01T15:24:08","date_gmt":"2025-05-01T12:24:08","guid":{"rendered":"https:\/\/snov.io\/knowledgebase\/?p=14628"},"modified":"2025-08-29T14:34:46","modified_gmt":"2025-08-29T11:34:46","slug":"how-to-use-snov-io-api","status":"publish","type":"post","link":"https:\/\/snov.io\/knowledgebase\/how-to-use-snov-io-api\/","title":{"rendered":"How to use Snov.io tools via API"},"content":{"rendered":"<p class=\"whitespace-pre-wrap break-words\">Snov.io's tools are also available through our <a href=\"https:\/\/snov.io\/api\" target=\"_blank\" rel=\"noopener\">REST API<\/a>. It allows you to access our main functionality through simple API requests.<\/p>\n<p>You can use the API to automate the tasks that require manual work to find and verify prospects or routine actions in your account while managing your existing leads.<\/p>\n<p>Incorporate Snov.io features with other apps or tools you use to enhance your workflow or create custom automation.<\/p>\n<div class=\"notification-block note\">\n<div class=\"notification-block__icon\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/ph_circle-wavy-warning.svg\" alt=\"note\" width=\"32\" height=\"32\" \/><\/div>\n<div class=\"notification-block__text\">\n<p>Snov.io's APIs are fully available on all premium plans.<\/p>\n<p>If you're on a free plan, you can request a test access by emailing us at <a href=\"mailto:help@snov.io\">help@snov.io<\/a>. To get started, please tell us about your specific goal so we can better understand your needs and provide guidance.<\/p>\n<\/div>\n<\/div>\n<p class=\"whitespace-pre-wrap break-words\"><strong>Here's a comprehensive list of what you can do with the Snov.io API:<\/strong><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Get prospects with job titles and verified emails from our database<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Find emails and contacts from companies in the <strong>Domain Search API<\/strong><\/span><\/li>\n<li aria-level=\"1\">Enrich your existing data with our data in the <strong>Data Enrichment API<\/strong><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\">Automate your lead generation process via <strong>Email Finder API<\/strong><\/li>\n<li aria-level=\"1\">Integrate multistep verification to check the email quality via <strong>Email Verifier API<\/strong><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Automate tasks like creating lists, adding prospects or changing their status<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Retrieve analytics and campaign progress data to sync it with your reports<\/span><\/li>\n<li aria-level=\"1\">Set up webhooks to get automated notifications about events from your account<\/li>\n<\/ul>\n<h2 id=\"how\"><strong>How to get your API access token<\/strong><\/h2>\n<p>Before making any request to the Snov.io API, you'll need to authenticate it.<\/p>\n<p>Generate your <i>access_token <\/i>using\u00a0<a href=\"https:\/\/api.snov.io\/v1\/oauth\/access_token\" target=\"_blank\" rel=\"noopener\">the Authentication API request.<\/a> You can find your personal API credentials required for the access token in <a href=\"https:\/\/app.snov.io\/account\/api\" target=\"_blank\" rel=\"noopener\">your account settings<\/a>.<\/p>\n<p>Specify your token in the <strong>Authorization<\/strong> field to authenticate your requests. The access token lifespan is 1 hour (3600 seconds).<\/p>\n<h2><strong>How to test Snov.io API via Postman<\/strong><\/h2>\n<p><span style=\"font-weight: 400;\">The easiest way to see how Snov.io API works is to use an API testing tool.<\/span><\/p>\n<h3 id=\"signup\"><strong>Step 1. Log in to your account<\/strong><\/h3>\n<p><span style=\"font-weight: 400;\">We'll use <\/span><a href=\"https:\/\/www.postman.com\/\"><span style=\"font-weight: 400;\">Postman<\/span><\/a><span style=\"font-weight: 400;\"> because it's well-known, is relatively easy to use, and has a free version.<\/span><\/p>\n<p><a href=\"https:\/\/identity.getpostman.com\/signup\" rel=\"nofollow\"><span style=\"font-weight: 400;\">Sign up<\/span><\/a><span style=\"font-weight: 400;\"> with the Postman app on the official website and create your account.\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">In the <\/span><b>Home (1)<\/b><span style=\"font-weight: 400;\"> tab, click the <\/span><b>Send a request (2)<\/b><span style=\"font-weight: 400;\"> button to get to the API testing environment.<\/span><\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"shadow alignnone wp-image-14636 size-full\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/uploads\/2022\/05\/Postman-Home-Send-request-1-e1653393476711.png\" alt=\"\" width=\"900\" height=\"567\" \/><\/p>\n<h3 id=\"APItoken\"><strong>Step 2. Get your Snov.io API access token<\/strong><\/h3>\n<p><span style=\"font-weight: 400;\">Before making a request, you need to generate an <strong>API <\/strong><\/span><b>access token.\u00a0 <span style=\"font-weight: 400;\">You'll need it to authorize your requests as coming from your Snov.io account.<\/span><\/b><\/p>\n<p><a href=\"https:\/\/snov.io\/api#Authentification\"><span style=\"font-weight: 400;\">Access token API call<\/span><\/a><span style=\"font-weight: 400;\"> settings are the following:\u00a0<\/span><\/p>\n<ul>\n<li aria-level=\"1\"><b>(1) Type:<\/b><span style=\"font-weight: 400;\"> POST<\/span><\/li>\n<li aria-level=\"1\"><b>(2) Request URL:<\/b><span style=\"font-weight: 400;\"><a href=\"https:\/\/api.snov.io\/v1\/oauth\/access_token\"> https:\/\/api.snov.io\/v1\/oauth\/access_token<\/a><\/span><\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"shadow alignnone wp-image-14639 size-full\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/uploads\/2022\/05\/request-settings-pm-v2-1-e1653393712229.png\" alt=\"\" width=\"900\" height=\"503\" \/><\/p>\n<p><b>Input parameters<\/b><span style=\"font-weight: 400;\">:<\/span><\/p>\n<table style=\"height: 96px; width: 100%; border-collapse: collapse; border-style: outset; border-color: #000000;\" border=\"2\" cellspacing=\"1\" cellpadding=\"1\">\n<tbody>\n<tr style=\"height: 24px;\">\n<td style=\"width: 50%; height: 24px;\">Key<\/td>\n<td style=\"width: 50%; height: 24px;\">Value<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 50%; height: 24px;\"><span style=\"font-weight: 400;\">grant_type <strong>(1)<\/strong><\/span><\/td>\n<td style=\"width: 50%; height: 24px;\"><span style=\"font-weight: 400;\">client_credentials<\/span><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 50%; height: 24px;\"><span style=\"font-weight: 400;\">client_id <strong>(2)<\/strong><\/span><\/td>\n<td style=\"width: 50%; height: 24px;\"><span style=\"font-weight: 400;\">User ID you can find in the <\/span><a href=\"https:\/\/app.snov.io\/account#\/api\"><span style=\"font-weight: 400;\">account settings<\/span><\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 50%; height: 24px;\"><span style=\"font-weight: 400;\">client_secret <strong>(3)<\/strong><\/span><\/td>\n<td style=\"width: 50%; height: 24px;\"><span style=\"font-weight: 400;\">API Secret you can find in the <\/span><a href=\"https:\/\/app.snov.io\/account#\/api\"><span style=\"font-weight: 400;\">account settings<\/span><\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>&nbsp;<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"shadow alignnone wp-image-14640 size-full\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/uploads\/2022\/05\/Requst-params-1-e1653393799997.png\" alt=\"\" width=\"900\" height=\"258\" \/><\/p>\n<p><span style=\"font-weight: 400;\">After entering all the parameters, click the <\/span><b>Send (1) <\/b>button<span style=\"font-weight: 400;\">\u00a0and get your <\/span><b>Access token (2)<\/b><span style=\"font-weight: 400;\"> in the <\/span><b>Output\/Response<\/b><span style=\"font-weight: 400;\"> section.<\/span><\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"shadow alignnone wp-image-14641 size-full\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/uploads\/2022\/05\/Send-access-1-e1653393825867.png\" alt=\"\" width=\"900\" height=\"423\" \/><\/p>\n<h3><strong>Step 3: Authorize your request<\/strong><\/h3>\n<p><span style=\"font-weight: 400;\">In every request to Snov.io API, include your <i>access_token\u00a0<\/i> in the <\/span><b>Authorization<\/b><span style=\"font-weight: 400;\"> field.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">The a<\/span><span style=\"font-weight: 400;\">ccess token lifetime is equal to <\/span><b>3600 seconds<\/b><span style=\"font-weight: 400;\"> (1 hour) for security purposes. <\/span><span style=\"font-weight: 400;\">The token type is <\/span><b>Bearer<\/b><span style=\"font-weight: 400;\">.\u00a0<\/span><\/p>\n<h3 id=\"general\"><strong>Step 4. Add request parameters<\/strong><\/h3>\n<p><span style=\"font-weight: 400;\">Every request to Snov.io API consists of:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Request method \u2014 POST or GET <\/span><b>(1)<\/b><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">URL \u2014 HTTPS address of the request <\/span><b>(2)<\/b><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Input parameters \u2014 key and its value <\/span><b>(3)<\/b><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Output\/Response \u2014 requested data <\/span><span style=\"font-weight: 400;\">or a request completion response <\/span><b>(4)<\/b><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Refer to the <a href=\"https:\/\/snov.io\/api\" target=\"_blank\" rel=\"noopener\">API documentation<\/a> to see all available API requests, their parameters, credit cost and examples of provided data.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Choose a request you want to test and a<\/span>dd the parameters as specified in the documentation.<\/p>\n<p><span style=\"font-weight: 400;\">Here's where to enter API request parameters in Postman:<\/span><\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"shadow alignnone wp-image-14637 size-full\" src=\"https:\/\/snov.io\/knowledgebase\/wp-content\/uploads\/2022\/05\/Request-settings-POSTMAN-1-e1653393540895.png\" alt=\"\" width=\"900\" height=\"522\" \/><\/p>\n<p><span style=\"font-weight: 400;\">For <\/span><b>GET <\/b><span style=\"font-weight: 400;\">requests, enter Input parameters into the <\/span><b>Params <\/b><span style=\"font-weight: 400;\">tab. <\/span><\/p>\n<p><span style=\"font-weight: 400;\">For <\/span><b>POST <\/b><span style=\"font-weight: 400;\">requests, enter Input parameters to the <\/span><b>Body <\/b>tab <b>\u2192 <\/b>the <b>form-data<\/b><span style=\"font-weight: 400;\"> tab.<\/span><\/p>\n<div class=\"notification-block note-gray\">\n<div class=\"notification-block__text\">\n<h3><strong>Related articles<\/strong><\/h3>\n<p><a href=\"https:\/\/snov.io\/knowledgebase\/how-to-use-domain-search-api\/\" target=\"_blank\" rel=\"noopener\">How to find contacts from domains in Domain Search API<\/a><\/p>\n<p><a href=\"https:\/\/snov.io\/knowledgebase\/how-to-enrich-your-data-via-snov-io-api\/\" target=\"_blank\" rel=\"noopener\">How to enrich your data via API<\/a><\/p>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Snov.io&#8217;s tools are also available through our REST API. It allows you to access our main functionality through simple API requests. You can use the API to automate the tasks that require manual work to find and verify prospects or routine actions in your account while managing your existing leads. Incorporate Snov.io features with other [&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\/14628"}],"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=14628"}],"version-history":[{"count":22,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/14628\/revisions"}],"predecessor-version":[{"id":41985,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/14628\/revisions\/41985"}],"wp:attachment":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/media?parent=14628"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/categories?post=14628"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/tags?post=14628"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}