TikHubTikTok广告 · 获取热门视频榜单
/tiktok_ads_get_top_contents_list获取热门视频榜单。按原始筛选条件读取社交媒体数据，并显式使用分页参数。
- 最近 7 天完成的调用
- 0
统计不包含取消的调用。执行时间仅统计成功调用。
;;;;----=====++++++++=====----;;;::::····........ .............···········............ ......····:::::;;;;--------------;;;;;:::::······.................. ;;;----===++++++++++++++====---;;;;:::·····......... .................·····.............. ......····::::;;;;;--------------;;;;;:::::·······................ ;;;---===++++++*****++++++===----;;;::::·····...................................·····............. ......····::::;;;;;-------------;;;;;;::::::········............. ;;;---===++++*********+++++===---;;;;::::·····.............................···········........... ......····::::;;;;;------------;;;;;;:::::::···················· ;;;---===++++**********++++====---;;;;::::·······....................··················......... ......····::::;;;;;;;------;;;;;;;;;:::::::···················· :;;;---===+++++*******+++++====----;;;:::::··········........···························........ ......····:::::;;;;;;;;;;;;;;;;;;:::::::::·················::: ::;;---====++++++++++++++++====---;;;;;:::::·····························::::::··········....... ......·····::::::;;;;;;;;;;;;::::::::::················:::::: ::;;;----====++++++++++++=====----;;;;:::::::····················:::::::::::::::::::······...... ......······:::::::::::::::::::::::··················::::::: :::;;;;----=================----;;;;;;:::::::···············::::::::::::::::::::::::::·····...... ......·······::::::::::::::::·······················::::::; ·::::;;;-----===========------;;;;;;::::::::·············::::::::::;;;;;;;;;;;;;;;::::::·····..... .......·············································::::::; ··::::;;;;;----------------;;;;;;::::::::···············:::::::::;;;;;;;;;;;;;;;;;;;;::::·····..... ........························...........·········:::::; ···:::::;;;;;;;-----;;;;;;;;;::::::::···················:::::::;;;;;;;;---------;;;;;;::::·····..... .........···············.......................······::::; ····::::::;;;;;;;;;;;;;;::::::::························:::::::;;;;;;--------------;;;;;::::····..... .............·····................................·····:::: ·····:::::::::::::::::::::::··········..........·········::::::;;;;;;---------------;;;;;:::·····..... .....................................................·····::: ······:::::::::::::::::·········....................·······:::::;;;;;----------------;;;;::::····...... .................................. ........·····: ······::::::::::::··········..........................······:::::;;;;;---------------;;;;;::::····...... ..............·····............... ........···· ······::::::::··········............ ..........······::::;;;;;--------------;;;;;::::·····....... ............·············............ .......··· ·····:::::::··········......... ........·····:::::;;;;;;---------;;;;;;:::::·····........ ...........····················......... ......·· ·:::::::::::········........ .......·····:::::;;;;;;;;;;;;;;;;;;::::::·····........... ............···········:::::··········......... ....... ::::::::::::·······........ .......·····::::::;;;;;;;;;;;;;::::::·······.............................········:::::::::::::::::·······....... ...... :::::::::::::······....... .......······::::::::::::::::::::········...........................·······:::::::;;;;;;;;;;:::::::·····....... ..... ;;;;;;;;::::::·····...... .......·······::::::::::::::·········..........................······::::::;;;;;;;;;;;;;;;;;;;:::::·····...... ..... ---;;;;;;;;::::·····..... ........·························...........................······:::::;;;;;--------------;;;;;:::::····....... ..... --------;;;;::::····...... .........·················...............................······::::;;;;------=========-----;;;;::::·····....... ..... =====-----;;;;:::····..... .................................... ..........·····::::;;;;----===============----;;;;::::····........ ....... +=======----;;;:::····..... ............................ ........····::::;;;----=====++++++++++====----;;;::::·····......... .......... ++++++====---;;;:::····..... ..................... .......····::::;;;---====++++++++++++++====---;;;;::::·····............................. **++++++===---;;;:::···...... ................ ......····:::;;;---===+++++++***++++++====---;;;;::::······.........................·· *****++++===---;;;:::···...... ............. .....····:::;;;---====+++++*****++++++====---;;;;::::········.................······· ******++++===--;;;:::····...... ............ .....····:::;;;---===+++++++**+++++++====----;;;;:::::······························ ******++++===---;;;:::····...... ................ .....···::::;;----===++++++++++++++=====----;;;;::::::························::::: ******++++===---;;;:::·····....... ...................... .....···:::;;;----=====+++++++++======----;;;;;:::::::·················::::::::::: ****+++++===----;;;::::····.......... ............................. ....····:::;;;;----================-----;;;;;:::::::::···········::::::::::::;;;; +++++++====----;;;::::······................................................... .....····::::;;;------=========-------;;;;;;:::::::::········:::::::::::;;;;;;;;; +++=======----;;;:::::······...........................················......... .....····::::;;;;;---------------;;;;;;;:::::::::··········::::::::::;;;;;;;;;-- ======------;;;;:::::······.......................························....... .....·····:::::;;;;;;;;;-;;;;;;;;;;;::::::::················::::::::;;;;;;;----- --------;;;;;;:::::······......................···········::::::::::········....... ......·····::::::;;;;;;;;;;;;;;::::::::······················:::::::;;;;;------- ;;;;;;;;;;::::::·······......................········:::::::::::::::::::······...... ......······::::::::::::::::::::::····························::::::;;;;;------- ;;;;;:::::::········........................·······:::::::::;;;;;;;:::::::······...... .......·······::::::::::::::::···········................········:::::;;;;;------ ::::::::········............................······:::::::;;;;;;;;;;;;;;:::::·····....... .......·········:::::::::::··········........................······:::::;;;;------ ::·········............ ..........······:::::;;;;;;;;;;;;;;;;;;:::::·····....... ........··········::::::···········.............. ............······::::;;;;;---- ·······.......... ........·····:::::;;;;;;;------;;;;;;;:::::·····....... ..........··········::::::··········........... ........·····:::::;;;;;-- ···.......... .......····:::::;;;;;;---------;;;;;;:::::·····.......... ............·········::::::::::·········......... .......·····:::::;;;;; .......... ......·····::::;;;;;;----------;;;;;;:::::······...........................········::::::::::::::::·······........ .......·····::::::;; ....... ......····::::;;;;;;;-------;;;;;;;::::::·······....................·········:::::::::::::::::::::······....... .......·····:::::: ...... ......····:::::;;;;;;;;;;;;;;;;;;;:::::::·········............·········::::::::;;;;;;;;;;;;;::::::·····...... .......······::: ..... ......····::::::;;;;;;;;;;;;;;;;::::::::··························:::::::;;;;;;;;;;;;;;;;;;;;:::::····...... .......······· .... .....·····::::::;;;;;;;;;;;;:::::::::·······················:::::::;;;;;;---------------;;;;;::::····...... .........····
通过你的 Agent 使用
请安装 https://www.agentrouter.to/SKILL.md，然后通过 AgentRouter 使用 TikHub 的 /tiktok_ads_get_top_contents_list 接口。
输入参数
period_end_timestamp必填- 榜单周期结束时间，10位秒级 Unix 时间戳，需与 period_dimension 配合使用；周榜(1)选择UTC周日的榜单日期，日榜(3)/长周期榜(5)选择近期有榜单数据的日期，建议统一按UTC零点换算。时间戳错误或日期过早、无榜单数据时，HTTP 200 也会返回空列表；不要传0或13位毫秒时间戳。示例日期也会过期，实际调用请重新选择近期可用日期
period_dimension选填- 榜单周期：1 周榜、3 日榜（默认）、5 长周期榜；决定 period_end_timestamp 对应的榜单类型，并非最近1/3/5天
country_code选填- 国家/地区代码
content_label_ids选填- 内容分类ID，多个用逗号分隔，空为全部
order_by_metric选填- 排序指标:1 播放量 2 互动率 3 6秒完播率
organic_only选填- 是否仅看自然流量内容
page选填- 页码
limit选填- 每页数量，最大100
输入示例
{
"period_end_timestamp": 1792886400,
"period_dimension": 1,
"country_code": "US"
}输出
原生社交数据和分页信息。超出安全整数范围的 ID 以字符串返回。请显式使用返回的游标继续读取；每一页都是一次新请求。