@tikomni/skills 0.1.3 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (474) hide show
  1. package/.skill-package-allowlist.txt +1 -3
  2. package/README.md +41 -49
  3. package/README.zh-CN.md +43 -51
  4. package/bin/tikomni-skills.js +2 -2
  5. package/env.example +37 -56
  6. package/package.json +7 -5
  7. package/skills/social-media-crawl/SKILL.md +53 -0
  8. package/skills/social-media-crawl/agents/openai.yaml +5 -0
  9. package/skills/social-media-crawl/references/contracts/output-envelope.md +22 -0
  10. package/skills/social-media-crawl/references/contracts/work-fact-card-fields.md +48 -0
  11. package/skills/social-media-crawl/references/guides/generic-mcp-objects.md +30 -0
  12. package/skills/social-media-crawl/references/mcp-usage-contract.md +30 -0
  13. package/skills/social-media-crawl/references/pipelines/douyin-creator-home.md +7 -0
  14. package/skills/social-media-crawl/references/pipelines/douyin-single-work.md +7 -0
  15. package/skills/social-media-crawl/references/pipelines/xiaohongshu-creator-home.md +7 -0
  16. package/skills/social-media-crawl/references/pipelines/xiaohongshu-single-work.md +7 -0
  17. package/skills/social-media-crawl/references/schemas/creator-profile.schema.json +33 -0
  18. package/skills/social-media-crawl/references/schemas/output-envelope.schema.json +41 -0
  19. package/skills/social-media-crawl/references/schemas/work-collection.schema.json +29 -0
  20. package/skills/social-media-crawl/references/schemas/work-fact-card.schema.json +67 -0
  21. package/skills/social-media-crawl/references/service-guides/u2-u3-mandatory-fallback.md +21 -0
  22. package/skills/social-media-crawl/scripts/__init__.py +2 -0
  23. package/skills/social-media-crawl/scripts/core/__init__.py +2 -0
  24. package/skills/{single-work-analysis/scripts/pipeline/asr → social-media-crawl/scripts/core}/asr_pipeline.py +98 -2
  25. package/skills/social-media-crawl/scripts/core/completeness.py +83 -0
  26. package/skills/{single-work-analysis → social-media-crawl}/scripts/core/config_loader.py +106 -141
  27. package/skills/social-media-crawl/scripts/core/mcp_dispatch.py +145 -0
  28. package/skills/social-media-crawl/scripts/core/object_detection.py +63 -0
  29. package/skills/{single-work-analysis/scripts/pipeline/asr → social-media-crawl/scripts/core}/poll_u2_task.py +3 -1
  30. package/skills/{creator-analysis → social-media-crawl}/scripts/core/progress_report.py +32 -0
  31. package/skills/social-media-crawl/scripts/core/storage_router.py +160 -0
  32. package/skills/social-media-crawl/scripts/core/u3_fallback.py +328 -0
  33. package/skills/social-media-crawl/scripts/pipelines/__init__.py +2 -0
  34. package/skills/social-media-crawl/scripts/pipelines/douyin_creator_home_helpers.py +35 -0
  35. package/skills/social-media-crawl/scripts/pipelines/douyin_platform_adapter.py +7 -0
  36. package/skills/{creator-analysis/scripts/author_home/asr → social-media-crawl/scripts/pipelines}/home_asr.py +1 -1
  37. package/skills/{creator-analysis/scripts/author_home/adapters → social-media-crawl/scripts/pipelines}/platform_adapters.py +8 -2
  38. package/skills/social-media-crawl/scripts/pipelines/run_douyin_creator_home.py +237 -0
  39. package/skills/{single-work-analysis/scripts/platform/douyin/run_douyin_single_video.py → social-media-crawl/scripts/pipelines/run_douyin_single_work.py} +58 -149
  40. package/skills/social-media-crawl/scripts/pipelines/run_xiaohongshu_creator_home.py +237 -0
  41. package/skills/{single-work-analysis/scripts/platform/xiaohongshu/run_xiaohongshu_extract.py → social-media-crawl/scripts/pipelines/run_xiaohongshu_single_work.py} +30 -119
  42. package/skills/{creator-analysis/scripts/author_home → social-media-crawl/scripts/pipelines}/schema.py +1 -1
  43. package/skills/social-media-crawl/scripts/pipelines/xiaohongshu_creator_home_helpers.py +35 -0
  44. package/skills/social-media-crawl/scripts/pipelines/xiaohongshu_platform_adapter.py +7 -0
  45. package/skills/social-media-crawl/scripts/writers/__init__.py +1 -0
  46. package/skills/social-media-crawl/scripts/writers/write_work_fact_card.py +391 -0
  47. package/skills/creator-analysis/SKILL.md +0 -95
  48. package/skills/creator-analysis/agents/openai.yaml +0 -4
  49. package/skills/creator-analysis/env.example +0 -36
  50. package/skills/creator-analysis/references/api-capability-index.md +0 -92
  51. package/skills/creator-analysis/references/api-contracts/asr-api.md +0 -130
  52. package/skills/creator-analysis/references/api-contracts/bilibili-app-api.md +0 -776
  53. package/skills/creator-analysis/references/api-contracts/bilibili-web-api.md +0 -2017
  54. package/skills/creator-analysis/references/api-contracts/demo-api.md +0 -717
  55. package/skills/creator-analysis/references/api-contracts/douyin-app-v3-api.md +0 -3594
  56. package/skills/creator-analysis/references/api-contracts/douyin-billboard-api.md +0 -2274
  57. package/skills/creator-analysis/references/api-contracts/douyin-creator-api.md +0 -1575
  58. package/skills/creator-analysis/references/api-contracts/douyin-creator-v2-api.md +0 -3254
  59. package/skills/creator-analysis/references/api-contracts/douyin-search-api.md +0 -4118
  60. package/skills/creator-analysis/references/api-contracts/douyin-web-api.md +0 -5544
  61. package/skills/creator-analysis/references/api-contracts/douyin-xingtu-api.md +0 -1916
  62. package/skills/creator-analysis/references/api-contracts/douyin-xingtu-v2-api.md +0 -1540
  63. package/skills/creator-analysis/references/api-contracts/health-check.md +0 -69
  64. package/skills/creator-analysis/references/api-contracts/hybrid-parsing.md +0 -78
  65. package/skills/creator-analysis/references/api-contracts/instagram-v1-api.md +0 -2256
  66. package/skills/creator-analysis/references/api-contracts/instagram-v2-api.md +0 -2011
  67. package/skills/creator-analysis/references/api-contracts/instagram-v3-api.md +0 -2630
  68. package/skills/creator-analysis/references/api-contracts/ios-shortcut.md +0 -44
  69. package/skills/creator-analysis/references/api-contracts/kuaishou-app-api.md +0 -1518
  70. package/skills/creator-analysis/references/api-contracts/kuaishou-web-api.md +0 -1242
  71. package/skills/creator-analysis/references/api-contracts/lemon8-app-api.md +0 -1088
  72. package/skills/creator-analysis/references/api-contracts/linkedin-web-api.md +0 -1949
  73. package/skills/creator-analysis/references/api-contracts/media-ingest-api.md +0 -126
  74. package/skills/creator-analysis/references/api-contracts/pipixia-app-api.md +0 -1142
  75. package/skills/creator-analysis/references/api-contracts/reddit-app-api.md +0 -2025
  76. package/skills/creator-analysis/references/api-contracts/sora2-api.md +0 -2266
  77. package/skills/creator-analysis/references/api-contracts/temp-mail-api.md +0 -208
  78. package/skills/creator-analysis/references/api-contracts/threads-web-api.md +0 -897
  79. package/skills/creator-analysis/references/api-contracts/tikhub-downloader-api.md +0 -134
  80. package/skills/creator-analysis/references/api-contracts/tikhub-user-api.md +0 -494
  81. package/skills/creator-analysis/references/api-contracts/tiktok-ads-api.md +0 -5947
  82. package/skills/creator-analysis/references/api-contracts/tiktok-analytics-api.md +0 -968
  83. package/skills/creator-analysis/references/api-contracts/tiktok-app-v3-api.md +0 -5735
  84. package/skills/creator-analysis/references/api-contracts/tiktok-creator-api.md +0 -1951
  85. package/skills/creator-analysis/references/api-contracts/tiktok-interaction-api.md +0 -742
  86. package/skills/creator-analysis/references/api-contracts/tiktok-shop-web-api.md +0 -1890
  87. package/skills/creator-analysis/references/api-contracts/tiktok-web-api.md +0 -4448
  88. package/skills/creator-analysis/references/api-contracts/toutiao-app-api.md +0 -342
  89. package/skills/creator-analysis/references/api-contracts/toutiao-web-api.md +0 -143
  90. package/skills/creator-analysis/references/api-contracts/twitter-web-api.md +0 -989
  91. package/skills/creator-analysis/references/api-contracts/wechat-channels-api.md +0 -809
  92. package/skills/creator-analysis/references/api-contracts/wechat-media-platform-web-api.md +0 -677
  93. package/skills/creator-analysis/references/api-contracts/weibo-app-api.md +0 -1547
  94. package/skills/creator-analysis/references/api-contracts/weibo-web-api.md +0 -798
  95. package/skills/creator-analysis/references/api-contracts/weibo-web-v2-api.md +0 -2459
  96. package/skills/creator-analysis/references/api-contracts/xiaohongshu-app-api.md +0 -1291
  97. package/skills/creator-analysis/references/api-contracts/xiaohongshu-app-v2-api.md +0 -1683
  98. package/skills/creator-analysis/references/api-contracts/xiaohongshu-web-api.md +0 -1324
  99. package/skills/creator-analysis/references/api-contracts/xiaohongshu-web-v2-api.md +0 -1209
  100. package/skills/creator-analysis/references/api-contracts/xigua-app-v2-api.md +0 -489
  101. package/skills/creator-analysis/references/api-contracts/youtube-web-api.md +0 -2636
  102. package/skills/creator-analysis/references/api-contracts/youtube-web-v2-api.md +0 -2660
  103. package/skills/creator-analysis/references/api-contracts/zhihu-web-api.md +0 -2315
  104. package/skills/creator-analysis/references/api-tags/asr-api.md +0 -100
  105. package/skills/creator-analysis/references/api-tags/bilibili-app-api.md +0 -482
  106. package/skills/creator-analysis/references/api-tags/bilibili-web-api.md +0 -1267
  107. package/skills/creator-analysis/references/api-tags/demo-api.md +0 -365
  108. package/skills/creator-analysis/references/api-tags/douyin-app-v3-api.md +0 -2012
  109. package/skills/creator-analysis/references/api-tags/douyin-billboard-api.md +0 -1428
  110. package/skills/creator-analysis/references/api-tags/douyin-creator-api.md +0 -694
  111. package/skills/creator-analysis/references/api-tags/douyin-creator-v2-api.md +0 -694
  112. package/skills/creator-analysis/references/api-tags/douyin-search-api.md +0 -1059
  113. package/skills/creator-analysis/references/api-tags/douyin-web-api.md +0 -3314
  114. package/skills/creator-analysis/references/api-tags/douyin-xingtu-api.md +0 -935
  115. package/skills/creator-analysis/references/api-tags/douyin-xingtu-v2-api.md +0 -925
  116. package/skills/creator-analysis/references/api-tags/health-check.md +0 -40
  117. package/skills/creator-analysis/references/api-tags/hybrid-parsing.md +0 -57
  118. package/skills/creator-analysis/references/api-tags/instagram-v1-api.md +0 -1224
  119. package/skills/creator-analysis/references/api-tags/instagram-v2-api.md +0 -1147
  120. package/skills/creator-analysis/references/api-tags/instagram-v3-api.md +0 -1123
  121. package/skills/creator-analysis/references/api-tags/ios-shortcut.md +0 -45
  122. package/skills/creator-analysis/references/api-tags/kuaishou-app-api.md +0 -846
  123. package/skills/creator-analysis/references/api-tags/kuaishou-web-api.md +0 -551
  124. package/skills/creator-analysis/references/api-tags/lemon8-app-api.md +0 -687
  125. package/skills/creator-analysis/references/api-tags/linkedin-web-api.md +0 -1105
  126. package/skills/creator-analysis/references/api-tags/media-ingest-api.md +0 -112
  127. package/skills/creator-analysis/references/api-tags/pipixia-app-api.md +0 -721
  128. package/skills/creator-analysis/references/api-tags/reddit-app-api.md +0 -1057
  129. package/skills/creator-analysis/references/api-tags/sora2-api.md +0 -737
  130. package/skills/creator-analysis/references/api-tags/temp-mail-api.md +0 -136
  131. package/skills/creator-analysis/references/api-tags/threads-web-api.md +0 -472
  132. package/skills/creator-analysis/references/api-tags/tikhub-downloader-api.md +0 -65
  133. package/skills/creator-analysis/references/api-tags/tikhub-user-api.md +0 -253
  134. package/skills/creator-analysis/references/api-tags/tiktok-ads-api.md +0 -1393
  135. package/skills/creator-analysis/references/api-tags/tiktok-analytics-api.md +0 -179
  136. package/skills/creator-analysis/references/api-tags/tiktok-app-v3-api.md +0 -3264
  137. package/skills/creator-analysis/references/api-tags/tiktok-creator-api.md +0 -709
  138. package/skills/creator-analysis/references/api-tags/tiktok-interaction-api.md +0 -366
  139. package/skills/creator-analysis/references/api-tags/tiktok-shop-web-api.md +0 -663
  140. package/skills/creator-analysis/references/api-tags/tiktok-web-api.md +0 -2516
  141. package/skills/creator-analysis/references/api-tags/toutiao-app-api.md +0 -220
  142. package/skills/creator-analysis/references/api-tags/toutiao-web-api.md +0 -96
  143. package/skills/creator-analysis/references/api-tags/twitter-web-api.md +0 -562
  144. package/skills/creator-analysis/references/api-tags/wechat-channels-api.md +0 -405
  145. package/skills/creator-analysis/references/api-tags/wechat-media-platform-web-api.md +0 -431
  146. package/skills/creator-analysis/references/api-tags/weibo-app-api.md +0 -851
  147. package/skills/creator-analysis/references/api-tags/weibo-web-api.md +0 -470
  148. package/skills/creator-analysis/references/api-tags/weibo-web-v2-api.md +0 -1405
  149. package/skills/creator-analysis/references/api-tags/xiaohongshu-app-api.md +0 -534
  150. package/skills/creator-analysis/references/api-tags/xiaohongshu-app-v2-api.md +0 -934
  151. package/skills/creator-analysis/references/api-tags/xiaohongshu-web-api.md +0 -757
  152. package/skills/creator-analysis/references/api-tags/xiaohongshu-web-v2-api.md +0 -762
  153. package/skills/creator-analysis/references/api-tags/xigua-app-v2-api.md +0 -308
  154. package/skills/creator-analysis/references/api-tags/youtube-web-api.md +0 -934
  155. package/skills/creator-analysis/references/api-tags/youtube-web-v2-api.md +0 -717
  156. package/skills/creator-analysis/references/api-tags/zhihu-web-api.md +0 -1384
  157. package/skills/creator-analysis/references/asr-orchestration.md +0 -33
  158. package/skills/creator-analysis/references/config-templates/defaults.yaml +0 -60
  159. package/skills/creator-analysis/references/contracts/creator-card-fields.md +0 -25
  160. package/skills/creator-analysis/references/contracts/work-card-fields.md +0 -68
  161. package/skills/creator-analysis/references/platform-guides/douyin.md +0 -54
  162. package/skills/creator-analysis/references/platform-guides/generic.md +0 -50
  163. package/skills/creator-analysis/references/platform-guides/xiaohongshu.md +0 -69
  164. package/skills/creator-analysis/references/prompt-contracts/asr-clean.md +0 -28
  165. package/skills/creator-analysis/references/prompt-contracts/author-analysis-v2.md +0 -46
  166. package/skills/creator-analysis/references/prompt-contracts/author-analysis.md +0 -49
  167. package/skills/creator-analysis/references/prompt-contracts/cta.md +0 -24
  168. package/skills/creator-analysis/references/prompt-contracts/hook.md +0 -25
  169. package/skills/creator-analysis/references/prompt-contracts/insight.md +0 -47
  170. package/skills/creator-analysis/references/prompt-contracts/sampled-work-batch-explanations.md +0 -30
  171. package/skills/creator-analysis/references/prompt-contracts/structure.md +0 -25
  172. package/skills/creator-analysis/references/prompt-contracts/style.md +0 -27
  173. package/skills/creator-analysis/references/prompt-contracts/summary.md +0 -29
  174. package/skills/creator-analysis/references/prompt-contracts/topic.md +0 -29
  175. package/skills/creator-analysis/references/schemas/author-analysis-input-v1.schema.json +0 -325
  176. package/skills/creator-analysis/references/schemas/author-analysis-v2.schema.json +0 -287
  177. package/skills/creator-analysis/references/schemas/sampled-work-batch-explanations.schema.json +0 -41
  178. package/skills/creator-analysis/references/service-guides/asr-u2-u3-fallback.md +0 -75
  179. package/skills/creator-analysis/references/workflow.md +0 -23
  180. package/skills/creator-analysis/scripts/__init__.py +0 -0
  181. package/skills/creator-analysis/scripts/author_home/__init__.py +0 -0
  182. package/skills/creator-analysis/scripts/author_home/adapters/__init__.py +0 -0
  183. package/skills/creator-analysis/scripts/author_home/analyzers/__init__.py +0 -0
  184. package/skills/creator-analysis/scripts/author_home/analyzers/author_analysis_v2_support.py +0 -1165
  185. package/skills/creator-analysis/scripts/author_home/analyzers/prompt_first_analyzers.py +0 -447
  186. package/skills/creator-analysis/scripts/author_home/analyzers/sampled_work_batch_explainer.py +0 -331
  187. package/skills/creator-analysis/scripts/author_home/asr/__init__.py +0 -5
  188. package/skills/creator-analysis/scripts/author_home/builders/__init__.py +0 -0
  189. package/skills/creator-analysis/scripts/author_home/builders/home_builders.py +0 -213
  190. package/skills/creator-analysis/scripts/author_home/collectors/__init__.py +0 -0
  191. package/skills/creator-analysis/scripts/author_home/orchestrator/__init__.py +0 -0
  192. package/skills/creator-analysis/scripts/author_home/orchestrator/run_author_analysis.py +0 -834
  193. package/skills/creator-analysis/scripts/author_home/orchestrator/work_analysis_artifacts.py +0 -609
  194. package/skills/creator-analysis/scripts/core/__init__.py +0 -0
  195. package/skills/creator-analysis/scripts/core/analysis_pipeline.py +0 -133
  196. package/skills/creator-analysis/scripts/core/config_loader.py +0 -418
  197. package/skills/creator-analysis/scripts/core/storage_router.py +0 -256
  198. package/skills/creator-analysis/scripts/core/tikomni_common.py +0 -588
  199. package/skills/creator-analysis/scripts/pipeline/__init__.py +0 -0
  200. package/skills/creator-analysis/scripts/pipeline/asr/__init__.py +0 -0
  201. package/skills/creator-analysis/scripts/pipeline/asr/asr_pipeline.py +0 -1189
  202. package/skills/creator-analysis/scripts/pipeline/asr/poll_u2_task.py +0 -95
  203. package/skills/creator-analysis/scripts/platform/__init__.py +0 -0
  204. package/skills/creator-analysis/scripts/platform/douyin/__init__.py +0 -0
  205. package/skills/creator-analysis/scripts/platform/douyin/run_douyin_single_video.py +0 -1208
  206. package/skills/creator-analysis/scripts/platform/xiaohongshu/__init__.py +0 -0
  207. package/skills/creator-analysis/scripts/platform/xiaohongshu/run_xiaohongshu_extract.py +0 -2128
  208. package/skills/creator-analysis/scripts/writers/__init__.py +0 -0
  209. package/skills/creator-analysis/scripts/writers/write_author_homepage_samples.py +0 -107
  210. package/skills/creator-analysis/scripts/writers/write_benchmark_card.py +0 -1579
  211. package/skills/meta-capability/SKILL.md +0 -69
  212. package/skills/meta-capability/agents/openai.yaml +0 -4
  213. package/skills/meta-capability/env.example +0 -42
  214. package/skills/meta-capability/references/api-capability-index.md +0 -92
  215. package/skills/meta-capability/references/api-contracts/asr-api.md +0 -130
  216. package/skills/meta-capability/references/api-contracts/bilibili-app-api.md +0 -776
  217. package/skills/meta-capability/references/api-contracts/bilibili-web-api.md +0 -2017
  218. package/skills/meta-capability/references/api-contracts/demo-api.md +0 -717
  219. package/skills/meta-capability/references/api-contracts/douyin-app-v3-api.md +0 -3594
  220. package/skills/meta-capability/references/api-contracts/douyin-billboard-api.md +0 -2274
  221. package/skills/meta-capability/references/api-contracts/douyin-creator-api.md +0 -1575
  222. package/skills/meta-capability/references/api-contracts/douyin-creator-v2-api.md +0 -3254
  223. package/skills/meta-capability/references/api-contracts/douyin-search-api.md +0 -4118
  224. package/skills/meta-capability/references/api-contracts/douyin-web-api.md +0 -5544
  225. package/skills/meta-capability/references/api-contracts/douyin-xingtu-api.md +0 -1916
  226. package/skills/meta-capability/references/api-contracts/douyin-xingtu-v2-api.md +0 -1540
  227. package/skills/meta-capability/references/api-contracts/health-check.md +0 -69
  228. package/skills/meta-capability/references/api-contracts/hybrid-parsing.md +0 -78
  229. package/skills/meta-capability/references/api-contracts/instagram-v1-api.md +0 -2256
  230. package/skills/meta-capability/references/api-contracts/instagram-v2-api.md +0 -2011
  231. package/skills/meta-capability/references/api-contracts/instagram-v3-api.md +0 -2630
  232. package/skills/meta-capability/references/api-contracts/ios-shortcut.md +0 -44
  233. package/skills/meta-capability/references/api-contracts/kuaishou-app-api.md +0 -1518
  234. package/skills/meta-capability/references/api-contracts/kuaishou-web-api.md +0 -1242
  235. package/skills/meta-capability/references/api-contracts/lemon8-app-api.md +0 -1088
  236. package/skills/meta-capability/references/api-contracts/linkedin-web-api.md +0 -1949
  237. package/skills/meta-capability/references/api-contracts/media-ingest-api.md +0 -126
  238. package/skills/meta-capability/references/api-contracts/pipixia-app-api.md +0 -1142
  239. package/skills/meta-capability/references/api-contracts/reddit-app-api.md +0 -2025
  240. package/skills/meta-capability/references/api-contracts/sora2-api.md +0 -2266
  241. package/skills/meta-capability/references/api-contracts/temp-mail-api.md +0 -208
  242. package/skills/meta-capability/references/api-contracts/threads-web-api.md +0 -897
  243. package/skills/meta-capability/references/api-contracts/tikhub-downloader-api.md +0 -134
  244. package/skills/meta-capability/references/api-contracts/tikhub-user-api.md +0 -494
  245. package/skills/meta-capability/references/api-contracts/tiktok-ads-api.md +0 -5947
  246. package/skills/meta-capability/references/api-contracts/tiktok-analytics-api.md +0 -968
  247. package/skills/meta-capability/references/api-contracts/tiktok-app-v3-api.md +0 -5735
  248. package/skills/meta-capability/references/api-contracts/tiktok-creator-api.md +0 -1951
  249. package/skills/meta-capability/references/api-contracts/tiktok-interaction-api.md +0 -742
  250. package/skills/meta-capability/references/api-contracts/tiktok-shop-web-api.md +0 -1890
  251. package/skills/meta-capability/references/api-contracts/tiktok-web-api.md +0 -4448
  252. package/skills/meta-capability/references/api-contracts/toutiao-app-api.md +0 -342
  253. package/skills/meta-capability/references/api-contracts/toutiao-web-api.md +0 -143
  254. package/skills/meta-capability/references/api-contracts/twitter-web-api.md +0 -989
  255. package/skills/meta-capability/references/api-contracts/wechat-channels-api.md +0 -809
  256. package/skills/meta-capability/references/api-contracts/wechat-media-platform-web-api.md +0 -677
  257. package/skills/meta-capability/references/api-contracts/weibo-app-api.md +0 -1547
  258. package/skills/meta-capability/references/api-contracts/weibo-web-api.md +0 -798
  259. package/skills/meta-capability/references/api-contracts/weibo-web-v2-api.md +0 -2459
  260. package/skills/meta-capability/references/api-contracts/xiaohongshu-app-api.md +0 -1291
  261. package/skills/meta-capability/references/api-contracts/xiaohongshu-app-v2-api.md +0 -1683
  262. package/skills/meta-capability/references/api-contracts/xiaohongshu-web-api.md +0 -1324
  263. package/skills/meta-capability/references/api-contracts/xiaohongshu-web-v2-api.md +0 -1209
  264. package/skills/meta-capability/references/api-contracts/xigua-app-v2-api.md +0 -489
  265. package/skills/meta-capability/references/api-contracts/youtube-web-api.md +0 -2636
  266. package/skills/meta-capability/references/api-contracts/youtube-web-v2-api.md +0 -2660
  267. package/skills/meta-capability/references/api-contracts/zhihu-web-api.md +0 -2315
  268. package/skills/meta-capability/references/api-tags/asr-api.md +0 -100
  269. package/skills/meta-capability/references/api-tags/bilibili-app-api.md +0 -482
  270. package/skills/meta-capability/references/api-tags/bilibili-web-api.md +0 -1267
  271. package/skills/meta-capability/references/api-tags/demo-api.md +0 -365
  272. package/skills/meta-capability/references/api-tags/douyin-app-v3-api.md +0 -2012
  273. package/skills/meta-capability/references/api-tags/douyin-billboard-api.md +0 -1428
  274. package/skills/meta-capability/references/api-tags/douyin-creator-api.md +0 -694
  275. package/skills/meta-capability/references/api-tags/douyin-creator-v2-api.md +0 -694
  276. package/skills/meta-capability/references/api-tags/douyin-search-api.md +0 -1059
  277. package/skills/meta-capability/references/api-tags/douyin-web-api.md +0 -3314
  278. package/skills/meta-capability/references/api-tags/douyin-xingtu-api.md +0 -935
  279. package/skills/meta-capability/references/api-tags/douyin-xingtu-v2-api.md +0 -925
  280. package/skills/meta-capability/references/api-tags/health-check.md +0 -40
  281. package/skills/meta-capability/references/api-tags/hybrid-parsing.md +0 -57
  282. package/skills/meta-capability/references/api-tags/instagram-v1-api.md +0 -1224
  283. package/skills/meta-capability/references/api-tags/instagram-v2-api.md +0 -1147
  284. package/skills/meta-capability/references/api-tags/instagram-v3-api.md +0 -1123
  285. package/skills/meta-capability/references/api-tags/ios-shortcut.md +0 -45
  286. package/skills/meta-capability/references/api-tags/kuaishou-app-api.md +0 -846
  287. package/skills/meta-capability/references/api-tags/kuaishou-web-api.md +0 -551
  288. package/skills/meta-capability/references/api-tags/lemon8-app-api.md +0 -687
  289. package/skills/meta-capability/references/api-tags/linkedin-web-api.md +0 -1105
  290. package/skills/meta-capability/references/api-tags/media-ingest-api.md +0 -112
  291. package/skills/meta-capability/references/api-tags/pipixia-app-api.md +0 -721
  292. package/skills/meta-capability/references/api-tags/reddit-app-api.md +0 -1057
  293. package/skills/meta-capability/references/api-tags/sora2-api.md +0 -737
  294. package/skills/meta-capability/references/api-tags/temp-mail-api.md +0 -136
  295. package/skills/meta-capability/references/api-tags/threads-web-api.md +0 -472
  296. package/skills/meta-capability/references/api-tags/tikhub-downloader-api.md +0 -65
  297. package/skills/meta-capability/references/api-tags/tikhub-user-api.md +0 -253
  298. package/skills/meta-capability/references/api-tags/tiktok-ads-api.md +0 -1393
  299. package/skills/meta-capability/references/api-tags/tiktok-analytics-api.md +0 -179
  300. package/skills/meta-capability/references/api-tags/tiktok-app-v3-api.md +0 -3264
  301. package/skills/meta-capability/references/api-tags/tiktok-creator-api.md +0 -709
  302. package/skills/meta-capability/references/api-tags/tiktok-interaction-api.md +0 -366
  303. package/skills/meta-capability/references/api-tags/tiktok-shop-web-api.md +0 -663
  304. package/skills/meta-capability/references/api-tags/tiktok-web-api.md +0 -2516
  305. package/skills/meta-capability/references/api-tags/toutiao-app-api.md +0 -220
  306. package/skills/meta-capability/references/api-tags/toutiao-web-api.md +0 -96
  307. package/skills/meta-capability/references/api-tags/twitter-web-api.md +0 -562
  308. package/skills/meta-capability/references/api-tags/wechat-channels-api.md +0 -405
  309. package/skills/meta-capability/references/api-tags/wechat-media-platform-web-api.md +0 -431
  310. package/skills/meta-capability/references/api-tags/weibo-app-api.md +0 -851
  311. package/skills/meta-capability/references/api-tags/weibo-web-api.md +0 -470
  312. package/skills/meta-capability/references/api-tags/weibo-web-v2-api.md +0 -1405
  313. package/skills/meta-capability/references/api-tags/xiaohongshu-app-api.md +0 -534
  314. package/skills/meta-capability/references/api-tags/xiaohongshu-app-v2-api.md +0 -934
  315. package/skills/meta-capability/references/api-tags/xiaohongshu-web-api.md +0 -757
  316. package/skills/meta-capability/references/api-tags/xiaohongshu-web-v2-api.md +0 -762
  317. package/skills/meta-capability/references/api-tags/xigua-app-v2-api.md +0 -308
  318. package/skills/meta-capability/references/api-tags/youtube-web-api.md +0 -934
  319. package/skills/meta-capability/references/api-tags/youtube-web-v2-api.md +0 -717
  320. package/skills/meta-capability/references/api-tags/zhihu-web-api.md +0 -1384
  321. package/skills/meta-capability/references/config-templates/defaults.yaml +0 -18
  322. package/skills/meta-capability/references/dispatch.md +0 -27
  323. package/skills/meta-capability/references/execution-guidelines.md +0 -25
  324. package/skills/meta-capability/references/implemented-route-map.md +0 -177
  325. package/skills/meta-capability/references/service-guides/asr-u2-u3-fallback.md +0 -75
  326. package/skills/meta-capability/scripts/__init__.py +0 -1
  327. package/skills/meta-capability/scripts/call_route.py +0 -141
  328. package/skills/meta-capability/scripts/core/__init__.py +0 -1
  329. package/skills/meta-capability/scripts/core/bootstrap_env.py +0 -32
  330. package/skills/meta-capability/scripts/core/config_loader.py +0 -204
  331. package/skills/meta-capability/scripts/core/tikomni_common.py +0 -443
  332. package/skills/meta-capability/scripts/test_auth.py +0 -98
  333. package/skills/single-work-analysis/SKILL.md +0 -62
  334. package/skills/single-work-analysis/agents/openai.yaml +0 -4
  335. package/skills/single-work-analysis/env.example +0 -36
  336. package/skills/single-work-analysis/references/api-capability-index.md +0 -92
  337. package/skills/single-work-analysis/references/api-contracts/asr-api.md +0 -130
  338. package/skills/single-work-analysis/references/api-contracts/bilibili-app-api.md +0 -776
  339. package/skills/single-work-analysis/references/api-contracts/bilibili-web-api.md +0 -2017
  340. package/skills/single-work-analysis/references/api-contracts/demo-api.md +0 -717
  341. package/skills/single-work-analysis/references/api-contracts/douyin-app-v3-api.md +0 -3594
  342. package/skills/single-work-analysis/references/api-contracts/douyin-billboard-api.md +0 -2274
  343. package/skills/single-work-analysis/references/api-contracts/douyin-creator-api.md +0 -1575
  344. package/skills/single-work-analysis/references/api-contracts/douyin-creator-v2-api.md +0 -3254
  345. package/skills/single-work-analysis/references/api-contracts/douyin-search-api.md +0 -4118
  346. package/skills/single-work-analysis/references/api-contracts/douyin-web-api.md +0 -5544
  347. package/skills/single-work-analysis/references/api-contracts/douyin-xingtu-api.md +0 -1916
  348. package/skills/single-work-analysis/references/api-contracts/douyin-xingtu-v2-api.md +0 -1540
  349. package/skills/single-work-analysis/references/api-contracts/health-check.md +0 -69
  350. package/skills/single-work-analysis/references/api-contracts/hybrid-parsing.md +0 -78
  351. package/skills/single-work-analysis/references/api-contracts/instagram-v1-api.md +0 -2256
  352. package/skills/single-work-analysis/references/api-contracts/instagram-v2-api.md +0 -2011
  353. package/skills/single-work-analysis/references/api-contracts/instagram-v3-api.md +0 -2630
  354. package/skills/single-work-analysis/references/api-contracts/ios-shortcut.md +0 -44
  355. package/skills/single-work-analysis/references/api-contracts/kuaishou-app-api.md +0 -1518
  356. package/skills/single-work-analysis/references/api-contracts/kuaishou-web-api.md +0 -1242
  357. package/skills/single-work-analysis/references/api-contracts/lemon8-app-api.md +0 -1088
  358. package/skills/single-work-analysis/references/api-contracts/linkedin-web-api.md +0 -1949
  359. package/skills/single-work-analysis/references/api-contracts/media-ingest-api.md +0 -126
  360. package/skills/single-work-analysis/references/api-contracts/pipixia-app-api.md +0 -1142
  361. package/skills/single-work-analysis/references/api-contracts/reddit-app-api.md +0 -2025
  362. package/skills/single-work-analysis/references/api-contracts/sora2-api.md +0 -2266
  363. package/skills/single-work-analysis/references/api-contracts/temp-mail-api.md +0 -208
  364. package/skills/single-work-analysis/references/api-contracts/threads-web-api.md +0 -897
  365. package/skills/single-work-analysis/references/api-contracts/tikhub-downloader-api.md +0 -134
  366. package/skills/single-work-analysis/references/api-contracts/tikhub-user-api.md +0 -494
  367. package/skills/single-work-analysis/references/api-contracts/tiktok-ads-api.md +0 -5947
  368. package/skills/single-work-analysis/references/api-contracts/tiktok-analytics-api.md +0 -968
  369. package/skills/single-work-analysis/references/api-contracts/tiktok-app-v3-api.md +0 -5735
  370. package/skills/single-work-analysis/references/api-contracts/tiktok-creator-api.md +0 -1951
  371. package/skills/single-work-analysis/references/api-contracts/tiktok-interaction-api.md +0 -742
  372. package/skills/single-work-analysis/references/api-contracts/tiktok-shop-web-api.md +0 -1890
  373. package/skills/single-work-analysis/references/api-contracts/tiktok-web-api.md +0 -4448
  374. package/skills/single-work-analysis/references/api-contracts/toutiao-app-api.md +0 -342
  375. package/skills/single-work-analysis/references/api-contracts/toutiao-web-api.md +0 -143
  376. package/skills/single-work-analysis/references/api-contracts/twitter-web-api.md +0 -989
  377. package/skills/single-work-analysis/references/api-contracts/wechat-channels-api.md +0 -809
  378. package/skills/single-work-analysis/references/api-contracts/wechat-media-platform-web-api.md +0 -677
  379. package/skills/single-work-analysis/references/api-contracts/weibo-app-api.md +0 -1547
  380. package/skills/single-work-analysis/references/api-contracts/weibo-web-api.md +0 -798
  381. package/skills/single-work-analysis/references/api-contracts/weibo-web-v2-api.md +0 -2459
  382. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-app-api.md +0 -1291
  383. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-app-v2-api.md +0 -1683
  384. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-web-api.md +0 -1324
  385. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-web-v2-api.md +0 -1209
  386. package/skills/single-work-analysis/references/api-contracts/xigua-app-v2-api.md +0 -489
  387. package/skills/single-work-analysis/references/api-contracts/youtube-web-api.md +0 -2636
  388. package/skills/single-work-analysis/references/api-contracts/youtube-web-v2-api.md +0 -2660
  389. package/skills/single-work-analysis/references/api-contracts/zhihu-web-api.md +0 -2315
  390. package/skills/single-work-analysis/references/api-tags/asr-api.md +0 -100
  391. package/skills/single-work-analysis/references/api-tags/bilibili-app-api.md +0 -482
  392. package/skills/single-work-analysis/references/api-tags/bilibili-web-api.md +0 -1267
  393. package/skills/single-work-analysis/references/api-tags/demo-api.md +0 -365
  394. package/skills/single-work-analysis/references/api-tags/douyin-app-v3-api.md +0 -2012
  395. package/skills/single-work-analysis/references/api-tags/douyin-billboard-api.md +0 -1428
  396. package/skills/single-work-analysis/references/api-tags/douyin-creator-api.md +0 -694
  397. package/skills/single-work-analysis/references/api-tags/douyin-creator-v2-api.md +0 -694
  398. package/skills/single-work-analysis/references/api-tags/douyin-search-api.md +0 -1059
  399. package/skills/single-work-analysis/references/api-tags/douyin-web-api.md +0 -3314
  400. package/skills/single-work-analysis/references/api-tags/douyin-xingtu-api.md +0 -935
  401. package/skills/single-work-analysis/references/api-tags/douyin-xingtu-v2-api.md +0 -925
  402. package/skills/single-work-analysis/references/api-tags/health-check.md +0 -40
  403. package/skills/single-work-analysis/references/api-tags/hybrid-parsing.md +0 -57
  404. package/skills/single-work-analysis/references/api-tags/instagram-v1-api.md +0 -1224
  405. package/skills/single-work-analysis/references/api-tags/instagram-v2-api.md +0 -1147
  406. package/skills/single-work-analysis/references/api-tags/instagram-v3-api.md +0 -1123
  407. package/skills/single-work-analysis/references/api-tags/ios-shortcut.md +0 -45
  408. package/skills/single-work-analysis/references/api-tags/kuaishou-app-api.md +0 -846
  409. package/skills/single-work-analysis/references/api-tags/kuaishou-web-api.md +0 -551
  410. package/skills/single-work-analysis/references/api-tags/lemon8-app-api.md +0 -687
  411. package/skills/single-work-analysis/references/api-tags/linkedin-web-api.md +0 -1105
  412. package/skills/single-work-analysis/references/api-tags/media-ingest-api.md +0 -112
  413. package/skills/single-work-analysis/references/api-tags/pipixia-app-api.md +0 -721
  414. package/skills/single-work-analysis/references/api-tags/reddit-app-api.md +0 -1057
  415. package/skills/single-work-analysis/references/api-tags/sora2-api.md +0 -737
  416. package/skills/single-work-analysis/references/api-tags/temp-mail-api.md +0 -136
  417. package/skills/single-work-analysis/references/api-tags/threads-web-api.md +0 -472
  418. package/skills/single-work-analysis/references/api-tags/tikhub-downloader-api.md +0 -65
  419. package/skills/single-work-analysis/references/api-tags/tikhub-user-api.md +0 -253
  420. package/skills/single-work-analysis/references/api-tags/tiktok-ads-api.md +0 -1393
  421. package/skills/single-work-analysis/references/api-tags/tiktok-analytics-api.md +0 -179
  422. package/skills/single-work-analysis/references/api-tags/tiktok-app-v3-api.md +0 -3264
  423. package/skills/single-work-analysis/references/api-tags/tiktok-creator-api.md +0 -709
  424. package/skills/single-work-analysis/references/api-tags/tiktok-interaction-api.md +0 -366
  425. package/skills/single-work-analysis/references/api-tags/tiktok-shop-web-api.md +0 -663
  426. package/skills/single-work-analysis/references/api-tags/tiktok-web-api.md +0 -2516
  427. package/skills/single-work-analysis/references/api-tags/toutiao-app-api.md +0 -220
  428. package/skills/single-work-analysis/references/api-tags/toutiao-web-api.md +0 -96
  429. package/skills/single-work-analysis/references/api-tags/twitter-web-api.md +0 -562
  430. package/skills/single-work-analysis/references/api-tags/wechat-channels-api.md +0 -405
  431. package/skills/single-work-analysis/references/api-tags/wechat-media-platform-web-api.md +0 -431
  432. package/skills/single-work-analysis/references/api-tags/weibo-app-api.md +0 -851
  433. package/skills/single-work-analysis/references/api-tags/weibo-web-api.md +0 -470
  434. package/skills/single-work-analysis/references/api-tags/weibo-web-v2-api.md +0 -1405
  435. package/skills/single-work-analysis/references/api-tags/xiaohongshu-app-api.md +0 -534
  436. package/skills/single-work-analysis/references/api-tags/xiaohongshu-app-v2-api.md +0 -934
  437. package/skills/single-work-analysis/references/api-tags/xiaohongshu-web-api.md +0 -757
  438. package/skills/single-work-analysis/references/api-tags/xiaohongshu-web-v2-api.md +0 -762
  439. package/skills/single-work-analysis/references/api-tags/xigua-app-v2-api.md +0 -308
  440. package/skills/single-work-analysis/references/api-tags/youtube-web-api.md +0 -934
  441. package/skills/single-work-analysis/references/api-tags/youtube-web-v2-api.md +0 -717
  442. package/skills/single-work-analysis/references/api-tags/zhihu-web-api.md +0 -1384
  443. package/skills/single-work-analysis/references/asr-and-fallback.md +0 -20
  444. package/skills/single-work-analysis/references/config-templates/defaults.yaml +0 -47
  445. package/skills/single-work-analysis/references/contracts/work-card-fields.md +0 -41
  446. package/skills/single-work-analysis/references/platform-guides/douyin.md +0 -47
  447. package/skills/single-work-analysis/references/platform-guides/generic.md +0 -43
  448. package/skills/single-work-analysis/references/platform-guides/xiaohongshu.md +0 -54
  449. package/skills/single-work-analysis/references/prompt-contracts/analysis-bundle.md +0 -82
  450. package/skills/single-work-analysis/references/schemas/work-card.schema.json +0 -39
  451. package/skills/single-work-analysis/references/service-guides/asr-u2-u3-fallback.md +0 -75
  452. package/skills/single-work-analysis/scripts/__init__.py +0 -0
  453. package/skills/single-work-analysis/scripts/core/__init__.py +0 -0
  454. package/skills/single-work-analysis/scripts/core/analysis_adapter.py +0 -384
  455. package/skills/single-work-analysis/scripts/core/analysis_pipeline.py +0 -456
  456. package/skills/single-work-analysis/scripts/core/bootstrap_env.py +0 -35
  457. package/skills/single-work-analysis/scripts/core/extract_pipeline.py +0 -173
  458. package/skills/single-work-analysis/scripts/core/progress_report.py +0 -258
  459. package/skills/single-work-analysis/scripts/core/storage_router.py +0 -220
  460. package/skills/single-work-analysis/scripts/pipeline/__init__.py +0 -0
  461. package/skills/single-work-analysis/scripts/pipeline/asr/__init__.py +0 -0
  462. package/skills/single-work-analysis/scripts/platform/__init__.py +0 -0
  463. package/skills/single-work-analysis/scripts/platform/douyin/__init__.py +0 -0
  464. package/skills/single-work-analysis/scripts/platform/douyin/douyin_video_type_matrix.py +0 -224
  465. package/skills/single-work-analysis/scripts/platform/douyin/select_low_quality_video_url.py +0 -200
  466. package/skills/single-work-analysis/scripts/platform/xiaohongshu/__init__.py +0 -0
  467. package/skills/single-work-analysis/scripts/writers/__init__.py +0 -0
  468. package/skills/single-work-analysis/scripts/writers/write_benchmark_card.py +0 -752
  469. /package/skills/{creator-analysis → social-media-crawl}/scripts/core/bootstrap_env.py +0 -0
  470. /package/skills/{creator-analysis → social-media-crawl}/scripts/core/extract_pipeline.py +0 -0
  471. /package/skills/{single-work-analysis → social-media-crawl}/scripts/core/tikomni_common.py +0 -0
  472. /package/skills/{creator-analysis/scripts/platform/douyin → social-media-crawl/scripts/pipelines}/douyin_video_type_matrix.py +0 -0
  473. /package/skills/{creator-analysis/scripts/author_home/collectors → social-media-crawl/scripts/pipelines}/homepage_collectors.py +0 -0
  474. /package/skills/{creator-analysis/scripts/platform/douyin → social-media-crawl/scripts/pipelines}/select_low_quality_video_url.py +0 -0
@@ -1,2274 +0,0 @@
1
- # Douyin-Billboard-API Full Contract
2
-
3
- - Back to index: [`api-capability-index.md`](../api-capability-index.md)
4
- - Back to route summary: [`api-tags/douyin-billboard-api.md`](../api-tags/douyin-billboard-api.md)
5
- - Current contract file: `api-contracts/douyin-billboard-api.md`
6
- - Source: `https://app.tikomni.com/openapi/tikomni-openapi.full.with-u2.public.latest.json`
7
- - Fetched at: `2026-03-08T06:54:04+00:00`
8
- - Route count: `31`
9
- - Default auth: Header `Authorization` Bearer
10
- - Read this file only when you need precise auth notes, parameter descriptions, defaults, examples, or success-response fields.
11
- - Tag description: **(抖音热点榜数据接口/Douyin-Billboard-API data endpoints)**
12
-
13
- ## Route Contracts
14
-
15
- <a id="get-api-u1-v1-douyin-billboard-fetch-city-list"></a>
16
- ### `GET /api/u1/v1/douyin/billboard/fetch_city_list`
17
-
18
- - Summary: 获取中国城市列表/Fetch Chinese city list
19
- - Capabilities: trends / rankings
20
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
21
- - operationId: `fetch_city_list_api_v1_douyin_billboard_fetch_city_list_get`
22
-
23
- #### Notes
24
-
25
- > # [中文]
26
- > ### 用途:
27
- > - 获取城市列表
28
- > ### 参数:
29
- > - 无
30
- > ### 返回:
31
- > - 中国城市列表
32
- >
33
- > # [English]
34
- > ### Purpose:
35
- > - Get city list
36
- > ### Parameters:
37
- > - None
38
- > ### Return:
39
- > - Chinese city list
40
-
41
- #### Parameters
42
-
43
- None
44
-
45
- #### Request Body
46
-
47
- None
48
-
49
- #### Success Response
50
-
51
- ##### `200 application/json`
52
-
53
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
54
-
55
- | Field | Type | Required | Description | Default | Example | Enum |
56
- | --- | --- | --- | --- | --- | --- | --- |
57
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
58
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
59
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
60
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
61
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
62
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
63
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
64
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
65
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
66
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
67
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
68
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
69
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
70
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
71
- | data | null | No | The response data \| 响应数据 | None | None | None |
72
-
73
- <a id="get-api-u1-v1-douyin-billboard-fetch-content-tag"></a>
74
- ### `GET /api/u1/v1/douyin/billboard/fetch_content_tag`
75
-
76
- - Summary: 获取垂类内容标签/Fetch vertical content tags
77
- - Capabilities: trends / rankings
78
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
79
- - operationId: `fetch_content_tag_api_v1_douyin_billboard_fetch_content_tag_get`
80
-
81
- #### Notes
82
-
83
- > # [中文]
84
- > ### 用途:
85
- > - 获取垂类内容标签
86
- > ### 参数:
87
- > - 无
88
- > ### 返回:
89
- > - 垂类内容标签
90
- > ### 注意:
91
- > - 该接口用于获取垂类内容标签,用于query_tag参数构建
92
- > ### 示例:
93
- > 已知顶级垂类内容标签 `美食`,它的顶级垂类id为 `628`;`美食` 的子垂类标签 `品酒教学`,它的子垂类id为 `62802`。
94
- > 那么构建标签查询参数为 `{"value": 628, "children": [{"value": 62808}]}`
95
- >
96
- > 如果需要多个子垂类标签,所有的美食子垂类标签为 `{"value":628,"children":[{"value":62808},{"value":62804},{"value":62806},{"value":62803},{"value":62802},{"value":62801},{"value":62811},{"value":62807},{"value":62805},{"value":62810}]}`
97
- >
98
- > # [English]
99
- > ### Purpose:
100
- > - Get vertical content tags
101
- > ### Parameters:
102
- > - None
103
- > ### Return:
104
- > - Vertical content tags
105
- > ### Note:
106
- > - This interface is used to obtain vertical content tags, used to construct the query_tag parameter
107
- > ### Example:
108
- > Given the top-level vertical content tag `Food`, its top-level vertical id is `628`; `Food`'s sub-vertical tag `Wine Tasting`, its sub-vertical id is `62802`.
109
- > Then the constructed tag query parameter is `{"value": 628, "children": [{"value": 62808}]}`
110
- >
111
- > If you need multiple sub-vertical tags, all food sub-vertical tags are `{"value":628,"children":[{"value":62808},{"value":62804},{"value":62806},{"value":62803},{"value":62802},{"value":62801},{"value":62811},{"value":62807},{"value":62805},{"value":62810}]}`
112
-
113
- #### Parameters
114
-
115
- None
116
-
117
- #### Request Body
118
-
119
- None
120
-
121
- #### Success Response
122
-
123
- ##### `200 application/json`
124
-
125
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
126
-
127
- | Field | Type | Required | Description | Default | Example | Enum |
128
- | --- | --- | --- | --- | --- | --- | --- |
129
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
130
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
131
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
132
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
133
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
134
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
135
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
136
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
137
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
138
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
139
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
140
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
141
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
142
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
143
- | data | null | No | The response data \| 响应数据 | None | None | None |
144
-
145
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-account-fans-interest-account-list"></a>
146
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_account_fans_interest_account_list`
147
-
148
- - Summary: 获取粉丝兴趣作者 20个用户/Fetch fan interest author 20 users
149
- - Capabilities: trends / rankings
150
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
151
- - operationId: `fetch_hot_account_fans_interest_account_list_api_v1_douyin_billboard_fetch_hot_account_fans_interest_account_list_get`
152
-
153
- #### Notes
154
-
155
- > # [中文]
156
- > ### 用途:
157
- > - 获取粉丝兴趣作者 20个用户
158
- > ### 参数:
159
- > - sec_uid: 用户sec_id
160
- > ### 返回:
161
- > - 粉丝兴趣作者 20个用户
162
- >
163
- > # [English]
164
- > ### Purpose:
165
- > - Get the fan interest author 20 users
166
- > ### Parameters:
167
- > - sec_uid: User sec_id
168
- > ### Return:
169
- > - Fan interest author 20 users
170
-
171
- #### Parameters
172
-
173
- | Field | In | Type | Required | Description | Default | Example | Enum |
174
- | --- | --- | --- | --- | --- | --- | --- | --- |
175
- | sec_uid | query | string | Yes | 用户sec_id | None | MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4 | None |
176
-
177
- #### Request Body
178
-
179
- None
180
-
181
- #### Success Response
182
-
183
- ##### `200 application/json`
184
-
185
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
186
-
187
- | Field | Type | Required | Description | Default | Example | Enum |
188
- | --- | --- | --- | --- | --- | --- | --- |
189
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
190
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
191
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
192
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
193
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
194
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
195
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
196
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
197
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
198
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
199
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
200
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
201
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
202
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
203
- | data | null | No | The response data \| 响应数据 | None | None | None |
204
-
205
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-account-fans-interest-search-list"></a>
206
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_account_fans_interest_search_list`
207
-
208
- - Summary: 获取粉丝近3天搜索词 10个搜索词/Fetch fan interest search term in the last 3 days 10 search terms
209
- - Capabilities: search / trends / rankings
210
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
211
- - operationId: `fetch_hot_account_fans_interest_search_list_api_v1_douyin_billboard_fetch_hot_account_fans_interest_search_list_get`
212
-
213
- #### Notes
214
-
215
- > # [中文]
216
- > ### 用途:
217
- > - 获取粉丝近3天搜索词 10个搜索词
218
- > ### 参数:
219
- > - sec_uid: 用户sec_id
220
- > ### 返回:
221
- > - 粉丝近3天搜索词 10个搜索词
222
- >
223
- > # [English]
224
- > ### Purpose:
225
- > - Get the fan interest search term in the last 3 days 10 search terms
226
- > ### Parameters:
227
- > - sec_uid: User sec_id
228
- > ### Return:
229
- > - Fan interest search term in the last 3 days 10 search terms
230
-
231
- #### Parameters
232
-
233
- | Field | In | Type | Required | Description | Default | Example | Enum |
234
- | --- | --- | --- | --- | --- | --- | --- | --- |
235
- | sec_uid | query | string | Yes | 用户sec_id | None | MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4 | None |
236
-
237
- #### Request Body
238
-
239
- None
240
-
241
- #### Success Response
242
-
243
- ##### `200 application/json`
244
-
245
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
246
-
247
- | Field | Type | Required | Description | Default | Example | Enum |
248
- | --- | --- | --- | --- | --- | --- | --- |
249
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
250
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
251
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
252
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
253
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
254
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
255
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
256
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
257
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
258
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
259
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
260
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
261
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
262
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
263
- | data | null | No | The response data \| 响应数据 | None | None | None |
264
-
265
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-account-fans-interest-topic-list"></a>
266
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_account_fans_interest_topic_list`
267
-
268
- - Summary: 获取粉丝近3天感兴趣的话题 10个话题/Fetch fan interest topic in the last 3 days 10 topics
269
- - Capabilities: trends / rankings / topics
270
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
271
- - operationId: `fetch_hot_account_fans_interest_topic_list_api_v1_douyin_billboard_fetch_hot_account_fans_interest_topic_list_get`
272
-
273
- #### Notes
274
-
275
- > # [中文]
276
- > ### 用途:
277
- > - 获取粉丝近3天感兴趣的话题 10个话题
278
- > ### 参数:
279
- > - sec_uid: 用户sec_id
280
- > ### 返回:
281
- > - 粉丝近3天感兴趣的话题 10个话题
282
- >
283
- > # [English]
284
- > ### Purpose:
285
- > - Get the fan interest topic in the last 3 days 10 topics
286
- > ### Parameters:
287
- > - sec_uid: User sec_id
288
- > ### Return:
289
- > - Fan interest topic in the last 3 days 10 topics
290
-
291
- #### Parameters
292
-
293
- | Field | In | Type | Required | Description | Default | Example | Enum |
294
- | --- | --- | --- | --- | --- | --- | --- | --- |
295
- | sec_uid | query | string | Yes | 用户sec_id | None | MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4 | None |
296
-
297
- #### Request Body
298
-
299
- None
300
-
301
- #### Success Response
302
-
303
- ##### `200 application/json`
304
-
305
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
306
-
307
- | Field | Type | Required | Description | Default | Example | Enum |
308
- | --- | --- | --- | --- | --- | --- | --- |
309
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
310
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
311
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
312
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
313
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
314
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
315
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
316
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
317
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
318
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
319
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
320
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
321
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
322
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
323
- | data | null | No | The response data \| 响应数据 | None | None | None |
324
-
325
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-account-fans-portrait-list"></a>
326
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_account_fans_portrait_list`
327
-
328
- - Summary: 获取粉丝画像/Fetch fan portrait
329
- - Capabilities: trends / rankings
330
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
331
- - operationId: `fetch_hot_account_fans_portrait_list_api_v1_douyin_billboard_fetch_hot_account_fans_portrait_list_get`
332
-
333
- #### Notes
334
-
335
- > # [中文]
336
- > ### 用途:
337
- > - 获取粉丝画像
338
- > ### 参数:
339
- > - sec_uid: 用户sec_id
340
- > - option: 选项,默认值为:1 手机价格分布
341
- > - `1` = 手机价格分布
342
- > - `2` = 性别分布
343
- > - `3` = 年龄分布
344
- > - `4` = 地域分布-省份
345
- > - `5` = 地域分布-城市
346
- > - `6` = 城市等级
347
- > - `7` = 手机品牌分布
348
- > - `8` = 兴趣标签分析 百分比
349
- > ### 返回:
350
- > - 粉丝画像
351
- >
352
- > # [English]
353
- > ### Purpose:
354
- > - Get the fan portrait
355
- > ### Parameters:
356
- > - sec_uid: User sec_id
357
- > - option: Option
358
- > - 1 Mobile price
359
- > - 2 Gender distribution
360
- > - 3 Age distribution
361
- > - 4 Regional distribution - province
362
- > - 5 Regional distribution - city
363
- > - 6 City level
364
- > - 7 Mobile brand distribution
365
- > - 8 Interest tag analysis percentage
366
- > ### Return:
367
- > - Fan portrait
368
-
369
- #### Parameters
370
-
371
- | Field | In | Type | Required | Description | Default | Example | Enum |
372
- | --- | --- | --- | --- | --- | --- | --- | --- |
373
- | sec_uid | query | string | Yes | 用户sec_id | None | MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4 | None |
374
- | option | query | integer | No | 选项,1 手机价格分布 2 性别分布 3 年龄分布 4 地域分布-省份 5 地域分布-城市 6 城市等级 7 手机品牌分布 8 兴趣标签分析 百分比 | 1 | 1 | None |
375
-
376
- #### Request Body
377
-
378
- None
379
-
380
- #### Success Response
381
-
382
- ##### `200 application/json`
383
-
384
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
385
-
386
- | Field | Type | Required | Description | Default | Example | Enum |
387
- | --- | --- | --- | --- | --- | --- | --- |
388
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
389
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
390
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
391
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
392
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
393
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
394
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
395
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
396
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
397
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
398
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
399
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
400
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
401
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
402
- | data | null | No | The response data \| 响应数据 | None | None | None |
403
-
404
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-account-item-analysis-list"></a>
405
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_account_item_analysis_list`
406
-
407
- - Summary: 获取账号作品分析-上周/Fetch account work analysis - last week
408
- - Capabilities: trends / rankings
409
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
410
- - operationId: `fetch_hot_account_item_analysis_list_api_v1_douyin_billboard_fetch_hot_account_item_analysis_list_get`
411
-
412
- #### Notes
413
-
414
- > # [中文]
415
- > ### 用途:
416
- > - 获取账号作品分析
417
- > ### 参数:
418
- > - sec_uid: 用户sec_id
419
- > - day: 天数,默认7天
420
- > ### 返回:
421
- > - 账号作品分析
422
- >
423
- > # [English]
424
- > ### Purpose:
425
- > - Get the account work analysis
426
- > ### Parameters:
427
- > - sec_uid: User sec_id
428
- > - day: Number of days, default 7 days
429
- > ### Return:
430
- > - Account work analysis
431
-
432
- #### Parameters
433
-
434
- | Field | In | Type | Required | Description | Default | Example | Enum |
435
- | --- | --- | --- | --- | --- | --- | --- | --- |
436
- | sec_uid | query | string | Yes | 用户sec_id | None | MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4 | None |
437
-
438
- #### Request Body
439
-
440
- None
441
-
442
- #### Success Response
443
-
444
- ##### `200 application/json`
445
-
446
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
447
-
448
- | Field | Type | Required | Description | Default | Example | Enum |
449
- | --- | --- | --- | --- | --- | --- | --- |
450
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
451
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
452
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
453
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
454
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
455
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
456
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
457
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
458
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
459
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
460
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
461
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
462
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
463
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
464
- | data | null | No | The response data \| 响应数据 | None | None | None |
465
-
466
- <a id="post-api-u1-v1-douyin-billboard-fetch-hot-account-list"></a>
467
- ### `POST /api/u1/v1/douyin/billboard/fetch_hot_account_list`
468
-
469
- - Summary: 获取热门账号/Fetch hot account list
470
- - Capabilities: trends / rankings
471
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
472
- - operationId: `fetch_hot_account_list_api_v1_douyin_billboard_fetch_hot_account_list_post`
473
-
474
- #### Notes
475
-
476
- > # [中文]
477
- > ### 用途:
478
- > - 获取热门账号
479
- > ### 参数:
480
- > - date_window: 时间窗口,格式 小时,默认24小时
481
- > - page_num: 页码,默认1
482
- > - page_size: 每页数量,默认20
483
- > - query_tag: 子级垂类标签,空则为全部,多个标签需传入
484
- > {"value": "{顶级垂类标签id}", "children": [
485
- > {"value": "{子级垂类标签id}"},
486
- > {"value": "{子级垂类标签id}"}
487
- > ]}
488
- > ### 返回:
489
- > - 热门账号
490
- >
491
- > # [English]
492
- > ### Purpose:
493
- > - Get the hot account
494
- > ### Parameters:
495
- > - date_window: Time window, format hour, default 24 hours
496
- > - page_num: Page number, default 1
497
- > - page_size: Number of items per page, default 20
498
- > - query_tag: Sub-level vertical category tag, empty for all, multiple tags need to be passed in
499
- > {"value": "{top-level vertical category id}", "children": [
500
- > {"value": "{sub-level vertical category id}"},
501
- > {"value": "{sub-level vertical category id}"}
502
- > ]}
503
- > ### Return:
504
- > - Hot account
505
-
506
- #### Parameters
507
-
508
- None
509
-
510
- #### Request Body
511
-
512
- - required: No
513
-
514
- ##### `application/json`
515
-
516
- - Schema summary: `date_window`:integer, `page_num`:integer, `page_size`:integer, `query_tag`{...}
517
-
518
- | Field | Type | Required | Description | Default | Example | Enum |
519
- | --- | --- | --- | --- | --- | --- | --- |
520
- | date_window | integer | No | 时间窗口,格式 小时,默认24小时 | 24 | None | None |
521
- | page_num | integer | No | 页码,默认1 | 1 | None | None |
522
- | page_size | integer | No | 每页数量,默认10 | 10 | None | None |
523
- | query_tag | object | No | 子级垂类标签,空则为全部,多个标签需传入{"value": "{顶级垂类标签id}", "children": [{"value": "{子级垂类标签id}"}, {"value": "{子级垂类标签id}"}]} | None | None | None |
524
-
525
- #### Success Response
526
-
527
- ##### `200 application/json`
528
-
529
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
530
-
531
- | Field | Type | Required | Description | Default | Example | Enum |
532
- | --- | --- | --- | --- | --- | --- | --- |
533
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
534
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
535
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
536
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
537
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
538
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
539
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
540
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
541
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
542
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
543
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
544
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
545
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
546
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
547
- | data | null | No | The response data \| 响应数据 | None | None | None |
548
-
549
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-account-search-list"></a>
550
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_account_search_list`
551
-
552
- - Summary: 搜索用户名或抖音号/Fetch account search list
553
- - Capabilities: search / trends / rankings
554
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
555
- - operationId: `fetch_hot_account_search_list_api_v1_douyin_billboard_fetch_hot_account_search_list_get`
556
-
557
- #### Notes
558
-
559
- > # [中文]
560
- > ### 用途:
561
- > - 获取搜索用户名或抖音号
562
- > ### 参数:
563
- > - keyword: 搜索的用户名或抖音号
564
- > - cursor: 游标,默认空
565
- > ### 返回:
566
- > - 搜索结果
567
- >
568
- > # [English]
569
- > ### Purpose:
570
- > - Get the search username or Douyin number
571
- > ### Parameters:
572
- > - keyword: Search username or Douyin number
573
- > - cursor: Cursor, default empty
574
- > ### Return:
575
- > - Search result
576
-
577
- #### Parameters
578
-
579
- | Field | In | Type | Required | Description | Default | Example | Enum |
580
- | --- | --- | --- | --- | --- | --- | --- | --- |
581
- | keyword | query | string | Yes | 搜索的用户名或抖音号 | None | rmrbxmt | None |
582
- | cursor | query | integer | Yes | 游标,默认空 | None | 0 | None |
583
-
584
- #### Request Body
585
-
586
- None
587
-
588
- #### Success Response
589
-
590
- ##### `200 application/json`
591
-
592
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
593
-
594
- | Field | Type | Required | Description | Default | Example | Enum |
595
- | --- | --- | --- | --- | --- | --- | --- |
596
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
597
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
598
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
599
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
600
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
601
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
602
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
603
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
604
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
605
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
606
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
607
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
608
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
609
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
610
- | data | null | No | The response data \| 响应数据 | None | None | None |
611
-
612
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-account-trends-list"></a>
613
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_account_trends_list`
614
-
615
- - Summary: 获取账号粉丝数据趋势/Fetch account fan data trend
616
- - Capabilities: trends / rankings
617
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
618
- - operationId: `fetch_hot_account_trends_list_api_v1_douyin_billboard_fetch_hot_account_trends_list_get`
619
-
620
- #### Notes
621
-
622
- > # [中文]
623
- > ### 用途:
624
- > - 获取账号粉丝数据趋势
625
- > ### 参数:
626
- > - sec_uid: 用户sec_id
627
- > - option: 选项,2 新增点赞量 3 新增作品量 4 新增评论量 5 新增分享量
628
- > - date_window: 时间窗口,1 按小时 2 按天
629
- > ### 返回:
630
- > - 账号粉丝数据趋势
631
- >
632
- > # [English]
633
- > ### Purpose:
634
- > - Get the account fan data trend
635
- > ### Parameters:
636
- > - sec_uid: User sec_id
637
- > - option: Option, 2 New like 3 New work 4 New comment 5 New share
638
- > - date_window: Time window, 1 by hour 2 by day
639
- > ### Return:
640
- > - Account fan data trend
641
-
642
- #### Parameters
643
-
644
- | Field | In | Type | Required | Description | Default | Example | Enum |
645
- | --- | --- | --- | --- | --- | --- | --- | --- |
646
- | sec_uid | query | string | Yes | 用户sec_id | None | MS4wLjABAAAA8U_l6rBzmy7bcy6xOJel4v0RzoR_wfAubGPeJimN__4 | None |
647
- | option | query | integer | No | 选项,2 新增点赞量 3 新增作品量 4 新增评论量 5 新增分享量 | 2 | None | None |
648
- | date_window | query | integer | No | 时间窗口,1 按小时 2 按天 | 24 | 24 | None |
649
-
650
- #### Request Body
651
-
652
- None
653
-
654
- #### Success Response
655
-
656
- ##### `200 application/json`
657
-
658
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
659
-
660
- | Field | Type | Required | Description | Default | Example | Enum |
661
- | --- | --- | --- | --- | --- | --- | --- |
662
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
663
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
664
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
665
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
666
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
667
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
668
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
669
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
670
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
671
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
672
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
673
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
674
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
675
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
676
- | data | null | No | The response data \| 响应数据 | None | None | None |
677
-
678
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-calendar-detail"></a>
679
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_calendar_detail`
680
-
681
- - Summary: 获取活动日历详情/Fetch activity calendar detail
682
- - Capabilities: trends / rankings / details
683
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
684
- - operationId: `fetch_hot_calendar_detail_api_v1_douyin_billboard_fetch_hot_calendar_detail_get`
685
-
686
- #### Notes
687
-
688
- > # [中文]
689
- > ### 用途:
690
- > - 获取活动日历详情
691
- > ### 参数:
692
- > - calendar_id: 活动id
693
- > ### 返回:
694
- > - 活动日历详情
695
- >
696
- > # [English]
697
- > ### Purpose:
698
- > - Get the activity calendar details
699
- > ### Parameters:
700
- > - calendar_id: Activity id
701
- > ### Return:
702
- > - Activity calendar details
703
-
704
- #### Parameters
705
-
706
- | Field | In | Type | Required | Description | Default | Example | Enum |
707
- | --- | --- | --- | --- | --- | --- | --- | --- |
708
- | calendar_id | query | string | Yes | 活动id | None | 1720 | None |
709
-
710
- #### Request Body
711
-
712
- None
713
-
714
- #### Success Response
715
-
716
- ##### `200 application/json`
717
-
718
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
719
-
720
- | Field | Type | Required | Description | Default | Example | Enum |
721
- | --- | --- | --- | --- | --- | --- | --- |
722
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
723
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
724
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
725
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
726
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
727
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
728
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
729
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
730
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
731
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
732
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
733
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
734
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
735
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
736
- | data | null | No | The response data \| 响应数据 | None | None | None |
737
-
738
- <a id="post-api-u1-v1-douyin-billboard-fetch-hot-calendar-list"></a>
739
- ### `POST /api/u1/v1/douyin/billboard/fetch_hot_calendar_list`
740
-
741
- - Summary: 获取活动日历/Fetch activity calendar
742
- - Capabilities: trends / rankings
743
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
744
- - operationId: `fetch_hot_calendar_list_api_v1_douyin_billboard_fetch_hot_calendar_list_post`
745
-
746
- #### Notes
747
-
748
- > # [中文]
749
- > ### 用途:
750
- > - 获取活动日历
751
- > ### 参数:
752
- > - city_code: 城市编码,从城市列表获取,空为全部
753
- > - category_code: 热点榜分类编码,从热点榜分类获取,空为全部
754
- > - end_date: 快照结束时间 格式10位时间戳
755
- > - start_date: 快照开始时间 格式10位时间戳
756
- > ### 返回:
757
- > - 活动日历
758
- >
759
- > # [English]
760
- > ### Purpose:
761
- > - Get the activity calendar
762
- > ### Parameters:
763
- > - city_code: City code, get from city list, empty for all
764
- > - category_code: Hot list category code, get from hot list category, empty for all
765
- > - end_date: Snapshot end time format 10 digit timestamp
766
- > - start_date: Snapshot start time format 10 digit timestamp
767
- > ### Return:
768
- > - Activity calendar
769
-
770
- #### Parameters
771
-
772
- None
773
-
774
- #### Request Body
775
-
776
- - required: No
777
-
778
- ##### `application/json`
779
-
780
- - Schema summary: `city_code`:string, `category_code`:string, `end_date`:integer, `start_date`:integer
781
-
782
- | Field | Type | Required | Description | Default | Example | Enum |
783
- | --- | --- | --- | --- | --- | --- | --- |
784
- | city_code | string | No | 城市编码,从城市列表获取,空为全部 | None | None | None |
785
- | category_code | string | No | 热点榜分类编码,从热点榜分类获取,空为全部 | None | None | None |
786
- | end_date | integer | No | 快照结束时间 格式10位时间戳 | 1735488000 | None | None |
787
- | start_date | integer | No | 快照开始时间 格式10位时间戳 | 1734902400 | None | None |
788
-
789
- #### Success Response
790
-
791
- ##### `200 application/json`
792
-
793
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
794
-
795
- | Field | Type | Required | Description | Default | Example | Enum |
796
- | --- | --- | --- | --- | --- | --- | --- |
797
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
798
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
799
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
800
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
801
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
802
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
803
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
804
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
805
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
806
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
807
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
808
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
809
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
810
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
811
- | data | null | No | The response data \| 响应数据 | None | None | None |
812
-
813
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-category-list"></a>
814
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_category_list`
815
-
816
- - Summary: 获取热点榜分类/Fetch hot list category
817
- - Capabilities: trends / rankings
818
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
819
- - operationId: `fetch_hot_category_list_api_v1_douyin_billboard_fetch_hot_category_list_get`
820
-
821
- #### Notes
822
-
823
- > # [中文]
824
- > ### 用途:
825
- > - 获取热点榜分类的id与热度
826
- > - 注意:使用start_date和end_date参数需要移除snapshot_time参数才可以生效
827
- > ### 参数:
828
- > - billboard_type: 榜单类型
829
- > - rise 上升热点榜
830
- > - city 城市热点榜
831
- > - total 热点总榜
832
- > - snapshot_time: 快照时间
833
- > - start_date: 快照开始时间
834
- > - end_date: 快照结束时间
835
- > - keyword: 热点搜索词
836
- > ### 返回:
837
- > - 热点榜分类
838
- >
839
- > # [English]
840
- > ### Purpose:
841
- > - Get the id and popularity of the hot list category
842
- > - Note: Using start_date and end_date parameters requires removing the snapshot_time parameter
843
- > - Note: snapshot_time and start_date, end_date parameters cannot be empty at the same time
844
- > ### Parameters:
845
- > - billboard_type: Billboard type
846
- > - rise Rising hot list
847
- > - city City hot list
848
- > - total Total hot list
849
- > - snapshot_time: Snapshot time
850
- > - start_date: Snapshot start time
851
- > - end_date: Snapshot end time
852
- > - keyword: Hot search term
853
- > ### Return:
854
- > - Hot category list
855
-
856
- #### Parameters
857
-
858
- | Field | In | Type | Required | Description | Default | Example | Enum |
859
- | --- | --- | --- | --- | --- | --- | --- | --- |
860
- | billboard_type | query | string | Yes | 榜单类型 | None | rise | None |
861
- | snapshot_time | query | string | No | 快照时间 格式yyyyMMddHHmmss | 20250106151500 | None | None |
862
- | start_date | query | string | No | 快照开始时间 格式yyyyMMdd | None | None | None |
863
- | end_date | query | string | No | 快照结束时间 格式yyyyMMdd | None | None | None |
864
- | keyword | query | string | No | 热点搜索词 | None | None | None |
865
-
866
- #### Request Body
867
-
868
- None
869
-
870
- #### Success Response
871
-
872
- ##### `200 application/json`
873
-
874
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
875
-
876
- | Field | Type | Required | Description | Default | Example | Enum |
877
- | --- | --- | --- | --- | --- | --- | --- |
878
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
879
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
880
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
881
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
882
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
883
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
884
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
885
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
886
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
887
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
888
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
889
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
890
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
891
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
892
- | data | null | No | The response data \| 响应数据 | None | None | None |
893
-
894
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-challenge-list"></a>
895
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_challenge_list`
896
-
897
- - Summary: 获取挑战热榜/Fetch hot challenge list
898
- - Capabilities: trends / rankings / topics
899
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
900
- - operationId: `fetch_hot_challenge_list_api_v1_douyin_billboard_fetch_hot_challenge_list_get`
901
-
902
- #### Notes
903
-
904
- > # [中文]
905
- > ### 用途:
906
- > - 获取挑战榜
907
- > ### 参数:
908
- > - page: 页码
909
- > - page_size: 每页数量
910
- > - keyword: 热点搜索词
911
- > ### 返回:
912
- > - 挑战榜
913
- >
914
- > # [English]
915
- > ### Purpose:
916
- > - Get the challenge list
917
- > ### Parameters:
918
- > - page: Page number
919
- > - page_size: Number of items per page
920
- > - keyword: Hot search term
921
- > ### Return:
922
- > - Challenge list
923
-
924
- #### Parameters
925
-
926
- | Field | In | Type | Required | Description | Default | Example | Enum |
927
- | --- | --- | --- | --- | --- | --- | --- | --- |
928
- | page | query | integer | Yes | 页码 | None | 1 | None |
929
- | page_size | query | integer | Yes | 每页数量 | None | 10 | None |
930
- | keyword | query | string | No | 热点搜索词 | None | None | None |
931
-
932
- #### Request Body
933
-
934
- None
935
-
936
- #### Success Response
937
-
938
- ##### `200 application/json`
939
-
940
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
941
-
942
- | Field | Type | Required | Description | Default | Example | Enum |
943
- | --- | --- | --- | --- | --- | --- | --- |
944
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
945
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
946
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
947
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
948
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
949
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
950
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
951
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
952
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
953
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
954
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
955
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
956
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
957
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
958
- | data | null | No | The response data \| 响应数据 | None | None | None |
959
-
960
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-city-list"></a>
961
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_city_list`
962
-
963
- - Summary: 获取同城热点榜/Fetch city hot list
964
- - Capabilities: trends / rankings
965
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
966
- - operationId: `fetch_hot_city_list_api_v1_douyin_billboard_fetch_hot_city_list_get`
967
-
968
- #### Notes
969
-
970
- > # [中文]
971
- > ### 用途:
972
- > - 获取同城热点榜
973
- > ### 参数:
974
- > - page: 页码
975
- > - page_size: 每页数量
976
- > - order: 排序方式
977
- > - rank 按热度排序
978
- > - rank_diff 按排名变化
979
- > - city_code: 城市编码,从城市列表获取,空为全部
980
- > - sentence_tag: 热点分类标签,从热点榜分类获取,多个分类用逗号分隔,空为全部
981
- > - keyword: 热点搜索词
982
- > ### 返回:
983
- > - 同城热点榜
984
- >
985
- > # [English]
986
- > ### Purpose:
987
- > - Get the city hot list
988
- > ### Parameters:
989
- > - page: Page number
990
- > - page_size: Number of items per page
991
- > - order: Sorting method
992
- > - rank Sort by popularity
993
- > - rank_diff Sort by ranking change
994
- > - city_code: City code, get from city list, empty for all
995
- > - sentence_tag: Hot category tag, get from hot list category, multiple categories separated by commas, empty for all
996
- > - keyword: Hot search term
997
- > ### Return:
998
- > - City hot list
999
-
1000
- #### Parameters
1001
-
1002
- | Field | In | Type | Required | Description | Default | Example | Enum |
1003
- | --- | --- | --- | --- | --- | --- | --- | --- |
1004
- | page | query | integer | Yes | 页码 | None | 1 | None |
1005
- | page_size | query | integer | Yes | 每页数量 | None | 10 | None |
1006
- | order | query | string | Yes | 排序方式 | None | None | None |
1007
- | city_code | query | string | No | 城市编码,从城市列表获取,空为全部 | None | None | None |
1008
- | sentence_tag | query | string | No | 热点分类标签,从热点榜分类获取,多个分类用逗号分隔,空为全部 | None | None | None |
1009
- | keyword | query | string | No | 热点搜索词 | None | None | None |
1010
-
1011
- #### Request Body
1012
-
1013
- None
1014
-
1015
- #### Success Response
1016
-
1017
- ##### `200 application/json`
1018
-
1019
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1020
-
1021
- | Field | Type | Required | Description | Default | Example | Enum |
1022
- | --- | --- | --- | --- | --- | --- | --- |
1023
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1024
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1025
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1026
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1027
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1028
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1029
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1030
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1031
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1032
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
1033
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1034
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1035
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1036
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1037
- | data | null | No | The response data \| 响应数据 | None | None | None |
1038
-
1039
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-comment-word-list"></a>
1040
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_comment_word_list`
1041
-
1042
- - Summary: 获取作品评论分析-词云权重/Fetch work comment analysis word cloud weight
1043
- - Capabilities: comments / trends / rankings
1044
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1045
- - operationId: `fetch_hot_comment_word_list_api_v1_douyin_billboard_fetch_hot_comment_word_list_get`
1046
-
1047
- #### Notes
1048
-
1049
- > # [中文]
1050
- > ### 用途:
1051
- > - 获取作品评论分析-词云权重
1052
- > ### 参数:
1053
- > - aweme_id: 作品id
1054
- > ### 返回:
1055
- > - 作品评论分析-词云权重
1056
- >
1057
- > # [English]
1058
- > ### Purpose:
1059
- > - Get the work comment analysis word cloud weight
1060
- > ### Parameters:
1061
- > - aweme_id: Work id
1062
- > ### Return:
1063
- > - Work comment analysis word cloud weight
1064
-
1065
- #### Parameters
1066
-
1067
- | Field | In | Type | Required | Description | Default | Example | Enum |
1068
- | --- | --- | --- | --- | --- | --- | --- | --- |
1069
- | aweme_id | query | string | Yes | 作品id | None | 7456035425539329340 | None |
1070
-
1071
- #### Request Body
1072
-
1073
- None
1074
-
1075
- #### Success Response
1076
-
1077
- ##### `200 application/json`
1078
-
1079
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1080
-
1081
- | Field | Type | Required | Description | Default | Example | Enum |
1082
- | --- | --- | --- | --- | --- | --- | --- |
1083
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1084
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1085
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1086
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1087
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1088
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1089
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1090
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1091
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1092
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
1093
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1094
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1095
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1096
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1097
- | data | null | No | The response data \| 响应数据 | None | None | None |
1098
-
1099
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-item-trends-list"></a>
1100
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_item_trends_list`
1101
-
1102
- - Summary: 获取作品数据趋势/Fetch post data trend
1103
- - Capabilities: trends / rankings
1104
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1105
- - operationId: `fetch_hot_item_trends_list_api_v1_douyin_billboard_fetch_hot_item_trends_list_get`
1106
-
1107
- #### Notes
1108
-
1109
- > # [中文]
1110
- > ### 用途:
1111
- > - 获取作品数据趋势
1112
- > ### 参数:
1113
- > - aweme_id: 作品id
1114
- > - option: 选项,7 点赞量 8 分享量 9 评论量
1115
- > - date_window: 时间窗口,1 按小时 2 按天
1116
- > ### 返回:
1117
- > - 作品数据趋势
1118
- >
1119
- > # [English]
1120
- > ### Purpose:
1121
- > - Get the work data trend
1122
- > ### Parameters:
1123
- > - aweme_id: Work id
1124
- > - option: Option, 7 Like 8 Share 9 Comment
1125
- > - date_window: Time window, 1 by hour 2 by day
1126
- > ### Return:
1127
- > - Work data trend
1128
-
1129
- #### Parameters
1130
-
1131
- | Field | In | Type | Required | Description | Default | Example | Enum |
1132
- | --- | --- | --- | --- | --- | --- | --- | --- |
1133
- | aweme_id | query | string | No | 作品id | None | None | None |
1134
- | option | query | integer | No | 选项,7 点赞量 8 分享量 9 评论量 | 7 | None | None |
1135
- | date_window | query | integer | No | 时间窗口,1 按小时 2 按天 | 1 | None | None |
1136
-
1137
- #### Request Body
1138
-
1139
- None
1140
-
1141
- #### Success Response
1142
-
1143
- ##### `200 application/json`
1144
-
1145
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1146
-
1147
- | Field | Type | Required | Description | Default | Example | Enum |
1148
- | --- | --- | --- | --- | --- | --- | --- |
1149
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1150
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1151
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1152
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1153
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1154
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1155
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1156
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1157
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1158
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
1159
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1160
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1161
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1162
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1163
- | data | null | No | The response data \| 响应数据 | None | None | None |
1164
-
1165
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-rise-list"></a>
1166
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_rise_list`
1167
-
1168
- - Summary: 获取上升热点榜/Fetch rising hot list
1169
- - Capabilities: trends / rankings
1170
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1171
- - operationId: `fetch_hot_rise_list_api_v1_douyin_billboard_fetch_hot_rise_list_get`
1172
-
1173
- #### Notes
1174
-
1175
- > # [中文]
1176
- > ### 用途:
1177
- > - 获取上升热点榜
1178
- > ### 参数:
1179
- > - page: 页码
1180
- > - page_size: 每页数量
1181
- > - order: 排序方式
1182
- > - rank 按热度排序
1183
- > - rank_diff 按排名变化
1184
- > - sentence_tag: 热点分类标签,从热点榜分类获取,多个分类用逗号分隔,空为全部
1185
- > - keyword: 热点搜索词
1186
- > ### 返回:
1187
- > - 上升热点榜
1188
- >
1189
- > # [English]
1190
- > ### Purpose:
1191
- > - Get the rising hot list
1192
- > ### Parameters:
1193
- > - page: Page number
1194
- > - page_size: Number of items per page
1195
- > - order: Sorting method
1196
- > - rank Sort by popularity
1197
- > - rank_diff Sort by ranking change
1198
- > - sentence_tag: Hot category tag, get from hot list category, multiple categories separated by commas, empty for all
1199
- > - keyword: Hot search term
1200
- > ### Return:
1201
- > - Rising hot list
1202
-
1203
- #### Parameters
1204
-
1205
- | Field | In | Type | Required | Description | Default | Example | Enum |
1206
- | --- | --- | --- | --- | --- | --- | --- | --- |
1207
- | page | query | integer | Yes | 页码 | None | 1 | None |
1208
- | page_size | query | integer | Yes | 每页数量 | None | 10 | None |
1209
- | order | query | string | Yes | 排序方式 | None | rank | None |
1210
- | sentence_tag | query | string | No | 热点分类标签,从热点榜分类获取,多个分类用逗号分隔,空为全部 | None | None | None |
1211
- | keyword | query | string | No | 热点搜索词 | None | None | None |
1212
-
1213
- #### Request Body
1214
-
1215
- None
1216
-
1217
- #### Success Response
1218
-
1219
- ##### `200 application/json`
1220
-
1221
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1222
-
1223
- | Field | Type | Required | Description | Default | Example | Enum |
1224
- | --- | --- | --- | --- | --- | --- | --- |
1225
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1226
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1227
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1228
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1229
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1230
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1231
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1232
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1233
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1234
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
1235
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1236
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1237
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1238
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1239
- | data | null | No | The response data \| 响应数据 | None | None | None |
1240
-
1241
- <a id="post-api-u1-v1-douyin-billboard-fetch-hot-total-high-fan-list"></a>
1242
- ### `POST /api/u1/v1/douyin/billboard/fetch_hot_total_high_fan_list`
1243
-
1244
- - Summary: 获取高涨粉率榜/Fetch high fan rate list
1245
- - Capabilities: trends / rankings
1246
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1247
- - operationId: `fetch_hot_total_high_fan_list_api_v1_douyin_billboard_fetch_hot_total_high_fan_list_post`
1248
-
1249
- #### Notes
1250
-
1251
- > # [中文]
1252
- > ### 用途:
1253
- > - 获取高涨粉率榜
1254
- > ### 参数:
1255
- > - page: 页码
1256
- > - page_size: 每页数量
1257
- > - date_window: 时间窗口,1 按小时 2 按天
1258
- > - tags: 子级垂类标签,空则为全部,多个标签需传入
1259
- > {"value": "{顶级垂类标签id}", "children": [
1260
- > {"value": "{子级垂类标签id}"},
1261
- > {"value": "{子级垂类标签id}"}
1262
- > ]}
1263
- > ### 返回:
1264
- > - 高涨粉率榜
1265
- >
1266
- > # [English]
1267
- > ### Purpose:
1268
- > - Get the high fan rate list
1269
- > ### Parameters:
1270
- > - page: Page number
1271
- > - page_size: Number of items per page
1272
- > - date_window: Time window, 1 by hour 2 by day
1273
- > - tags: Sub-level vertical category tag, empty for all, multiple tags need to be passed in
1274
- > {"value": "{top-level vertical category id}", "children": [
1275
- > {"value": "{sub-level vertical category id}"},
1276
- > {"value": "{sub-level vertical category id}"}
1277
- > ]}
1278
- > ### Return:
1279
- > - High fan rate list
1280
-
1281
- #### Parameters
1282
-
1283
- None
1284
-
1285
- #### Request Body
1286
-
1287
- - required: No
1288
-
1289
- ##### `application/json`
1290
-
1291
- - Schema summary: `page`:integer, `page_size`:integer, `date_window`:integer, `tags`[object]
1292
-
1293
- | Field | Type | Required | Description | Default | Example | Enum |
1294
- | --- | --- | --- | --- | --- | --- | --- |
1295
- | page | integer | No | 页码 | 1 | None | None |
1296
- | page_size | integer | No | 每页数量 | 10 | None | None |
1297
- | date_window | integer | No | 时间窗口,1 按小时 2 按天 | 24 | None | None |
1298
- | tags | array<object> | No | 子级垂类标签,空则为全部,多个标签需传入{"value": "{顶级垂类标签id}", "children": [{"value": "{子级垂类标签id}"}, {"value": "{子级垂类标签id}"}]} | None | None | None |
1299
- | tags[] | object | Yes | None | None | None | None |
1300
-
1301
- #### Success Response
1302
-
1303
- ##### `200 application/json`
1304
-
1305
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1306
-
1307
- | Field | Type | Required | Description | Default | Example | Enum |
1308
- | --- | --- | --- | --- | --- | --- | --- |
1309
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1310
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1311
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1312
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1313
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1314
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1315
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1316
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1317
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1318
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
1319
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1320
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1321
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1322
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1323
- | data | null | No | The response data \| 响应数据 | None | None | None |
1324
-
1325
- <a id="post-api-u1-v1-douyin-billboard-fetch-hot-total-high-like-list"></a>
1326
- ### `POST /api/u1/v1/douyin/billboard/fetch_hot_total_high_like_list`
1327
-
1328
- - Summary: 获取高点赞率榜/Fetch high like rate list
1329
- - Capabilities: trends / rankings
1330
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1331
- - operationId: `fetch_hot_total_high_like_list_api_v1_douyin_billboard_fetch_hot_total_high_like_list_post`
1332
-
1333
- #### Notes
1334
-
1335
- > # [中文]
1336
- > ### 用途:
1337
- > - 获取高点赞率榜
1338
- > ### 参数:
1339
- > - page: 页码
1340
- > - page_size: 每页数量
1341
- > - date_window: 时间窗口,1 按小时 2 按天
1342
- > - tags: 子级垂类标签,空则为全部,多个标签需传入
1343
- > {"value": "{顶级垂类标签id}", "children": [
1344
- > {"value": "{子级垂类标签id}"},
1345
- > {"value": "{子级垂类标签id}"}
1346
- > ]}
1347
- > ### 返回:
1348
- > - 高点赞率榜
1349
- >
1350
- > # [English]
1351
- > ### Purpose:
1352
- > - Get the high like rate list
1353
- > ### Parameters:
1354
- > - page: Page number
1355
- > - page_size: Number of items per page
1356
- > - date_window: Time window, 1 by hour 2 by day
1357
- > - tags: Sub-level vertical category tag, empty for all, multiple tags need to be passed in
1358
- > {"value": "{top-level vertical category id}", "children": [
1359
- > {"value": "{sub-level vertical category id}"},
1360
- > {"value": "{sub-level vertical category id}"}
1361
- > ]}
1362
- > ### Return:
1363
- > - High like rate list
1364
-
1365
- #### Parameters
1366
-
1367
- None
1368
-
1369
- #### Request Body
1370
-
1371
- - required: No
1372
-
1373
- ##### `application/json`
1374
-
1375
- - Schema summary: `page`:integer, `page_size`:integer, `date_window`:integer, `tags`[object]
1376
-
1377
- | Field | Type | Required | Description | Default | Example | Enum |
1378
- | --- | --- | --- | --- | --- | --- | --- |
1379
- | page | integer | No | 页码 | 1 | None | None |
1380
- | page_size | integer | No | 每页数量 | 10 | None | None |
1381
- | date_window | integer | No | 时间窗口,1 按小时 2 按天 | 24 | None | None |
1382
- | tags | array<object> | No | 子级垂类标签,空则为全部,多个标签需传入{"value": "{顶级垂类标签id}", "children": [{"value": "{子级垂类标签id}"}, {"value": "{子级垂类标签id}"}]} | None | None | None |
1383
- | tags[] | object | Yes | None | None | None | None |
1384
-
1385
- #### Success Response
1386
-
1387
- ##### `200 application/json`
1388
-
1389
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1390
-
1391
- | Field | Type | Required | Description | Default | Example | Enum |
1392
- | --- | --- | --- | --- | --- | --- | --- |
1393
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1394
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1395
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1396
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1397
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1398
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1399
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1400
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1401
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1402
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
1403
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1404
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1405
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1406
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1407
- | data | null | No | The response data \| 响应数据 | None | None | None |
1408
-
1409
- <a id="post-api-u1-v1-douyin-billboard-fetch-hot-total-high-play-list"></a>
1410
- ### `POST /api/u1/v1/douyin/billboard/fetch_hot_total_high_play_list`
1411
-
1412
- - Summary: 获取高完播率榜/Fetch high completion rate list
1413
- - Capabilities: trends / rankings
1414
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1415
- - operationId: `fetch_hot_total_high_play_list_api_v1_douyin_billboard_fetch_hot_total_high_play_list_post`
1416
-
1417
- #### Notes
1418
-
1419
- > # [中文]
1420
- > ### 用途:
1421
- > - 获取高完播率榜
1422
- > ### 参数:
1423
- > - page: 页码
1424
- > - page_size: 每页数量
1425
- > - date_window: 时间窗口,1 按小时 2 按天
1426
- > - tags: 子级垂类标签,空则为全部,多个标签需传入
1427
- > {"value": "{顶级垂类标签id}", "children": [
1428
- > {"value": "{子级垂类标签id}"},
1429
- > {"value": "{子级垂类标签id}"}
1430
- > ]}
1431
- > ### 返回:
1432
- > - 高完播率榜
1433
- >
1434
- > # [English]
1435
- > ### Purpose:
1436
- > - Get the high completion rate list
1437
- > ### Parameters:
1438
- > - page: Page number
1439
- > - page_size: Number of items per page
1440
- > - date_window: Time window, 1 by hour 2 by day
1441
- > - tags: Sub-level vertical category tag, empty for all, multiple tags need to be passed in
1442
- > {"value": "{top-level vertical category id}", "children": [
1443
- > {"value": "{sub-level vertical category id}"},
1444
- > {"value": "{sub-level vertical category id}"}
1445
- > ]}
1446
- > ### Return:
1447
- > - High completion rate list
1448
-
1449
- #### Parameters
1450
-
1451
- None
1452
-
1453
- #### Request Body
1454
-
1455
- - required: No
1456
-
1457
- ##### `application/json`
1458
-
1459
- - Schema summary: `page`:integer, `page_size`:integer, `date_window`:integer, `tags`[object]
1460
-
1461
- | Field | Type | Required | Description | Default | Example | Enum |
1462
- | --- | --- | --- | --- | --- | --- | --- |
1463
- | page | integer | No | 页码 | 1 | None | None |
1464
- | page_size | integer | No | 每页数量 | 10 | None | None |
1465
- | date_window | integer | No | 时间窗口,1 按小时 2 按天 | 24 | None | None |
1466
- | tags | array<object> | No | 子级垂类标签,空则为全部,多个标签需传入{"value": "{顶级垂类标签id}", "children": [{"value": "{子级垂类标签id}"}, {"value": "{子级垂类标签id}"}]} | None | None | None |
1467
- | tags[] | object | Yes | None | None | None | None |
1468
-
1469
- #### Success Response
1470
-
1471
- ##### `200 application/json`
1472
-
1473
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1474
-
1475
- | Field | Type | Required | Description | Default | Example | Enum |
1476
- | --- | --- | --- | --- | --- | --- | --- |
1477
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1478
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1479
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1480
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1481
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1482
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1483
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1484
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1485
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1486
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
1487
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1488
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1489
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1490
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1491
- | data | null | No | The response data \| 响应数据 | None | None | None |
1492
-
1493
- <a id="post-api-u1-v1-douyin-billboard-fetch-hot-total-high-search-list"></a>
1494
- ### `POST /api/u1/v1/douyin/billboard/fetch_hot_total_high_search_list`
1495
-
1496
- - Summary: 获取热度飙升的搜索榜/Fetch search list with rising popularity
1497
- - Capabilities: search / trends / rankings
1498
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1499
- - operationId: `fetch_hot_total_high_search_list_api_v1_douyin_billboard_fetch_hot_total_high_search_list_post`
1500
-
1501
- #### Notes
1502
-
1503
- > # [中文]
1504
- > ### 用途:
1505
- > - 获取热度飙升的搜索榜
1506
- > ### 参数:
1507
- > - page_num: 页码
1508
- > - page_size: 每页数量
1509
- > - date_window: 时间窗口,1 按小时 2 按天
1510
- > - keyword: 搜索关键字
1511
- > ### 返回:
1512
- > - 热度飙升的搜索榜
1513
- >
1514
- > # [English]
1515
- > ### Purpose:
1516
- > - Get the search list with rising popularity
1517
- > ### Parameters:
1518
- > - page_num: Page number
1519
- > - page_size: Number of items per page
1520
- > - date_window: Time window, 1 by hour 2 by day
1521
- > - keyword: Search keyword
1522
- > ### Return:
1523
- > - Search list with rising popularity
1524
-
1525
- #### Parameters
1526
-
1527
- None
1528
-
1529
- #### Request Body
1530
-
1531
- - required: No
1532
-
1533
- ##### `application/json`
1534
-
1535
- - Schema summary: `page_num`:integer, `page_size`:integer, `date_window`:integer, `keyword`:string
1536
-
1537
- | Field | Type | Required | Description | Default | Example | Enum |
1538
- | --- | --- | --- | --- | --- | --- | --- |
1539
- | page_num | integer | No | 页码 | 1 | None | None |
1540
- | page_size | integer | No | 每页数量 | 10 | None | None |
1541
- | date_window | integer | No | 时间窗口,1 按小时 2 按天 | 24 | None | None |
1542
- | keyword | string | No | 搜索关键字 | 抖音 | None | None |
1543
-
1544
- #### Success Response
1545
-
1546
- ##### `200 application/json`
1547
-
1548
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1549
-
1550
- | Field | Type | Required | Description | Default | Example | Enum |
1551
- | --- | --- | --- | --- | --- | --- | --- |
1552
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1553
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1554
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1555
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1556
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1557
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1558
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1559
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1560
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1561
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
1562
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1563
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1564
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1565
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1566
- | data | null | No | The response data \| 响应数据 | None | None | None |
1567
-
1568
- <a id="post-api-u1-v1-douyin-billboard-fetch-hot-total-high-topic-list"></a>
1569
- ### `POST /api/u1/v1/douyin/billboard/fetch_hot_total_high_topic_list`
1570
-
1571
- - Summary: 获取热度飙升的话题榜/Fetch topic list with rising popularity
1572
- - Capabilities: trends / rankings / topics
1573
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1574
- - operationId: `fetch_hot_total_high_topic_list_api_v1_douyin_billboard_fetch_hot_total_high_topic_list_post`
1575
-
1576
- #### Notes
1577
-
1578
- > # [中文]
1579
- > ### 用途:
1580
- > - 获取热度飙升的话题榜
1581
- > ### 参数:
1582
- > - page: 页码
1583
- > - page_size: 每页数量
1584
- > - date_window: 时间窗口,1 按小时 2 按天
1585
- > - tags: 子级垂类标签,空则为全部,多个标签需传入
1586
- > {"value": "{顶级垂类标签id}", "children": [
1587
- > {"value": "{子级垂类标签id}"},
1588
- > {"value": "{子级垂类标签id}"}
1589
- > ]}
1590
- > ### 返回:
1591
- > - 热度飙升的话题榜
1592
- >
1593
- > # [English]
1594
- > ### Purpose:
1595
- > - Get the topic list with rising popularity
1596
- > ### Parameters:
1597
- > - page: Page number
1598
- > - page_size: Number of items per page
1599
- > - date_window: Time window, 1 by hour 2 by day
1600
- > - tags: Sub-level vertical category tag, empty for all, multiple tags need to be passed in
1601
- > {"value": "{top-level vertical category id}", "children": [
1602
- > {"value": "{sub-level vertical category id}"},
1603
- > {"value": "{sub-level vertical category id}"}
1604
- > ]}
1605
- > ### Return:
1606
- > - Topic list with rising popularity
1607
-
1608
- #### Parameters
1609
-
1610
- None
1611
-
1612
- #### Request Body
1613
-
1614
- - required: No
1615
-
1616
- ##### `application/json`
1617
-
1618
- - Schema summary: `page`:integer, `page_size`:integer, `date_window`:integer, `tags`[object]
1619
-
1620
- | Field | Type | Required | Description | Default | Example | Enum |
1621
- | --- | --- | --- | --- | --- | --- | --- |
1622
- | page | integer | No | 页码 | 1 | None | None |
1623
- | page_size | integer | No | 每页数量 | 10 | None | None |
1624
- | date_window | integer | No | 时间窗口,1 按小时 2 按天 | 24 | None | None |
1625
- | tags | array<object> | No | 子级垂类标签,空则为全部,多个标签需传入{"value": "{顶级垂类标签id}", "children": [{"value": "{子级垂类标签id}"}, {"value": "{子级垂类标签id}"}]} | None | None | None |
1626
- | tags[] | object | Yes | None | None | None | None |
1627
-
1628
- #### Success Response
1629
-
1630
- ##### `200 application/json`
1631
-
1632
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1633
-
1634
- | Field | Type | Required | Description | Default | Example | Enum |
1635
- | --- | --- | --- | --- | --- | --- | --- |
1636
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1637
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1638
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1639
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1640
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1641
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1642
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1643
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1644
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1645
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
1646
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1647
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1648
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1649
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1650
- | data | null | No | The response data \| 响应数据 | None | None | None |
1651
-
1652
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-total-hot-word-detail-list"></a>
1653
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_total_hot_word_detail_list`
1654
-
1655
- - Summary: 获取内容词详情/Fetch content word details
1656
- - Capabilities: trends / rankings / details
1657
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1658
- - operationId: `fetch_hot_total_hot_word_detail_list_api_v1_douyin_billboard_fetch_hot_total_hot_word_detail_list_get`
1659
-
1660
- #### Notes
1661
-
1662
- > # [中文]
1663
- > ### 用途:
1664
- > - 获取内容词详情
1665
- > ### 参数:
1666
- > - keyword: 搜索关键字
1667
- > - word_id: 内容词id
1668
- > - query_day: 查询日期,格式为YYYYMMDD
1669
- > ### 返回:
1670
- > - 内容词详情
1671
- >
1672
- > # [English]
1673
- > ### Purpose:
1674
- > - Get the details of content words
1675
- > ### Parameters:
1676
- > - keyword: Search keyword
1677
- > - word_id: Content word id
1678
- > - query_day: Query date, format is YYYYMMDD
1679
- > ### Return:
1680
- > - Details of content words
1681
-
1682
- #### Parameters
1683
-
1684
- | Field | In | Type | Required | Description | Default | Example | Enum |
1685
- | --- | --- | --- | --- | --- | --- | --- | --- |
1686
- | keyword | query | string | Yes | 搜索关键字 | None | None | None |
1687
- | word_id | query | string | Yes | 内容词id | None | None | None |
1688
- | query_day | query | integer | Yes | 查询日期,格式为YYYYMMDD,需为当日 | None | 20250105 | None |
1689
-
1690
- #### Request Body
1691
-
1692
- None
1693
-
1694
- #### Success Response
1695
-
1696
- ##### `200 application/json`
1697
-
1698
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1699
-
1700
- | Field | Type | Required | Description | Default | Example | Enum |
1701
- | --- | --- | --- | --- | --- | --- | --- |
1702
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1703
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1704
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1705
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1706
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1707
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1708
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1709
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1710
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1711
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
1712
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1713
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1714
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1715
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1716
- | data | null | No | The response data \| 响应数据 | None | None | None |
1717
-
1718
- <a id="post-api-u1-v1-douyin-billboard-fetch-hot-total-hot-word-list"></a>
1719
- ### `POST /api/u1/v1/douyin/billboard/fetch_hot_total_hot_word_list`
1720
-
1721
- - Summary: 获取全部热门内容词/Fetch all hot content words
1722
- - Capabilities: trends / rankings
1723
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1724
- - operationId: `fetch_hot_total_hot_word_list_api_v1_douyin_billboard_fetch_hot_total_hot_word_list_post`
1725
-
1726
- #### Notes
1727
-
1728
- > # [中文]
1729
- > ### 用途:
1730
- > - 获取全部内容词
1731
- > ### 参数:
1732
- > - page_num: 页码
1733
- > - page_size: 每页数量
1734
- > - date_window: 时间窗口,1 按小时 2 按天
1735
- > - keyword: 搜索关键字
1736
- > ### 返回:
1737
- > - 全部内容词
1738
- >
1739
- > # [English]
1740
- > ### Purpose:
1741
- > - Get the list of all content words
1742
- > ### Parameters:
1743
- > - page_num: Page number
1744
- > - page_size: Number of items per page
1745
- > - date_window: Time window, 1 by hour 2 by day
1746
- > - keyword: Search keyword
1747
- > ### Return:
1748
- > - List of all content words
1749
-
1750
- #### Parameters
1751
-
1752
- None
1753
-
1754
- #### Request Body
1755
-
1756
- - required: No
1757
-
1758
- ##### `application/json`
1759
-
1760
- - Schema summary: `page_num`:integer, `page_size`:integer, `date_window`:integer, `keyword`:string
1761
-
1762
- | Field | Type | Required | Description | Default | Example | Enum |
1763
- | --- | --- | --- | --- | --- | --- | --- |
1764
- | page_num | integer | No | 页码 | 1 | None | None |
1765
- | page_size | integer | No | 每页数量 | 10 | None | None |
1766
- | date_window | integer | No | 时间窗口,1 按小时 2 按天 | 24 | None | None |
1767
- | keyword | string | No | 搜索关键字 | 抖音 | None | None |
1768
-
1769
- #### Success Response
1770
-
1771
- ##### `200 application/json`
1772
-
1773
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1774
-
1775
- | Field | Type | Required | Description | Default | Example | Enum |
1776
- | --- | --- | --- | --- | --- | --- | --- |
1777
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1778
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1779
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1780
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1781
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1782
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1783
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1784
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1785
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1786
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
1787
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1788
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1789
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1790
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1791
- | data | null | No | The response data \| 响应数据 | None | None | None |
1792
-
1793
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-total-list"></a>
1794
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_total_list`
1795
-
1796
- - Summary: 获取热点总榜/Fetch total hot list
1797
- - Capabilities: trends / rankings
1798
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1799
- - operationId: `fetch_hot_total_list_api_v1_douyin_billboard_fetch_hot_total_list_get`
1800
-
1801
- #### Notes
1802
-
1803
- > # [中文]
1804
- > ### 用途:
1805
- > - 获取热点总榜
1806
- > ### 参数:
1807
- > - page: 页码
1808
- > - page_size: 每页数量
1809
- > - type: 快照类型 snapshot 按时刻查看 range 按时间范围。
1810
- > - 备注:snapshot_time 在 snapshot时有效,start_date 和 end_date 在 range 时有效
1811
- > - snapshot_time: 快照时间 格式yyyyMMddHHmmss
1812
- > - start_date: 快照开始时间 格式yyyyMMdd
1813
- > - end_date: 快照结束时间 格式yyyyMMdd
1814
- > - sentence_tag: 热点分类标签,从热点榜分类获取,多个分类用逗号分隔,空为全部
1815
- > - keyword: 热点搜索词
1816
- > ### 返回:
1817
- > - 热点总榜
1818
- >
1819
- > # [English]
1820
- > ### Purpose:
1821
- > - Get the total hot list
1822
- > ### Parameters:
1823
- > - page: Page number
1824
- > - page_size: Number of items per page
1825
- > - type: Snapshot type snapshot view by time range view by time range.
1826
- > - Note: snapshot_time is valid when snapshot, start_date and end_date are valid when range
1827
- > - snapshot_time: Snapshot time format yyyyMMddHHmmss
1828
- > - start_date: Snapshot start time format yyyyMMdd
1829
- > - end_date: Snapshot end time format yyyyMMdd
1830
- > - sentence_tag: Hot category tag, get from hot list category, multiple categories separated by commas, empty for all
1831
- > - keyword: Hot search term
1832
- > ### Return:
1833
- > - Total hot list
1834
-
1835
- #### Parameters
1836
-
1837
- | Field | In | Type | Required | Description | Default | Example | Enum |
1838
- | --- | --- | --- | --- | --- | --- | --- | --- |
1839
- | page | query | integer | Yes | 页码 | None | 1 | None |
1840
- | page_size | query | integer | Yes | 每页数量 | None | 10 | None |
1841
- | type | query | string | Yes | 快照类型 snapshot 按时刻查看 range 按时间范围 | None | None | None |
1842
- | snapshot_time | query | string | No | 快照时间 格式yyyyMMddHHmmss | 20250106151500 | None | None |
1843
- | start_date | query | string | No | 快照开始时间 格式yyyyMMdd | None | None | None |
1844
- | end_date | query | string | No | 快照结束时间 格式yyyyMMdd | None | None | None |
1845
- | sentence_tag | query | string | No | 热点分类标签,从热点榜分类获取,多个分类用逗号分隔,空为全部 | None | None | None |
1846
- | keyword | query | string | No | 热点搜索词 | None | None | None |
1847
-
1848
- #### Request Body
1849
-
1850
- None
1851
-
1852
- #### Success Response
1853
-
1854
- ##### `200 application/json`
1855
-
1856
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1857
-
1858
- | Field | Type | Required | Description | Default | Example | Enum |
1859
- | --- | --- | --- | --- | --- | --- | --- |
1860
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1861
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1862
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1863
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1864
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1865
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1866
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1867
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1868
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1869
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
1870
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1871
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1872
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1873
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1874
- | data | null | No | The response data \| 响应数据 | None | None | None |
1875
-
1876
- <a id="post-api-u1-v1-douyin-billboard-fetch-hot-total-low-fan-list"></a>
1877
- ### `POST /api/u1/v1/douyin/billboard/fetch_hot_total_low_fan_list`
1878
-
1879
- - Summary: 获取低粉爆款榜/Fetch low fan explosion list
1880
- - Capabilities: trends / rankings
1881
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1882
- - operationId: `fetch_hot_total_low_fan_list_api_v1_douyin_billboard_fetch_hot_total_low_fan_list_post`
1883
-
1884
- #### Notes
1885
-
1886
- > # [中文]
1887
- > ### 用途:
1888
- > - 获取低粉爆款榜
1889
- > ### 参数:
1890
- > - page: 页码
1891
- > - page_size: 每页数量
1892
- > - date_window: 时间窗口,1 按小时 2 按天
1893
- > - tags: 子级垂类标签,空则为全部,多个标签需传入
1894
- > {"value": "{顶级垂类标签id}", "children": [
1895
- > {"value": "{子级垂类标签id}"},
1896
- > {"value": "{子级垂类标签id}"}
1897
- > ]}
1898
- > ### 返回:
1899
- > - 低粉爆款榜
1900
- >
1901
- > # [English]
1902
- > ### Purpose:
1903
- > - Get the low fan explosion list
1904
- > ### Parameters:
1905
- > - page: Page number
1906
- > - page_size: Number of items per page
1907
- > - date_window: Time window, 1 by hour 2 by day
1908
- > - tags: Sub-level vertical category tag, empty for all, multiple tags need to be passed in
1909
- > {"value": "{top-level vertical category id}", "children": [
1910
- > {"value": "{sub-level vertical category id}"},
1911
- > {"value": "{sub-level vertical category id}"}
1912
- > ]}
1913
- > ### Return:
1914
- > - Low fan explosion list
1915
-
1916
- #### Parameters
1917
-
1918
- None
1919
-
1920
- #### Request Body
1921
-
1922
- - required: No
1923
-
1924
- ##### `application/json`
1925
-
1926
- - Schema summary: `page`:integer, `page_size`:integer, `date_window`:integer, `tags`[object]
1927
-
1928
- | Field | Type | Required | Description | Default | Example | Enum |
1929
- | --- | --- | --- | --- | --- | --- | --- |
1930
- | page | integer | No | 页码 | 1 | None | None |
1931
- | page_size | integer | No | 每页数量 | 10 | None | None |
1932
- | date_window | integer | No | 时间窗口,1 按小时 2 按天 | 24 | None | None |
1933
- | tags | array<object> | No | 子级垂类标签,空则为全部,多个标签需传入{"value": "{顶级垂类标签id}", "children": [{"value": "{子级垂类标签id}"}, {"value": "{子级垂类标签id}"}]} | None | None | None |
1934
- | tags[] | object | Yes | None | None | None | None |
1935
-
1936
- #### Success Response
1937
-
1938
- ##### `200 application/json`
1939
-
1940
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1941
-
1942
- | Field | Type | Required | Description | Default | Example | Enum |
1943
- | --- | --- | --- | --- | --- | --- | --- |
1944
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1945
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1946
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1947
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1948
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1949
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1950
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1951
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1952
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1953
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
1954
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1955
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1956
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1957
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1958
- | data | null | No | The response data \| 响应数据 | None | None | None |
1959
-
1960
- <a id="post-api-u1-v1-douyin-billboard-fetch-hot-total-search-list"></a>
1961
- ### `POST /api/u1/v1/douyin/billboard/fetch_hot_total_search_list`
1962
-
1963
- - Summary: 获取搜索热榜/Fetch search hot list
1964
- - Capabilities: search / trends / rankings
1965
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1966
- - operationId: `fetch_hot_total_search_list_api_v1_douyin_billboard_fetch_hot_total_search_list_post`
1967
-
1968
- #### Notes
1969
-
1970
- > # [中文]
1971
- > ### 用途:
1972
- > - 获取搜索榜
1973
- > ### 参数:
1974
- > - page_num: 页码
1975
- > - page_size: 每页数量
1976
- > - date_window: 时间窗口,1 按小时 2 按天
1977
- > - keyword: 搜索关键字
1978
- > ### 返回:
1979
- > - 搜索榜
1980
- >
1981
- > # [English]
1982
- > ### Purpose:
1983
- > - Get the search list
1984
- > ### Parameters:
1985
- > - page_num: Page number
1986
- > - page_size: Number of items per page
1987
- > - date_window: Time window, 1 by hour 2 by day
1988
- > - keyword: Search keyword
1989
- > ### Return:
1990
- > - Search list
1991
-
1992
- #### Parameters
1993
-
1994
- None
1995
-
1996
- #### Request Body
1997
-
1998
- - required: No
1999
-
2000
- ##### `application/json`
2001
-
2002
- - Schema summary: `page_num`:integer, `page_size`:integer, `date_window`:integer, `keyword`:string
2003
-
2004
- | Field | Type | Required | Description | Default | Example | Enum |
2005
- | --- | --- | --- | --- | --- | --- | --- |
2006
- | page_num | integer | No | 页码 | 1 | None | None |
2007
- | page_size | integer | No | 每页数量 | 10 | None | None |
2008
- | date_window | integer | No | 时间窗口,1 按小时 2 按天 | 24 | None | None |
2009
- | keyword | string | No | 搜索关键字 | 抖音 | None | None |
2010
-
2011
- #### Success Response
2012
-
2013
- ##### `200 application/json`
2014
-
2015
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
2016
-
2017
- | Field | Type | Required | Description | Default | Example | Enum |
2018
- | --- | --- | --- | --- | --- | --- | --- |
2019
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
2020
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
2021
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
2022
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
2023
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
2024
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
2025
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
2026
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
2027
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
2028
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
2029
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
2030
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
2031
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
2032
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
2033
- | data | null | No | The response data \| 响应数据 | None | None | None |
2034
-
2035
- <a id="post-api-u1-v1-douyin-billboard-fetch-hot-total-topic-list"></a>
2036
- ### `POST /api/u1/v1/douyin/billboard/fetch_hot_total_topic_list`
2037
-
2038
- - Summary: 获取话题热榜/Fetch topic hot list
2039
- - Capabilities: trends / rankings / topics
2040
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
2041
- - operationId: `fetch_hot_total_topic_list_api_v1_douyin_billboard_fetch_hot_total_topic_list_post`
2042
-
2043
- #### Notes
2044
-
2045
- > # [中文]
2046
- > ### 用途:
2047
- > - 获取话题榜
2048
- > ### 参数:
2049
- > - page: 页码
2050
- > - page_size: 每页数量
2051
- > - date_window: 时间窗口,1 按小时 2 按天
2052
- > - tags: 子级垂类标签,空则为全部,多个标签需传入
2053
- > {"value": "{顶级垂类标签id}", "children": [
2054
- > {"value": "{子级垂类标签id}"},
2055
- > {"value": "{子级垂类标签id}"}
2056
- > ]}
2057
- > ### 返回:
2058
- > - 话题榜
2059
- >
2060
- > # [English]
2061
- > ### Purpose:
2062
- > - Get the topic list
2063
- > ### Parameters:
2064
- > - page: Page number
2065
- > - page_size: Number of items per page
2066
- > - date_window: Time window, 1 by hour 2 by day
2067
- > - tags: Sub-level vertical category tag, empty for all, multiple tags need to be passed in
2068
- > {"value": "{top-level vertical category id}", "children": [
2069
- > {"value": "{sub-level vertical category id}"},
2070
- > {"value": "{sub-level vertical category id}"}
2071
- > ]}
2072
- > ### Return:
2073
- > - Topic list
2074
-
2075
- #### Parameters
2076
-
2077
- None
2078
-
2079
- #### Request Body
2080
-
2081
- - required: No
2082
-
2083
- ##### `application/json`
2084
-
2085
- - Schema summary: `page`:integer, `page_size`:integer, `date_window`:integer, `tags`[object]
2086
-
2087
- | Field | Type | Required | Description | Default | Example | Enum |
2088
- | --- | --- | --- | --- | --- | --- | --- |
2089
- | page | integer | No | 页码 | 1 | None | None |
2090
- | page_size | integer | No | 每页数量 | 10 | None | None |
2091
- | date_window | integer | No | 时间窗口,1 按小时 2 按天 | 24 | None | None |
2092
- | tags | array<object> | No | 子级垂类标签,空则为全部,多个标签需传入{"value": "{顶级垂类标签id}", "children": [{"value": "{子级垂类标签id}"}, {"value": "{子级垂类标签id}"}]} | None | None | None |
2093
- | tags[] | object | Yes | None | None | None | None |
2094
-
2095
- #### Success Response
2096
-
2097
- ##### `200 application/json`
2098
-
2099
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
2100
-
2101
- | Field | Type | Required | Description | Default | Example | Enum |
2102
- | --- | --- | --- | --- | --- | --- | --- |
2103
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
2104
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
2105
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
2106
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
2107
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
2108
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
2109
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
2110
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
2111
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
2112
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
2113
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
2114
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
2115
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
2116
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
2117
- | data | null | No | The response data \| 响应数据 | None | None | None |
2118
-
2119
- <a id="post-api-u1-v1-douyin-billboard-fetch-hot-total-video-list"></a>
2120
- ### `POST /api/u1/v1/douyin/billboard/fetch_hot_total_video_list`
2121
-
2122
- - Summary: 获取视频热榜/Fetch video hot list
2123
- - Capabilities: trends / rankings / content details
2124
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
2125
- - operationId: `fetch_hot_total_video_list_api_v1_douyin_billboard_fetch_hot_total_video_list_post`
2126
-
2127
- #### Notes
2128
-
2129
- > # [中文]
2130
- > ### 用途:
2131
- > - 获取视频榜
2132
- > ### 参数:
2133
- > - page: 页码,默认1
2134
- > - page_size: 每页数量,默认10
2135
- > - date_window: 时间窗口,1 按小时 2 按天
2136
- > - sub_type: 榜单分类,1001 视频总榜 1002 低粉爆款 1003 高完播率 1004 高涨粉率 1005 高点赞率
2137
- > - tags: 子级垂类标签,空则为全部,多个标签需传入
2138
- > {"value": "{顶级垂类标签id}", "children": [
2139
- > {"value": "{子级垂类标签id}"},
2140
- > {"value": "{子级垂类标签id}"}
2141
- > ]}
2142
- > ### 返回:
2143
- > - 视频榜
2144
- >
2145
- > # [English]
2146
- > ### Purpose:
2147
- > - Get the video list
2148
- > ### Parameters:
2149
- > - page: Page number
2150
- > - page_size: Number of items per page
2151
- > - date_window: Time window, 1 by hour 2 by day
2152
- > - sub_type: List category, 1001 Video total list 1002 Low fan explosion 1003 High completion rate 1004 High fan growth rate 1005 High like rate
2153
- > - tags: Sub-level vertical category tag, empty for all, multiple tags need to be passed in
2154
- > {"value": "{top-level vertical category id}", "children": [
2155
- > {"value": "{sub-level vertical category id}"},
2156
- > {"value": "{sub-level vertical category id}"}
2157
- > ]}
2158
- > ### Return:
2159
- > - Video list
2160
-
2161
- #### Parameters
2162
-
2163
- None
2164
-
2165
- #### Request Body
2166
-
2167
- - required: No
2168
-
2169
- ##### `application/json`
2170
-
2171
- - Schema summary: `page`:integer, `page_size`:integer, `date_window`:integer, `sub_type`:integer, `tags`[object]
2172
-
2173
- | Field | Type | Required | Description | Default | Example | Enum |
2174
- | --- | --- | --- | --- | --- | --- | --- |
2175
- | page | integer | No | 页码,默认1 | 1 | None | None |
2176
- | page_size | integer | No | 每页数量,默认10 | 10 | None | None |
2177
- | date_window | integer | No | 时间窗口,1 按小时 2 按天 | 24 | None | None |
2178
- | sub_type | integer | No | 榜单分类,1001 视频总榜 1002 低粉爆款 1003 高完播率 1004 高涨粉率 1005 高点赞率 | 1001 | None | None |
2179
- | tags | array<object> | No | 子级垂类标签,空则为全部,多个标签需传入{"value": "{顶级垂类标签id}", "children": [{"value": "{子级垂类标签id}"}, {"value": "{子级垂类标签id}"}]} | None | None | None |
2180
- | tags[] | object | Yes | None | None | None | None |
2181
-
2182
- #### Success Response
2183
-
2184
- ##### `200 application/json`
2185
-
2186
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
2187
-
2188
- | Field | Type | Required | Description | Default | Example | Enum |
2189
- | --- | --- | --- | --- | --- | --- | --- |
2190
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
2191
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
2192
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
2193
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
2194
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
2195
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
2196
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
2197
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
2198
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
2199
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
2200
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
2201
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
2202
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
2203
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
2204
- | data | null | No | The response data \| 响应数据 | None | None | None |
2205
-
2206
- <a id="get-api-u1-v1-douyin-billboard-fetch-hot-user-portrait-list"></a>
2207
- ### `GET /api/u1/v1/douyin/billboard/fetch_hot_user_portrait_list`
2208
-
2209
- - Summary: 获取作品点赞观众画像-仅限热门榜/Fetch work like audience portrait - hot list only
2210
- - Capabilities: trends / rankings / profiles / accounts
2211
- - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
2212
- - operationId: `fetch_hot_user_portrait_list_api_v1_douyin_billboard_fetch_hot_user_portrait_list_get`
2213
-
2214
- #### Notes
2215
-
2216
- > # [中文]
2217
- > ### 用途:
2218
- > - 获取作品点赞观众画像
2219
- > ### 参数:
2220
- > - aweme_id: 作品id
2221
- > - option: 选项,1 手机价格分布 2 性别分布 3 年龄分布 4 地域分布-省份 5 地域分布-城市 6 城市等级 7 手机品牌分布
2222
- > ### 返回:
2223
- > - 作品点赞观众画像
2224
- >
2225
- > # [English]
2226
- > ### Purpose:
2227
- > - Get the work like audience portrait
2228
- > ### Parameters:
2229
- > - aweme_id: Work id
2230
- > - option: Option
2231
- > - 1 Mobile price
2232
- > - 2 Gender distribution
2233
- > - 3 Age distribution
2234
- > - 4 Regional distribution - province
2235
- > - 5 Regional distribution - city
2236
- > - 6 City level
2237
- > - 7 Mobile brand distribution
2238
- > ### Return:
2239
- > - Work like audience portrait
2240
-
2241
- #### Parameters
2242
-
2243
- | Field | In | Type | Required | Description | Default | Example | Enum |
2244
- | --- | --- | --- | --- | --- | --- | --- | --- |
2245
- | aweme_id | query | string | Yes | 作品id | None | 7456035425539329340 | None |
2246
- | option | query | integer | No | 选项,1 手机价格分布 2 性别分布 3 年龄分布 4 地域分布-省份 5 地域分布-城市 6 城市等级 7 手机品牌分布 | 4 | None | None |
2247
-
2248
- #### Request Body
2249
-
2250
- None
2251
-
2252
- #### Success Response
2253
-
2254
- ##### `200 application/json`
2255
-
2256
- - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
2257
-
2258
- | Field | Type | Required | Description | Default | Example | Enum |
2259
- | --- | --- | --- | --- | --- | --- | --- |
2260
- | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
2261
- | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
2262
- | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
2263
- | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
2264
- | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
2265
- | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
2266
- | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
2267
- | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
2268
- | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
2269
- | cache_message | string | No | Cache message (EN-US) \| 缓存消息 (English) | This request will be cached. You can access the cached result directly using th… | None | None |
2270
- | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
2271
- | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
2272
- | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
2273
- | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
2274
- | data | null | No | The response data \| 响应数据 | None | None | None |