分小时报表

注意：

接入Api前请先熟悉api签名机制（参考接口鉴权说明）, 即Api请求样例中的一些http请求头的来源

1.请求URL

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

使用前说明：数据更新时间正常为每5-10分钟更新一次

2.请求方式

POST

3.请求参数

字段	类型	是否必传	备注	样例
time_zone	String	Y	时区，枚举值：UTC-8、UTC+8、UTC+0	"UTC+8"
start_date	Int	Y	开始日期，格式：YYYYmmdd	20250801
end_date	Int	Y	结束日期，格式YYYYmmdd	20250801
app_id_list	Array[String]	N	开发者后台的多聚合应用ID列表，最大查询100个	["ja547b671dc3ef29"]
placement_id_list	Array[String]	N	开发者后台的聚合单元ID列表，最大查询100个	["kde0e6953d508fee"]
segment_id_list	Array[Int]	N	开发者后台的流量分组ID列表，最大查询100个	[300000126]
unit_id_list	Array[Int]	N	开发者后台的广告单元ID列表，最大查询100个	[300000268]
abtest_item_id_list	Array[Int]	N	开发者后台的A/B测试分组ID列表，最大查询100个	[300000025]
channel_list	Array[Int]	N	开发者后台的渠道名称列表，最大查询100个	["MyChannel"]
geo_short_list	Array[String]	N	国家短码列表，不传默认所有国家，最大查询100个	["US","CN"]
nw_firm_id_list	Array[Int]	N	广告平台ID列表	[1,2]
mediation_id_list	Array[Int]	N	聚合平台ID列表	[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版本列表，最大查询100个	["1.0.0"]
app_version_list	Array[String]	N	应用版本列表，最大查询100个	["5.0.0"]
platform_list	Array[Int]	N	系统平台列表，有效枚举值： 1：Android 2：iOS	[1,2]
start	Int	N	偏移数，代表从第几条数据开始，默认为0	0
limit	Int	N	每次拉取数据的最大条数，默认是1000，最大1000，可选[1,1000]	10

4.返回参数

字段	类型	是否必传	备注
records	Array[Object]	Y	记录，对象数组每个record结构见下面records元素结构
count	Int	Y	总条数
timezone	String	Y	时区，枚举值：UTC-8、UTC+8、UTC+0

records元素结构：

字段	类型	是否必传	备注
date_time	String	N	日期，格式：Y-m-d h:I:S。
loads	Int	N	多聚合流量请求
load_filled_rate	String	N	多聚合流量填充率
request	Int	N	多聚合广告源请求
request_filled_rate	String	N	多聚合广告源填充率
impression	Int	N	展示
impression_rate	String	N	展示率
click	Int	N	点击
estimated_revenue	Float64	N	预估收益
estimated_revenue_ecpm	String	N	预估eCPM
ctr	String	N	点击率

5.样例

请求样例：

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

返回样例：

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