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
"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
"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
"placement_name": "Main Placement",
"placement_identifier": "fb15eabbc89c3fc1466c83a8e0adbbcf",
"country_abbr": "US",
"impressions": 45,
"conversions": 19,
"revenue": "3.56",
"platform": "Android"
},
]

HTTP Request#

GET https://www.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
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