Learn how to retrieve statistical data from your Snov.io account using API requests.
This guide explains two requests:
Let’s review their use cases and main parameters.
Get campaign analytics
Before making any API request, get “access_token” using the authentication request: https://api.snov.io/v1/oauth/access_token.
Request’s type: GET
Request’s URL: https://api.snov.io/v2/statistics/campaign-analytics
This request provides detailed analytics for your Snov.io campaigns. Use it to retrieve data on overall campaign’s sucess or filter results by campaigns, senders, team members, or time periods.
It also can help you generate reports automatically with data from your account and integrate your Snov.io KPIs into your reporting process.
Request’s parameters
All parameters in this request are optional. If no parameters are provided, the request will return all-time statistics for all campaigns and accounts.
To filter data in response, apply relevant filters in request’s parameters. See full parameters list in API documentation.
For example, use the “campaign_id” field in the request parameters to specify the IDs of the campaigns you want to retrieve statistics for. Add IDs for specific or multiple campaigns (separated by comma).
To find a campaign ID, open the relevant campaign in your campaigns list. The campaign ID is the number at the end of the URL in your browser’s address bar. (Example: in the campaign URL: https://app.snov.io/campaigns/2402609, the ID is “2402609”).
To retrieve data for specific team members, use the “campaign_owner” field. Enter the email addresses the team members use to join the team in Snov.io.
Find team members’ emails on the My Team page. “Campaign owner” filter is available if you are a team leader in Snov.io or have the “View team records” permission enabled.
Request’s result
The response includes all default metrics from your outreach in Snov.io, covering email and LinkedIn automation statistics.
The data for each metric returned in the results depends on the applied filters. If it contains zero (0) values, it means no data is available based on the request parameters. Adjust your request to access more campaign data.
General data fields: Total contacted prospects (via email or LinkedIn).
Email data fields: Contacted by email, emails sent, first emails, follow-ups, delivered, bounced, email opens, link clicks, email replies, unsubscribed, and auto-replied.
LinkedIn data fields: Contacted by LinkedIn, LinkedIn replies (for all types of messages), connection requests, failed connection requests, accepted requests, messages sent; LinkedIn views, follows, likes.
See full list of fields provided in the API response. The visual representation of this data can be found on the Reports dashboard in the Snov.io app.
View campaign progress
Before making any API request, get “access_token” using the authentication request: https://api.snov.io/v1/oauth/access_token.
Request’s type: GET
Request’s URL: https://api.snov.io/v2/campaigns/[campaign_id]/progress
Use this request to get data on how many recipients have completed the campaign, how many are still in progress, and how many have stopped due to specific reasons. This helps you track campaign progress and make adjustments as necessary.
Request’s parameters
This request requires one parameter: the campaign ID, a unique identifier for the campaign in your Snov.io account.
To find a campaign ID, open the relevant campaign in your campaigns list. The campaign ID is the number at the end of the URL in your browser’s address bar. (Example: in the campaign URL: https://app.snov.io/campaigns/2402609, the ID is “2402609”).
Use the “campaign_id” field in the request parameters to specify the campaign you want to see progress for. One request can provide data for one campaign. Make additional requests to get progress for more campaigns.
Request’s result
The “Progress” field in the response is shown as the percentage of prospects for whom the sequence of specified campaign was completed, or for whom the sequence was stopped. The reasons for stopping sequence include: the email bounced, prospects replied, auto-replied, or unsubscribed, were deleted from the campaign or moved to another prospect list.
See the full list of fields provided in the API response.
The “Unfinished” field in the response shows the number of recipients for whom the sequence is still in progress. These recipients haven’t reached the sequence’s end yet, and it hasn’t been stopped for them (due to reasons listed in the “Progress” field.)
The result also provides the current campaign “Status” at the time of the request. Learn more about possible campaign statuses in the knowledgebase article.