A robust data extraction tool that collects detailed link activity at the day level from a Klaviyo workspace. It helps teams analyze engagement across campaigns and build custom reports with consistent, historical accuracy.
Created by Bitbash, built to showcase our approach to Scraping and Automation!
If you are looking for klaviyo-link-activity-api you've just found your team — Let’s Chat. 👆👆
This project retrieves comprehensive link activity data for email campaigns over time, enabling detailed analysis beyond standard dashboards. It solves the challenge of aggregating daily engagement metrics across campaigns and dates in a structured format. Built for data analysts, growth teams, and marketers who need reliable link-level insights.
- Aggregates all link clicks across campaigns for a selected day
- Supports historical backfills by running across date ranges
- Enables custom campaign-level and account-level analysis
- Designed for repeatable, consistent data collection
| Feature | Description |
|---|---|
| Day-level aggregation | Collects link activity metrics for a specific date across all campaigns. |
| Campaign-wide coverage | Returns activity from every campaign in the workspace. |
| Historical reporting | Supports running over multiple days to rebuild full reports. |
| Metric-based filtering | Uses the Clicked Email metric to ensure accurate engagement data. |
| Field Name | Field Description |
|---|---|
| date | The day for which link activity is recorded. |
| campaign_id | Unique identifier of the email campaign. |
| campaign_name | Human-readable name of the campaign. |
| link_url | The destination URL that was clicked. |
| click_count | Number of clicks recorded for the link. |
| metric_id | Identifier of the Clicked Email metric used. |
Klaviyo Link Activity API/
├── src/
│ ├── runner.py
│ ├── client/
│ │ └── klaviyo_api.py
│ ├── processors/
│ │ └── link_activity_parser.py
│ └── config/
│ └── settings.example.json
├── data/
│ └── sample_output.json
├── requirements.txt
└── README.md
- Marketing analysts use it to rebuild historical link reports, so they can analyze long-term engagement trends.
- Growth teams use it to compare campaign performance, so they can optimize content strategy.
- Data engineers use it to feed BI dashboards, so stakeholders get accurate daily metrics.
- Agencies use it to generate client-ready reports, so they can demonstrate campaign impact.
What credentials are required to run this project? You need a valid API key and the identifier of the Clicked Email metric from your workspace analytics.
Can it replicate built-in campaign link reports? Yes. By running it for each day since a campaign started and filtering by campaign name, you can recreate equivalent reports.
Does it support multiple campaigns automatically? Yes. The data returned includes link activity across all campaigns for the selected day.
Is historical data supported? Yes. Running the project across a date range enables full historical backfills.
Primary Metric: Processes a full day of link activity across all campaigns in under 2 minutes on average.
Reliability Metric: Maintains a success rate above 99% across repeated daily runs.
Efficiency Metric: Optimized requests minimize redundant calls, keeping API usage and runtime low.
Quality Metric: Delivers complete, de-duplicated link records with consistent field accuracy.
