Getting started
Make your first report request — base URL, authentication and the first call.
1. Get your API key
The Reporting API is authorized with an API key (Bearer token). If you don't have one, contact your account manager. Keep the key secret — never expose it client-side (browser, mobile app).
2. Make your first request
The simplest call: a single grand-total row (no dimensions).
curl -s 'https://reporting.magfiads.com/v1/report?from=2026-06-01T00:00:00Z&to=2026-06-30T23:59:59Z&metrics=views,spending,clicks' \
-H 'Authorization: Bearer <API_KEY>'The three required parameters:
| Parameter | Description |
|---|---|
from | Start (inclusive), ISO 8601 — 2026-06-01T00:00:00Z |
to | End (inclusive), ISO 8601 — 2026-06-30T23:59:59Z. Max 90 days. |
metrics | Comma-separated — views,spending,clicks,conversions |
3. Response
{
"meta": {
"granularity": null,
"dimensions": [],
"metrics": ["views", "spending", "clicks"],
"total": 1,
"page": 1,
"limit": 500,
"has_more": false
},
"data": [
{
"dimensions": {},
"metrics": { "views": 1250400, "spending": 84210.5, "clicks": 9120 }
}
]
}Every row is { dimensions, metrics }. Without any dimensions you get one total row.
Next
- Add a breakdown (campaign/ad/keyword/date) → Report endpoint
- Auth details → Authentication
- Full parameter list → API reference