Hourly Data Report

Note: Please be familiar with the API signature mechanism before accessing the API (refer to the API authentication description), that is, the source of some HTTP request headers in the API request sample.

1. Request URL

https://openapi.hyperbid.com/v3/report/tk_hour

Note: Data refreshes every 5-10 minutes normally.

2.Request Method

POST

3.Request Params

field	types	Required	Notes	Example
time_zone	String	Y	time_zone：UTC-8、UTC+8、UTC+0	"UTC+8"
start_date	Int	Y	start_date：YYYYmmdd	20250801
end_date	Int	Y	end_date: YYYYmmdd	20250801
app_id_list	Array[String]	N	app_id_list	["ja547b671dc3ef29"]
placement_id_list	Array[String]	N	placement_id_list	["kde0e6953d508fee"]
segment_id_list	Array[Int]	N	segment_id_list	[300000126]
unit_id_list	Array[Int]	N	unit_id_list	[300000268]
abtest_item_id_list	Array[Int]	N	abtest_item_id_list	[300000025]
channel_list	Array[Int]	N	channel_list	["MyChannel"]
geo_short_list	Array[String]	N	geo_short_list	["US","CN"]
nw_firm_id_list	Array[Int]	N	nw_firm_id_list	[1,2]
mediation_id_list	Array[Int]	N	mediation_id_list	[1,2]
format_list	Array[Int]	N	0：Native 1：Rewarded Video 2：Banner 3：Interstitial 4：Splash	[0,1,2]
sdk_version_list	Array[String]	N	sdk_version_list	["1.0.0"]
app_version_list	Array[String]	N	app_version_list	["5.0.0"]
platform_list	Array[Int]	N	1：Android 2：iOS	[1,2]
start	Int	N	Offset: Indicates the starting row number of data, default value is 0.	0
limit	Int	N	Maximum number of data items per request. Default: 1000, upper limit: 1000, optional range: 1~1000.	10

4. Response data

field	types	Required	Notes
records	Array[Object]	Y	records
count	Int	Y	count
timezone	String	Y	timezone：UTC-8、UTC+8、UTC+0

records Data：

field	types	Required	Notes
date_time	String	N	date_time：Y-m-d h:I:S。
loads	Int	N	loads
load_filled_rate	String	N	load_filled_rate
request	Int	N	request
request_filled_rate	String	N	request_filled_rate
impression	Int	N	impression
impression_rate	String	N	impression_rate
click	Int	N	click
estimated_revenue	Float64	N	estimated_revenue
estimated_revenue_ecpm	String	N	estimated_revenue_ecpm
ctr	String	N	ctr

5.request sample

curl --location --request POST 'https://openapi.hyperbid.com/v3/report/tk_hour' \
--header 'X-Up-Key: a5c20012d6964913dcea19dbb09243282518505c' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1754033553000' \
--header 'Content-Type: application/json' \
--data-raw '{
  "start_time": 20260518,
  "end_time": 20260518,
  "currency": "USD",  
  "time_zone": "UTC+8",  
  "limit": 100,
  "start": 0,
  "app_id_list":["jcd9834b954b3d09"]
}'

Response Example：

{
    "count": 24,
    "records": [
        {
            "date_time": "2026-05-18 23:00:00",
            "loads": 4419,
            "load_filled_rate": "0.0015",
            "request": 8838,
            "request_filled_rate": "0.0049",
            "impression": 0,
            "impression_rate": "0",
            "click": 0,
            "ctr": "0",
            "estimated_revenue": 0,
            "estimated_revenue_ecpm": "0"
        },
        {
            "date_time": "2026-05-18 22:00:00",
            "loads": 4469,
            "load_filled_rate": "0.0035",
            "request": 8944,
            "request_filled_rate": "0.0026",
            "impression": 0,
            "impression_rate": "0",
            "click": 0,
            "ctr": "0",
            "estimated_revenue": 0,
            "estimated_revenue_ecpm": "0"
        }
    ]
    "timezone": "UTC+8"
}

Impression And Click Device Report

Last modified: 2026-05-21Powered by

Outline