Campaigns
v1
Retrieve Campaign Stats
Retrieve statistics for a specific campaign over a defined time period. Use frequency, start_period, and end_period to control how the campaign performance data is grouped and returned.
:::info Requires the campaigns:read OAuth2 scope. :::
get/v1/campaigns/{id}/stats
Path parameters
idstring required
The campaign ID.
Query parameters
account_idstring required
The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
frequency'day' | 'week' | 'month' required
Bucket granularity for the returned stats series.
start_periodstring date required
Inclusive start of the reporting window (ISO 8601 calendar date, YYYY-MM-DD). Must be on or before end_period.
end_periodstring date required
Inclusive end of the reporting window (ISO 8601 calendar date, YYYY-MM-DD). Must be on or after start_period.
page[num]integer
Page of results to fetch.
page[size]integer
The number of items per page. Maximum is 100.
Response
Success
Example response
{
"data": [
{
"type": "campaign_stats",
"id": "MTIzNHwyMDI2LTA0LTE1fDIwMjYtMDQtMTU=",
"attributes": {
"date": "2026-04-15",
"impressions": 100,
"visits": 23,
"reached_count": 1,
"influenced_count": 1,
"ecpm": 12340,
"total_cost": 1234,
"ecpv": 53.65,
"vtr": 0.23,
"currency": "EUR"
}
}
],
"meta": {
"pagination": {
"page_num": 1,
"page_count": 1,
"total_count": 1
},
"request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
}
}