Reporting API

To get access to the Reporting API, reach out to our account management team at developers@tapresearch.com. Every request authenticates with your reporting access_token.

Get supplier stats

Hourly stats per app, content item (offer), and country.

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	DateTime	Start of the range, in ISO 8601 with a UTC offset, e.g. 2021-04-05T17:00:00-07:00.
to	DateTime	End of the range (inclusive), e.g. 2021-04-12T17:00:00-07:00.

Sample request

curl "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"

Response

Parameter	Type	Description
datetime	String	The hour that the stats reflect, in the same UTC offset as from
app_name	String	The App name
id	Integer	The app ID
app_store_identifier	String	App store identifier
placement_name	String	The content item's name
placement_identifier	String	The content item's unique offer 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	String	The revenue in the given hour, as a decimal string (e.g. "1.32")
platform	String	The app platform name

Sample response

[
  {
    "datetime": "2018-09-20T12:00:00-07:00",
    "app_name": "Sample App - iOS",
    "id": 1234,
    "platform": "iOS",
    "app_store_identifier": "com.sample.app",
    "placement_name": "Main Survey Wall",
    "placement_identifier": "fb15ebe9c89c3fc4256c33a8e0eabcff",
    "country_abbr": "US",
    "country_name": "United States",
    "impressions": 10,
    "conversions": 5,
    "revenue": "1.32"
  },
  {
    "datetime": "2018-09-20T12:00:00-07:00",
    "app_name": "Sample App - Android",
    "id": 1235,
    "platform": "Android",
    "app_store_identifier": "com.sample.app",
    "placement_name": "Main Survey Wall",
    "placement_identifier": "fb15eabbc89c3fc1466c83a8e0adbbcf",
    "country_abbr": "US",
    "country_name": "United States",
    "impressions": 45,
    "conversions": 19,
    "revenue": "3.56"
  }
]

Daily stat roll ups

Daily revenue per user.

GET 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, YYYY-MM-DD (e.g. 2021-04-05).
to	Date	The end date (inclusive), YYYY-MM-DD (e.g. 2021-04-12).

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, YYYY-MM-DD
revenue	String	The revenue for that user on that day, as a decimal string
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

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

GET https://api.tapresearch.com/supply_api/audience/players/summary.csv

Payload

Parameter	Type	Description
access_token	String	Unique token used for authorization purposes.
from	DateTime	Start of the range, e.g. 2021-04-05T17:00:00-07:00.
to	DateTime	End of the range, e.g. 2021-04-12T17:00:00-07:00.

Response

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