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",
    "app_store_identifier": "com.sample.app",
    "placement_name": "Main Placement",
    "placement_identifier": "fb15ebe9c89c3fc4256c33a8e0eabcff",
    "country_abbr": "US",
    "country_name": "United States",
    "impressions": 10,
    "conversions": 5,
    "revenue": "1.32",
    "platform": "iOS"
  },
  {
    "datetime": "2018-09-20T12:00:00-07:00",
    "app_name": "Sample App - iOS",
    "app_store_identifier": "com.sample.app",
    "placement_name": "Secondary Placement",
    "placement_identifier": "ab13eabbc89c3fc1956c83a8e0efbbfa",
    "country_abbr": "US",
    "country_name": "United States",
    "impressions": 1582,
    "conversions": 366,
    "revenue": "63.54",
    "platform": "iOS"
  },
  {
    "datetime": "2018-09-20T12:00:00-07:00",
    "app_name": "Sample App - Android",
    "app_store_identifier": "com.sample.app",
    "placement_name": "Main Placement",
    "placement_identifier": "fb15eabbc89c3fc1466c83a8e0adbbcf",
    "country_abbr": "US",
    "country_name": "United States",
    "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
placement_identifier	String	The unique placement identifier
country_abbr	String	The country abbreviation
country_name	String	The country name
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
platform	String	The app platform name

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
app_name	String	The App name
app_store_identifier	String	App store identifier
country_abbr	String	The country abbreviation
country_name	String	The country name
date	date	The date that the stats reflect, in UTC date format
revenue	Float	The revenue in the given hour
user_identifier	String	The user identifier
platform	String	The app platform name
impressions	Integer	The number of entries to TapResearch experience

Example response

[
  {
    "app_name": "Sample App - iOS",
    "app_store_identifier": "com.sample.app",
    "country_abbr": "AU",
    "country_name": "Australia",
    "date": "2023-05-13",
    "revenue": "0.01",
    "user_identifier": "123456",
    "platform": "iOS",
    "impressions": 2
  }
]

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"
  }
]

Player Summary

To get access to this Player Summary API call, reach out to our account management team at developers@tapresearch.com. We will need publisher contact information for deletion requests.

Endpoint: https://www.tapresearch.com/supply_api/players/summary.csv

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

CSV containing rows for players that profiled between the from and to dates sent.