For the complete documentation index, see llms.txt. This page is also available as Markdown.

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_KEY

Requests without a valid key return 401 Unauthorized.

Base URL

https://app.helix.voodoo.io

Timezone

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.

Monetization Reporting API Spec

get
Authorizations
X-API-KeystringRequired
Query parameters
startstring · dateRequired

Start of the date range (inclusive). Format: YYYY-MM-DD (UTC). Must not be more than 3 months in the past.

Example: 2026-07-11
endstring · dateRequired

End of the date range (inclusive). Format: YYYY-MM-DD (UTC). Must not be before the start date.

Example: 2026-07-12
columnsstringOptional

Comma-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.

Example: day,application,impressions,revenue
formatstring · enumOptional

Response format. Possible values: json, csv. If omitted, defaults to json. Can also be controlled via the Accept header (text/csv).

Possible values:
application_idstring[]Optional

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.

Example: com.example.mygame
ad_unit_idstring[]Optional

Keeps 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.

Example: 016fffcf-225a-4094-a0e4-d3b1aa57cb6c
countrystring[]Optional

Keeps 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.

Example: USA,FRA
Header parameters
AcceptstringOptional

Response content type. Use application/json (default) or text/csv.

Default: application/json
Responses
200

Returns reporting as a downloadable JSON or CSV file

A single monetization reporting line. Fields with no data for a given row are omitted.

daystring · dateOptional

Date of the report line, in YYYY-MM-DD format (UTC).

Example: 2026-04-01
applicationstringOptional

Application display name.

Example: My Game
applicationIdstringOptional

App bundle identifier: Android bundle ID (e.g. com.example.myapp) or iOS numeric App Store ID (e.g. 1389111413).

Example: com.example.mygame
adUnitstringOptional

Ad unit name as configured in Helix.

Example: My Game - IOS - Rewarded
adUnitIdstringOptional

Helix ad unit ID (UUID).

Example: 016fffcf-225a-4094-a0e4-d3b1aa57cb6c
formatstring · enumOptional

Ad format type.

Possible values:
countrystringOptional

ISO 3166-1 alpha-3 country code.

Example: USA
countryIso2stringOptional

ISO 3166-1 alpha-2 country code.

Example: US
platformstring · enumOptional

Operating system of the device.

Possible values:
mediationstringOptional

Mediation provider name.

impressionsinteger · int64Optional

Total number of impressions.

Example: 10432
revenuenumber · doubleOptional

Publisher revenue, in USD.

Example: 128.45
clicksinteger · int64Optional

Total number of clicks.

Example: 55
requestsinteger · int64Optional

Total number of ad requests made.

Example: 15678
responsesinteger · int64Optional

Total number of ad responses.

Example: 14900
get/api/v1/reporting/monetization
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?