Monetization Reporting API
Programmatic access to your Helix monetization performance data: impressions, revenue, and more for a given date range, optionally filtered to specific columns.
Use this API to feed monetization data into BI systems, finance workflows, or automated alerting.
Getting started
Generate an API key from the Helix dashboard under Monetization > API Keys, then click New API Key and copy it (you won't be able to see it again). If the API Keys page isn't available to you, contact your Helix Account Manager.
Authentication
All requests must include your API key in the X-API-Key header:
X-API-Key: YOUR_API_KEYRequests without a valid key return 401 Unauthorized.
Base URL
https://app.helix.voodoo.ioTimezone
All dates in request parameters use UTC. start and end refer to full calendar days in UTC.
Data delay
Data is available with a 2-hour delay relative to live events. When scheduling automated pulls, run your job at least 2 hours after the target window closes to ensure complete results.
Compression
All responses are gzip-compressed by default. No special request header is needed; your HTTP client handles decompression automatically.
Start of the date range (inclusive). Format: YYYY-MM-DD (UTC). Must not be more than 3 months in the past.
2026-07-11End of the date range (inclusive). Format: YYYY-MM-DD (UTC). Must not be before the start date.
2026-07-12Comma-separated list of columns to include. Possible values: day, application, application_id, ad_unit, ad_unit_id, format, country, country_iso2, platform, mediation, impressions, revenue, clicks, requests, responses. If omitted, all columns are included.
day,application,impressions,revenueResponse format. Possible values: json, csv. If omitted, defaults to json. Can also be controlled via the Accept header (text/csv).
Keeps only these applications: comma-separated, exact values. Use the application_id values the report returns: for Android apps it is the bundle ID in lower case as reported by the SDK (e.g. com.example.mygame). The column does not need to be requested.
com.example.mygameKeeps only these ad units: comma-separated Helix ad unit IDs, exact values. An ID that is not one of your ad units returns no rows. The column does not need to be requested.
016fffcf-225a-4094-a0e4-d3b1aa57cb6cKeeps only these countries: comma-separated ISO 3166-1 alpha-3 codes, as in the country column, exact values. The column does not need to be requested.
USA,FRAResponse content type. Use application/json (default) or text/csv.
application/jsonReturns reporting as a downloadable JSON or CSV file
A single monetization reporting line. Fields with no data for a given row are omitted.
Date of the report line, in YYYY-MM-DD format (UTC).
2026-04-01Application display name.
My GameApp bundle identifier: Android bundle ID (e.g. com.example.myapp) or iOS numeric App Store ID (e.g. 1389111413).
com.example.mygameAd unit name as configured in Helix.
My Game - IOS - RewardedHelix ad unit ID (UUID).
016fffcf-225a-4094-a0e4-d3b1aa57cb6cAd format type.
ISO 3166-1 alpha-3 country code.
USAISO 3166-1 alpha-2 country code.
USOperating system of the device.
Mediation provider name.
Total number of impressions.
10432Publisher revenue, in USD.
128.45Total number of clicks.
55Total number of ad requests made.
15678Total number of ad responses.
14900A required parameter is missing, or a value is invalid (e.g. bad date format, unknown column name, or end date before start date).
The API key is missing or invalid.
GET /api/v1/reporting/monetization?start=2026-01-01&end=2026-01-01 HTTP/1.1
Host: app.helix.voodoo.io
X-API-Key: YOUR_API_KEY
Accept: */*
[
{
"day": "2026-04-01",
"application": "My Game",
"applicationId": "com.example.mygame",
"adUnit": "My Game - IOS - Rewarded",
"adUnitId": "016fffcf-225a-4094-a0e4-d3b1aa57cb6c",
"format": "REWARDED",
"country": "USA",
"countryIso2": "US",
"platform": "IOS",
"mediation": "MAXADS",
"impressions": 10432,
"revenue": 128.45,
"clicks": 55
}
]Last updated
Was this helpful?