Skip to main content

Reporting API

To get access to this stats API call, reach out to our account management team at developers@tapresearch.com.

Get supplier stats

# Sample stats request

"https://www.tapresearch.com/supply_api/suppliers/stats?access_token=83742aa7dc154c1a84d03213ac1228b5&from=2018-09-20T12:00:00-07:00&to=2018-09-20T13:00:00-07:00"

Sample Response

[
{
"datetime": "2018-09-20T12:00:00-07:00",
"app_name": "Sample App - iOS",
"id": 42,
"app_store_identifier": "com.sample.app",
"placement_name": "Main Placement",
"placement_identifier":"fb15ebe9c89c3fc4256c33a8e0eabcff",
"country_abbr": "US",
"impressions": 10,
"conversions": 5,
"revenue": "1.32",
"platform": "iOS"
},
{
"datetime": "2018-09-20T12:00:00-07:00",
"app_name": "Sample App - iOS",
"id": 42,
"app_store_identifier": "com.sample.app",
"placement_name": "Secondary Placement",
"placement_identifier":"ab13eabbc89c3fc1956c83a8e0efbbfa",
"country_abbr": "US",
"impressions": 1582,
"conversions": 366,
"revenue": "63.54",
"platform": "iOS"
},
{
"datetime": "2018-09-20T12:00:00-07:00",
"app_name": "Sample App - Android",
"id": 43,
"app_store_identifier": "com.sample.app",
"placement_name": "Main Placement",
"placement_identifier": "fb15eabbc89c3fc1466c83a8e0adbbcf",
"country_abbr": "US",
"impressions": 45,
"conversions": 19,
"revenue": "3.56",
"platform": "Android"
},
]

HTTP Request

GET https://api.tapresearch.com/supply_api/suppliers/stats

Payload

ParameterTypeDescription
access_tokenStringUnique token used for authorization purposes.
fromDateThe start date, in UTC date format: e.g. "2021-04-05T17:00:00-07:00
toDateThe end date in UTC date format: e.g. "2021-04-12T17:00:00-011:30"

Response

ParameterTypeDescription
datetimedateThe hour that the stats reflect, in UTC date format
app_nameStringThe App name
app_store_identifierStringApp store identifier
placement_nameStringThe placement name
country_abbrStringThe country abbreviation
impressionsIntegerThe number of entries to TapResearch experience
conversionsIntegerThe number of entries with at least one survey payout event
revenueFloatThe revenue in the given hour

Daily stat roll ups

Endpoint: https://api.tapresearch.com/supply_api/suppliers/daily_stats

Payload

ParameterTypeDescription
access_tokenStringUnique token used for authorization purposes.
fromDateThe start date, in UTC date format: e.g. "2021-04-05T17:00:00-07:00
toDateThe end date in UTC date format: e.g. "2021-04-12T17:00:00-011:30"

Response

ParameterTypeDescription
datedateThe date that the stats reflect, in UTC date format
app_nameStringThe App name
country_nameStringThe country name
revenueFloatThe revenue in the given hour
user_identifierStringThe user identifier

Example response

[
{
"app_name": "Sample App - iOS",
"country_name": "Australia",
"date": "2023-05-13",
"revenue": "0.01",
"user_identifier": "123456"
}
]