Data Exports
Generate API keys to access your marketing data programmatically.
Data ExportsComing Soon
Overview
Data Exports lets you generate API credentials to access your Adverfly data programmatically. Create API keys, manage access, and use the built-in documentation to query events, sessions, conversions, and ad performance data via the REST API.
Key Features
- API Key Management: Generate, name, and revoke API credentials
- Client Secret Security: Client secrets are shown only once at creation — download or copy immediately
- Built-In API Docs: View available endpoints, parameters, and example requests directly in the app
- Multiple Keys: Create multiple API keys for different use cases or team members
Available API Endpoints
All endpoints use the base URL https://api.adverfly.com with header authentication:
| Endpoint | Description |
|---|---|
GET /v3/events | Pageviews, clicks, and custom events |
GET /v3/sessions | User sessions with entry/exit pages |
GET /v3/conversions | Purchase and conversion events |
GET /v3/ads | Ad performance data (spend, impressions, clicks, reach) |
Authentication
Every request requires two headers:
x-api-key— Your API keyclient-secret— Your client secret
Common Parameters
| Parameter | Description |
|---|---|
start_date | Start of date range (YYYY-MM-DD) |
end_date | End of date range (YYYY-MM-DD) |
name | Filter by event name |
source | Comma-separated ad sources (e.g. meta,google). Ads endpoint. |
limit | Number of results per page (max 500) |
offset | Pagination offset |
How It Works
When you create an API key, Adverfly generates a key pair (API key + client secret). The key inherits your workspace permissions, allowing programmatic access to the same data you see in the dashboard. Use the credentials in your scripts, data pipelines, or BI tools to query Adverfly data.
Use Cases
- Data Pipelines: Pull data into your data warehouse or BI tools
- Custom Dashboards: Build custom visualizations with your own tools
- Automated Reporting: Schedule scripts to pull and format data automatically
- Third-Party Integrations: Connect Adverfly data to tools not natively supported
Getting Started
- Open Data Exports from the sidebar
- Click Create API Key
- Name your key and confirm
- Copy or download the client secret immediately (it will not be shown again)
- Use the API key and client secret in your HTTP requests