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://api.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

Parameter	Type	Description
access_token	String	Unique token used for authorization purposes.
from	Date	The start date, in UTC date format: e.g. "2021-04-05T17:00:00-07:00
to	Date	The end date in UTC date format: e.g. "2021-04-12T17:00:00-011:30"

Response

Parameter	Type	Description
datetime	date	The hour that the stats reflect, in UTC date format
app_name	String	The App name
app_store_identifier	String	App store identifier
placement_name	String	The placement name
country_abbr	String	The country abbreviation
impressions	Integer	The number of entries to TapResearch experience
conversions	Integer	The number of entries with at least one survey payout event
revenue	Float	The revenue in the given hour

Daily stat roll ups

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

Payload

Parameter	Type	Description
access_token	String	Unique token used for authorization purposes.
from	Date	The start date, in UTC date format: e.g. "2021-04-05T17:00:00-07:00
to	Date	The end date in UTC date format: e.g. "2021-04-12T17:00:00-011:30"

Response

Parameter	Type	Description
date	date	The date that the stats reflect, in UTC date format
app_name	String	The App name
country_name	String	The country name
revenue	Float	The revenue in the given hour
user_identifier	String	The user identifier

Example response

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

Quick Question Results

Endpoint: https://www.tapresearch.com/supply_api/suppliers/quick_question_results

Payload

Parameter	Type	Description
access_token	String	Unique token used for authorization purposes.

Response

Parameter	Type	Description
survey_id	Integer	Unique survey ID
survey_name	String	The Survey Name
url	String	Url hosting quick question results csv

Example response

[
    {
        "survey_id": "1",
        "survey_name": "Users favorite colors",
        "url": "url_path_to_hosting_response_data.com/results_csv"
    }
]