How to get campaign analytics via API

This guide covers how to retrieve campaign metrics and recipient engagement using the Snov.io API.

The Snov.io Analytics and reporting API provides access to outreach performance data. Retrieve campaign progress, engagement metrics, and recipient activity across email and LinkedIn.

What you can do with this API:

1) Monitor campaign results throughout email and LinkedIn

2) Sync recipient engagement to your CRM

3) Build internal dashboards and reports

4) Coordinate workflows based on replies, opens, or clicks

Use the Authentication endpoint to get an access_token. Include it as a Bearer token in all requests. The token is valid for 1 hour (3600 seconds).

Check campaigns & progress

View all campaigns

Retrieve a list of all campaigns in your Snov.io account, including their IDs and basic details.

Use this method to get campaign IDs needed to request data in other methods.

What data it provides:

• Campaign ID
• Campaign name
• Campaign status
• Creation date

View campaign progress

Check the current status and completion progress of a specific campaign.

Use this method to monitor whether a campaign is running, completed, paused, or requires attention.

Required parameter:

• campaign_id — the campaign ID

What data it provides:

• Current campaign status (active, paused, completed, archived)
• Completion progress: Shows the percentage of prospects who reached the last sequence step, and the percentage for whom the campaign ended early due to bounce, reply, autoreply, unsubscribe, deletion, or manual removal
• Prospects still in progress: Number of recipients scheduled to receive upcoming sequence steps

Campaign statistics & reports

Use the following methods to retrieve campaign engagement and performance metrics.

Get campaign analytics

Retrieve aggregated performance statistics across your campaigns.

Use this method to build reports, monitor outreach KPIs, and sync campaign analytics to external dashboards or BI tools.

Required parameter:

Specify the period for which you want to get statistics.

• date_from
• date_to

Other request parameters act as filters that define the scope of returned data.

• campaign_id — retrieve analytics for a specific campaign
• campaign_owner — retrieve analytics for particular team members
• sender_email — retrieve analytics for specific email accounts
• sender_linkedin — retrieve analytics for specific LinkedIn profiles

What data it provides:

The response contains aggregated performance data across both email and LinkedIn channels:

• General outreach metrics: Total prospects targeted, scheduled emails, emails sent, and total bounces detected
• Email engagement metrics: Opens (number of emails opened), clicks (number of links clicked), replies (number of responses), unsubscribes (number opting out), open rate (percentage of emails opened), click rate (percentage of links clicked), reply rate (percentage of emails replied to)
• LinkedIn activity metrics: Number of connection requests sent, number of connections accepted, messages sent through LinkedIn, and replies received on LinkedIn

Get campaign recipients' activity

Retrieve detailed engagement data for all recipients in a campaign, including email and LinkedIn interactions.

Use this method to sync engagement data to your CRM, analytics platform, or internal reporting tools.

Required parameter:

• campaign_id — the campaign ID

What data it provides:

• Per-recipient email activity: emails sent, opened, clicked, replied, bounced
• Per-recipient LinkedIn activity: Number of LinkedIn connection requests sent and accepted, messages sent, and replies received per recipient
• Prospect details: name, email address
• Times for each engagement event

Get campaign replies

Retrieve all replies received in a specific campaign, across both email and LinkedIn channels.

Use this method to monitor prospect responses and feed reply data into your CRM or automation workflows.

Required parameter:

• campaign_id — the campaign ID

What data it provides:

• Prospect details: name, email address
• Reply type: email reply or LinkedIn reply
• Email subject and message body
• LinkedIn reply content
• Sequence step that triggered the reply (step_number)
• AI-detected sentiment of the reply (mood)
• Reply timestamp

Get email opens

Retrieve data about recipients who opened emails in a campaign.

Use this method to monitor email engagement and measure open rates.

Required parameter:

• campaign_id — the campaign ID

What data it provides:

• Prospect details: name, email address
• Number of times the email was opened
• Timestamp of the first open and the most recent open

Get link clicks

Retrieve data about recipients who clicked links in campaign emails.

Use this method to track click-through engagement and content performance.

Required parameter:

• campaign_id — the campaign ID

What data it provides:

• Prospect details: name, email address
• URL that was clicked
• Number of clicks per recipient
• Click timestamp

Get sent emails

Retrieve a list of emails sent within a campaign.

Use this method to validate delivery records and track sending activity.

Required parameter:

• campaign_id — the campaign ID

What data it provides:

• Prospect details: name, email address
• Sender account used
• Email subject
• Sequence step number
• Send timestamp

Get completed prospects

Retrieve prospects who have completed the campaign sequence with no further steps scheduled.

Use this data to identify recipients who completed the sequence without responding and may need follow-up or enrollment in another campaign.

Required parameter:

• campaign_id — the campaign ID

What data it provides:

• Prospect details: name, email address
• Date the prospect completed the sequence
• Final sequence step reached