> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://publishers-help.ad-maven.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# API- Revenue Data Extraction

Articles on: [API](https://publishers-help.ad-maven.com/en/category/api-1fvhmuv/)
# 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` |
| **tags** | 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&tags=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.