;;;;----=====++++++++=====----;;;::::····........ .............···········............ ......····:::::;;;;--------------;;;;;:::::······..................
;;;----===++++++++++++++====---;;;;:::·····......... .................·····.............. ......····::::;;;;;--------------;;;;;:::::·······................
;;;---===++++++*****++++++===----;;;::::·····...................................·····............. ......····::::;;;;;-------------;;;;;;::::::········.............
;;;---===++++*********+++++===---;;;;::::·····.............................···········........... ......····::::;;;;;------------;;;;;;:::::::····················
;;;---===++++**********++++====---;;;;::::·······....................··················......... ......····::::;;;;;;;------;;;;;;;;;:::::::····················
:;;;---===+++++*******+++++====----;;;:::::··········........···························........ ......····:::::;;;;;;;;;;;;;;;;;;:::::::::·················:::
::;;---====++++++++++++++++====---;;;;;:::::·····························::::::··········....... ......·····::::::;;;;;;;;;;;;::::::::::················::::::
::;;;----====++++++++++++=====----;;;;:::::::····················:::::::::::::::::::······...... ......······:::::::::::::::::::::::··················:::::::
:::;;;;----=================----;;;;;;:::::::···············::::::::::::::::::::::::::·····...... ......·······::::::::::::::::·······················::::::;
·::::;;;-----===========------;;;;;;::::::::·············::::::::::;;;;;;;;;;;;;;;::::::·····..... .......·············································::::::;
··::::;;;;;----------------;;;;;;::::::::···············:::::::::;;;;;;;;;;;;;;;;;;;;::::·····..... ........························...........·········:::::;
···:::::;;;;;;;-----;;;;;;;;;::::::::···················:::::::;;;;;;;;---------;;;;;;::::·····..... .........···············.......................······::::;
····::::::;;;;;;;;;;;;;;::::::::························:::::::;;;;;;--------------;;;;;::::····..... .............·····................................·····::::
·····:::::::::::::::::::::::··········..........·········::::::;;;;;;---------------;;;;;:::·····..... .....................................................·····:::
······:::::::::::::::::·········....................·······:::::;;;;;----------------;;;;::::····...... .................................. ........·····:
······::::::::::::··········..........................······:::::;;;;;---------------;;;;;::::····...... ..............·····............... ........····
······::::::::··········............ ..........······::::;;;;;--------------;;;;;::::·····....... ............·············............ .......···
·····:::::::··········......... ........·····:::::;;;;;;---------;;;;;;:::::·····........ ...........····················......... ......··
·:::::::::::········........ .......·····:::::;;;;;;;;;;;;;;;;;;::::::·····........... ............···········:::::··········......... .......
::::::::::::·······........ .......·····::::::;;;;;;;;;;;;;::::::·······.............................········:::::::::::::::::·······....... ......
:::::::::::::······....... .......······::::::::::::::::::::········...........................·······:::::::;;;;;;;;;;:::::::·····....... .....
;;;;;;;;::::::·····...... .......·······::::::::::::::·········..........................······::::::;;;;;;;;;;;;;;;;;;;:::::·····...... .....
---;;;;;;;;::::·····..... ........·························...........................······:::::;;;;;--------------;;;;;:::::····....... .....
--------;;;;::::····...... .........·················...............................······::::;;;;------=========-----;;;;::::·····....... .....
=====-----;;;;:::····..... .................................... ..........·····::::;;;;----===============----;;;;::::····........ .......
+=======----;;;:::····..... ............................ ........····::::;;;----=====++++++++++====----;;;::::·····......... ..........
++++++====---;;;:::····..... ..................... .......····::::;;;---====++++++++++++++====---;;;;::::·····.............................
**++++++===---;;;:::···...... ................ ......····:::;;;---===+++++++***++++++====---;;;;::::······.........................··
*****++++===---;;;:::···...... ............. .....····:::;;;---====+++++*****++++++====---;;;;::::········.................·······
******++++===--;;;:::····...... ............ .....····:::;;;---===+++++++**+++++++====----;;;;:::::······························
******++++===---;;;:::····...... ................ .....···::::;;----===++++++++++++++=====----;;;;::::::························:::::
******++++===---;;;:::·····....... ...................... .....···:::;;;----=====+++++++++======----;;;;;:::::::·················:::::::::::
****+++++===----;;;::::····.......... ............................. ....····:::;;;;----================-----;;;;;:::::::::···········::::::::::::;;;;
+++++++====----;;;::::······................................................... .....····::::;;;------=========-------;;;;;;:::::::::········:::::::::::;;;;;;;;;
+++=======----;;;:::::······...........................················......... .....····::::;;;;;---------------;;;;;;;:::::::::··········::::::::::;;;;;;;;;--
======------;;;;:::::······.......................························....... .....·····:::::;;;;;;;;;-;;;;;;;;;;;::::::::················::::::::;;;;;;;-----
--------;;;;;;:::::······......................···········::::::::::········....... ......·····::::::;;;;;;;;;;;;;;::::::::······················:::::::;;;;;-------
;;;;;;;;;;::::::·······......................········:::::::::::::::::::······...... ......······::::::::::::::::::::::····························::::::;;;;;-------
;;;;;:::::::········........................·······:::::::::;;;;;;;:::::::······...... .......·······::::::::::::::::···········................········:::::;;;;;------
::::::::········............................······:::::::;;;;;;;;;;;;;;:::::·····....... .......·········:::::::::::··········........................······:::::;;;;------
::·········............ ..........······:::::;;;;;;;;;;;;;;;;;;:::::·····....... ........··········::::::···········.............. ............······::::;;;;;----
·······.......... ........·····:::::;;;;;;;------;;;;;;;:::::·····....... ..........··········::::::··········........... ........·····:::::;;;;;--
···.......... .......····:::::;;;;;;---------;;;;;;:::::·····.......... ............·········::::::::::·········......... .......·····:::::;;;;;
.......... ......·····::::;;;;;;----------;;;;;;:::::······...........................········::::::::::::::::·······........ .......·····::::::;;
....... ......····::::;;;;;;;-------;;;;;;;::::::·······....................·········:::::::::::::::::::::······....... .......·····::::::
...... ......····:::::;;;;;;;;;;;;;;;;;;;:::::::·········............·········::::::::;;;;;;;;;;;;;::::::·····...... .......······:::
..... ......····::::::;;;;;;;;;;;;;;;;::::::::··························:::::::;;;;;;;;;;;;;;;;;;;;:::::····...... .......·······
.... .....·····::::::;;;;;;;;;;;;:::::::::·······················:::::::;;;;;;---------------;;;;;::::····...... .........···· Set up https://www.agentrouter.to/SKILL.md, then use TikHub’s /tiktok_ads_get_top_contents_list endpoint through AgentRouter.
Inputs
period_end_timestampRequired 榜单周期结束时间，10位秒级 Unix 时间戳，需与 period_dimension 配合使用；周榜(1)选择UTC周日的榜单日期，日榜(3)/长周期榜(5)选择近期有榜单数据的日期，建议统一按UTC零点换算。时间戳错误或日期过早、无榜单数据时，HTTP 200 也会返回空列表；不要传0或13位毫秒时间戳。示例日期也会过期，实际调用请重新选择近期可用日期。/Ranking period end as a 10-digit Unix timestamp in seconds, paired with period_dimension. Weekly (1): a Sunday ranking date in UTC; daily (3)/long-period (5): a recent date with ranking data. UTC midnight is recommended for date conversion. An incorrect timestamp, an old date, or unavailable ranking data can return an empty list with HTTP 200; do not use 0 or 13-digit milliseconds. Example dates can expire; choose a recent available date when calling.
period_dimensionOptional 榜单周期：1 周榜、3 日榜（默认）、5 长周期榜；决定 period_end_timestamp 对应的榜单类型，并非最近1/3/5天。/Ranking period: 1 weekly, 3 daily (default), 5 long-period; selects the ranking type for period_end_timestamp, not the last 1/3/5 days.
country_codeOptional 国家/地区代码/Country code
content_label_idsOptional 内容分类ID，多个用逗号分隔，空为全部/Content label IDs, comma separated
order_by_metricOptional 排序指标:1 播放量 2 互动率 3 6秒完播率/Order by metric
organic_onlyOptional 是否仅看自然流量内容/Organic content only
pageOptional 页码/Page number
limitOptional 每页数量，最大100/Items per page, max 100 Example input {
"period_end_timestamp": 1792886400,
"period_dimension": 1,
"country_code": "US"
}Copy code 
