Reporting API

Overview

Reporting API — a single, unified reporting endpoint for advertiser statistics.

The Reporting API exposes advertiser statistics through a single unified endpoint: GET /v1/report. Every row has the same shape — { dimensions, metrics }.

Purpose

This API exists to pull campaign, ad and keyword performance from the Magfi ads platform programmatically. Advertisers and integration teams can feed views, spending, clicks and conversions into dashboards, BI tools, spreadsheets or automated reports — no manual export from the UI needed.

Thanks to the single endpoint + single row shape ({ dimensions, metrics }), every dimension/metric combination is queried the same way. Adding a new breakdown means sending a different parameter, not learning a separate endpoint.

  • Base URL: https://reporting.magfiads.com
  • Auth: Authorization: Bearer <API_KEY>
  • Format: JSON
  • Scope: campaign, ad and keyword stats (community data is out of scope)

What you can measure

DimensionMetrics
Campaign, adviews, spending, clicks, conversions
Keywordviews, spending, clicks (totals only)
Date (date)buckets the above hourly / daily / weekly / monthly

Get started

On this page