Reports
Totals and event-level report data for your account.
Summary
GET /api/v1/reports/summary?range=30dFor publisher and advertiser keys, returns your totals for the period plus a row per campaign:
{
"success": true,
"clicks": 18240,
"conversions": 412,
"approved": 389,
"payout": 4862.5,
"revenue": 7120,
"profit": 2257.5,
"rows": [ ... ]
}range accepts today, yesterday, thisMonth, lastMonth or a number of days such as 7d, 30d, 90d. Default 30d.
For admin keys, the summary is network-wide instead: active campaigns, publishers and advertisers, pending and rejected conversions, flagged clicks, unpaid invoices, and approved revenue and payout.
Events
Every click and conversion as report rows, with the same filters as the Reports page in the app.
GET /api/v1/reports/events| Parameter | Description |
|---|---|
range | As above. Or use from and to (YYYY-MM-DD). |
eventType | click, conversion or all (default) |
status | e.g. approved, pending, rejected |
campaign | Campaign ID; several separated by commas |
publisher | Publisher ID; several separated by commas |
advertiser | Advertiser ID; several separated by commas |
country, device, os, browser | Exact match |
source, sub_source | Traffic source and sub-source (sub1 / sub2) |
limit | Default 500, maximum 1000 |
The response contains total and rows, already limited to your own data.
Was this article helpful?
Thanks for the feedback. Tell us more