1. API Overview
The Reporting API provides secure, scalable, and programmatic access to daily aggregated reporting metrics for both Demand and Supply across Brand+ (B+) marketplace.
Its key features are:
- RESTful HTTP endpoints
- Provide pre-defined reports (Demand and Supply by default)
- Apply Custom queries with filters on dimensions
- Daily-granularity data available for the current period + the last 4 months (rolling retention)
- Data freshness: updated daily by 08:00 UTC; reporting data is available with a T-1 delay (i.e., complete data is typically available up to yesterday)
- Rate limits enforced at 100 requests/hour per account (Demand and Supply)
- Export report in JSON and CSV format
2. Account Wide Reporting
2.1 Demand
2.1.1 Demand Endpoint
curl "https://api-reporting.verve.com/brand/demand?account_auth_token={ACCOUNT_AUTH_TOKEN}&start_date={START_DATE}&end_date={END_DATE}"
curl "https://api-reporting.verve.com/brand/demand?account_auth_token={ACCOUNT_AUTH_TOKEN}&start_date={START_DATE}&end_date={END_DATE}&group_by=ad_format"
curl "https://api-reporting.verve.com/brand/demand?account_auth_token={ACCOUNT_AUTH_TOKEN}&start_date={START_DATE}&end_date={END_DATE}&group_by=app_bundle"
curl "https://api-reporting.verve.com/brand/demand?account_auth_token={ACCOUNT_AUTH_TOKEN}&start_date={START_DATE}&end_date={END_DATE}&group_by=country_code"
curl "https://api-reporting.verve.com/brand/demand?account_auth_token={ACCOUNT_AUTH_TOKEN}&start_date={START_DATE}&end_date={END_DATE}&group_by=interstitial"
curl "https://api-reporting.verve.com/brand/demand?account_auth_token={ACCOUNT_AUTH_TOKEN}&start_date={START_DATE}&end_date={END_DATE}&group_by=platform"
curl "https://api-reporting.verve.com/brand/demand?account_auth_token={ACCOUNT_AUTH_TOKEN}&start_date={START_DATE}&end_date={END_DATE}&group_by=rewarded"
curl "https://api-reporting.verve.com/brand/demand?account_auth_token={ACCOUNT_AUTH_TOKEN}&start_date={START_DATE}&end_date {END_DATE}&filters=app_bundle:1560965657"
curl "https://api-reporting.verve.com/brand/demand?account_auth_token={ACCOUNT_AUTH_TOKEN}&start_date={START_DATE}&end_date {END_DATE}&group_by=app_bundle,ad_format,country_code,interstitial,platform"
curl "https://api-reporting.verve.com/brand/demand?account_auth_token={ACCOUNT_AUTH_TOKEN}&start_date={START_DATE}&end_date={END_DATE}&format=csv"
2.1.2 Request Parameter
| Parameter | Required? | Description | Example |
account_auth_token | Required | Reporting API access token (unique per account) | 1001a00a1234ab1111ab12a1abc 12312311a10000a1a123412345678abc1234 |
start_date | Required | Start date of the range (YYYY-MM-DD) | 2025-10-09 |
end_date | Required | Start date of the range (YYYY-MM-DD) | 2025-10-10 |
| format | Optional | Data format in which the API returns the report | Allowed Values: json, csv json by default |
| group_by | Optional | You can use a single dimension or a combination of multiple dimensions, separated by comma | date, |
2.1.3 Available Dimension
| Dimension | Type | Description | Example |
| date | date | Report data in YYYY-MM-DD | 2025-10-25 |
| ad_ format | string | Demand ad type | banner, video, native |
| app_bundle | string | Demand app bundle identifier | com.app.name |
| app_site_domain | string | Bundle app or site domain | site.com |
| country_code | string | Country code in ISO 3166-1 alpha-3 format | USA |
| interstitial | integer | Whether the ad is interstitial | 0/1 |
| platform | string | Placement platform | iOS, Android, Web |
| rewarded | boolean | Whether placement is rewarded | true, false |
2.1.4 Response Example
{
"status": "success",
"data": [
{
"date": "2025-10-20",
"gross_revenue": 34917.81,
"impressions": 109068916,
"bids": 1219382746,
"clicks": 290310,
"dsp_requests": 41194680402,
"wins": 766472694
},
{
"date": "2025-10-19",
"gross_revenue": 37153.63,
"impressions": 123576875,
"bids": 1527633303,
"clicks": 305097,
"dsp_requests": 48486533390,
"wins": 897476730
}
],
"result_count": 2
}
{
"status": "success",
"data": [
{
"ad_format": "video",
"gross_revenue": 7398.540000000003,
"impressions": 3053802,
"bids": 154171659,
"clicks": 159738,
"dsp_requests": 7078824889,
"wins": 102345821
},
{
"ad_format": "banner",
"gross_revenue": 59847.009999999944,
"impressions": 217488293,
"bids": 2427155781,
"clicks": 280802,
"dsp_requests": 59587126712,
"wins": 1449152786
}
],
"result_count": 2
}
{
"status": "success",
"data": [
{
"app_bundle": "1340929016",
"gross_revenue": 0,
"impressions": 0,
"bids": 72,
"clicks": 0,
"dsp_requests": 15364,
"wins": 69
},
{
"app_bundle": "com.changdu.portugalreader",
"gross_revenue": 0.01,
"impressions": 10,
"bids": 1276,
"clicks": 0,
"dsp_requests": 51676,
"wins": 1083
}
],
"result_count": 2
}
{
"status": "success",
"data": [
{
"country_code": "COL",
"gross_revenue": 975.3900000000002,
"impressions": 3076696,
"bids": 33296219,
"clicks": 29027,
"dsp_requests": 1276294300,
"wins": 24105888
},
{
"country_code": "DOM",
"gross_revenue": 19.689999999999984,
"impressions": 89455,
"bids": 958441,
"clicks": 1431,
"dsp_requests": 74110892,
"wins": 802546
}
],
"result_count": 2
}
{
"status": "success",
"data": [
{
"interstitial": 0,
"gross_revenue": 52412.57999999995,
"impressions": 224079801,
"bids": 2238973787,
"clicks": 282411,
"dsp_requests": 73726818295,
"wins": 1328186390
},
{
"interstitial": 1,
"gross_revenue": 19658.850000000002,
"impressions": 8565990,
"bids": 508042262,
"clicks": 312996,
"dsp_requests": 15954395497,
"wins": 335763034
}
],
"result_count": 2
}
{
"status": "success",
"data": [
{
"platform": "Android",
"gross_revenue": 44654.30999999996,
"impressions": 121095782,
"bids": 1749677268,
"clicks": 520798,
"dsp_requests": 49712435545,
"wins": 1210391322
},
{
"platform": "iOS",
"gross_revenue": 820.6799999999995,
"impressions": 105544,
"bids": 791971,
"clicks": 0,
"dsp_requests": 3338931041,
"wins": 708217
}
],
"result_count": 2
}
{
"status": "success",
"data": [
{
"rewarded": false,
"gross_revenue": 69748.43999999987,
"impressions": 231387939,
"bids": 2687525812,
"clicks": 551728,
"dsp_requests": 87477390660,
"wins": 1618917241
},
{
"rewarded": true,
"gross_revenue": 2323.0099999999998,
"impressions": 1257852,
"bids": 59490237,
"clicks": 43679,
"dsp_requests": 2203823132,
"wins": 45032183
}
],
"result_count": 2
}
{
"status": "success",
"data": [
{
"date": "2025-10-29",
"gross_revenue": 0,
"impressions": 1,
"bids": 58,
"clicks": 0,
"dsp_requests": 46018,
"wins": 39
},
{
"date": "2025-10-28",
"gross_revenue": 0,
"impressions": 0,
"bids": 65,
"clicks": 0,
"dsp_requests": 19783,
"wins": 57
}
],
"result_count": 2
}
{
"status": "success",
"data": [
{
"app_bundle": "com.vizorinteractive.zombiesettlersv2",
"ad_format": "video",
"country_code": "USA",
"interstitial": 1,
"platform": "Android",
"app_site_domain": null,
"rewarded": true,
"gross_revenue": 0,
"impressions": 0,
"bids": 4,
"clicks": 0,
"dsp_requests": 3015,
"wins": 4
},
{
"app_bundle": "1525770311",
"ad_format": "native",
"country_code": "AUS",
"interstitial": 0,
"platform": "iOS",
"app_site_domain": null,
"rewarded": false,
"gross_revenue": 0,
"impressions": 0,
"bids": 1,
"clicks": 0,
"dsp_requests": 2150,
"wins": 0
}
],
"result_count": 2
}
country_code,gross_revenue,impressions,bids,clicks,dsp_requests,wins THA,600.99,1733711,23467904,3712,786840719,16756358 MLI,0.53,12588,70426,372,14913578,68997 GIB,0.00,2,6,0,375628,2 MSR,0,0,20,0,61940,19