Articles on: API

API- Revenue Data Extraction

API – Revenue Data Extraction

You can use our API to pull revenue and performance reports directly from the platform.

Required Parameters

Parameter	Required	Description	Example
api_token	Yes	Your private API token.	`your_api_token_here`
from_date	Yes	Start date for the query. Format: `yyyy-mm-dd`.	`2024-01-01`
to_date	Yes	End date for the query. Format: `yyyy-mm-dd`.	`2024-01-31`
tag_id	Yes	Tag IDs (use commas for multiple tags).	`1003291`
columns	Yes	Data columns to include. Options: `net_requests`, `gross_requests`, `total_impressions`, `total_revenue`.	`net_requests,gross_requests`
group_by	Yes	How to group the data. Options: `country_code`, `subid`, `report_date`, `tags`.	`report_date`

Example Request

https://publishers.ad-maven.com/api/public/reports?api_token=YOUR_API_TOKEN&group_by=report_date&from_date=2025-09-09&to_date=2025-09-10&tag_id=1003291&columns=total_impressions,total_revenue

Notes

All parameters are mandatory.
Dates must be in the format yyyy-mm-dd.
Multiple tag IDs or columns should be separated by commas.
The API response will be in JSON format.

Updated on: 20/04/2026

Was this article helpful?

Thank you!