@tikomni/skills 0.1.0

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 (451) hide show
  1. package/.skill-package-allowlist.txt +4 -0
  2. package/LICENSE +21 -0
  3. package/README.md +167 -0
  4. package/README.zh-CN.md +167 -0
  5. package/bin/tikomni-skills.js +127 -0
  6. package/env.example +160 -0
  7. package/lib/installer.js +176 -0
  8. package/package.json +44 -0
  9. package/skills/creator-analysis/SKILL.md +71 -0
  10. package/skills/creator-analysis/agents/openai.yaml +4 -0
  11. package/skills/creator-analysis/env.example +36 -0
  12. package/skills/creator-analysis/references/api-capability-index.md +92 -0
  13. package/skills/creator-analysis/references/api-contracts/asr-api.md +130 -0
  14. package/skills/creator-analysis/references/api-contracts/bilibili-app-api.md +776 -0
  15. package/skills/creator-analysis/references/api-contracts/bilibili-web-api.md +2017 -0
  16. package/skills/creator-analysis/references/api-contracts/demo-api.md +717 -0
  17. package/skills/creator-analysis/references/api-contracts/douyin-app-v3-api.md +3594 -0
  18. package/skills/creator-analysis/references/api-contracts/douyin-billboard-api.md +2274 -0
  19. package/skills/creator-analysis/references/api-contracts/douyin-creator-api.md +1575 -0
  20. package/skills/creator-analysis/references/api-contracts/douyin-creator-v2-api.md +3254 -0
  21. package/skills/creator-analysis/references/api-contracts/douyin-search-api.md +4118 -0
  22. package/skills/creator-analysis/references/api-contracts/douyin-web-api.md +5544 -0
  23. package/skills/creator-analysis/references/api-contracts/douyin-xingtu-api.md +1916 -0
  24. package/skills/creator-analysis/references/api-contracts/douyin-xingtu-v2-api.md +1540 -0
  25. package/skills/creator-analysis/references/api-contracts/health-check.md +69 -0
  26. package/skills/creator-analysis/references/api-contracts/hybrid-parsing.md +78 -0
  27. package/skills/creator-analysis/references/api-contracts/instagram-v1-api.md +2256 -0
  28. package/skills/creator-analysis/references/api-contracts/instagram-v2-api.md +2011 -0
  29. package/skills/creator-analysis/references/api-contracts/instagram-v3-api.md +2630 -0
  30. package/skills/creator-analysis/references/api-contracts/ios-shortcut.md +44 -0
  31. package/skills/creator-analysis/references/api-contracts/kuaishou-app-api.md +1518 -0
  32. package/skills/creator-analysis/references/api-contracts/kuaishou-web-api.md +1242 -0
  33. package/skills/creator-analysis/references/api-contracts/lemon8-app-api.md +1088 -0
  34. package/skills/creator-analysis/references/api-contracts/linkedin-web-api.md +1949 -0
  35. package/skills/creator-analysis/references/api-contracts/media-ingest-api.md +126 -0
  36. package/skills/creator-analysis/references/api-contracts/pipixia-app-api.md +1142 -0
  37. package/skills/creator-analysis/references/api-contracts/reddit-app-api.md +2025 -0
  38. package/skills/creator-analysis/references/api-contracts/sora2-api.md +2266 -0
  39. package/skills/creator-analysis/references/api-contracts/temp-mail-api.md +208 -0
  40. package/skills/creator-analysis/references/api-contracts/threads-web-api.md +897 -0
  41. package/skills/creator-analysis/references/api-contracts/tikhub-downloader-api.md +134 -0
  42. package/skills/creator-analysis/references/api-contracts/tikhub-user-api.md +494 -0
  43. package/skills/creator-analysis/references/api-contracts/tiktok-ads-api.md +5947 -0
  44. package/skills/creator-analysis/references/api-contracts/tiktok-analytics-api.md +968 -0
  45. package/skills/creator-analysis/references/api-contracts/tiktok-app-v3-api.md +5735 -0
  46. package/skills/creator-analysis/references/api-contracts/tiktok-creator-api.md +1951 -0
  47. package/skills/creator-analysis/references/api-contracts/tiktok-interaction-api.md +742 -0
  48. package/skills/creator-analysis/references/api-contracts/tiktok-shop-web-api.md +1890 -0
  49. package/skills/creator-analysis/references/api-contracts/tiktok-web-api.md +4448 -0
  50. package/skills/creator-analysis/references/api-contracts/toutiao-app-api.md +342 -0
  51. package/skills/creator-analysis/references/api-contracts/toutiao-web-api.md +143 -0
  52. package/skills/creator-analysis/references/api-contracts/twitter-web-api.md +989 -0
  53. package/skills/creator-analysis/references/api-contracts/wechat-channels-api.md +809 -0
  54. package/skills/creator-analysis/references/api-contracts/wechat-media-platform-web-api.md +677 -0
  55. package/skills/creator-analysis/references/api-contracts/weibo-app-api.md +1547 -0
  56. package/skills/creator-analysis/references/api-contracts/weibo-web-api.md +798 -0
  57. package/skills/creator-analysis/references/api-contracts/weibo-web-v2-api.md +2459 -0
  58. package/skills/creator-analysis/references/api-contracts/xiaohongshu-app-api.md +1291 -0
  59. package/skills/creator-analysis/references/api-contracts/xiaohongshu-app-v2-api.md +1683 -0
  60. package/skills/creator-analysis/references/api-contracts/xiaohongshu-web-api.md +1324 -0
  61. package/skills/creator-analysis/references/api-contracts/xiaohongshu-web-v2-api.md +1209 -0
  62. package/skills/creator-analysis/references/api-contracts/xigua-app-v2-api.md +489 -0
  63. package/skills/creator-analysis/references/api-contracts/youtube-web-api.md +2636 -0
  64. package/skills/creator-analysis/references/api-contracts/youtube-web-v2-api.md +2660 -0
  65. package/skills/creator-analysis/references/api-contracts/zhihu-web-api.md +2315 -0
  66. package/skills/creator-analysis/references/api-tags/asr-api.md +100 -0
  67. package/skills/creator-analysis/references/api-tags/bilibili-app-api.md +482 -0
  68. package/skills/creator-analysis/references/api-tags/bilibili-web-api.md +1267 -0
  69. package/skills/creator-analysis/references/api-tags/demo-api.md +365 -0
  70. package/skills/creator-analysis/references/api-tags/douyin-app-v3-api.md +2012 -0
  71. package/skills/creator-analysis/references/api-tags/douyin-billboard-api.md +1428 -0
  72. package/skills/creator-analysis/references/api-tags/douyin-creator-api.md +694 -0
  73. package/skills/creator-analysis/references/api-tags/douyin-creator-v2-api.md +694 -0
  74. package/skills/creator-analysis/references/api-tags/douyin-search-api.md +1059 -0
  75. package/skills/creator-analysis/references/api-tags/douyin-web-api.md +3314 -0
  76. package/skills/creator-analysis/references/api-tags/douyin-xingtu-api.md +935 -0
  77. package/skills/creator-analysis/references/api-tags/douyin-xingtu-v2-api.md +925 -0
  78. package/skills/creator-analysis/references/api-tags/health-check.md +40 -0
  79. package/skills/creator-analysis/references/api-tags/hybrid-parsing.md +57 -0
  80. package/skills/creator-analysis/references/api-tags/instagram-v1-api.md +1224 -0
  81. package/skills/creator-analysis/references/api-tags/instagram-v2-api.md +1147 -0
  82. package/skills/creator-analysis/references/api-tags/instagram-v3-api.md +1123 -0
  83. package/skills/creator-analysis/references/api-tags/ios-shortcut.md +45 -0
  84. package/skills/creator-analysis/references/api-tags/kuaishou-app-api.md +846 -0
  85. package/skills/creator-analysis/references/api-tags/kuaishou-web-api.md +551 -0
  86. package/skills/creator-analysis/references/api-tags/lemon8-app-api.md +687 -0
  87. package/skills/creator-analysis/references/api-tags/linkedin-web-api.md +1105 -0
  88. package/skills/creator-analysis/references/api-tags/media-ingest-api.md +112 -0
  89. package/skills/creator-analysis/references/api-tags/pipixia-app-api.md +721 -0
  90. package/skills/creator-analysis/references/api-tags/reddit-app-api.md +1057 -0
  91. package/skills/creator-analysis/references/api-tags/sora2-api.md +737 -0
  92. package/skills/creator-analysis/references/api-tags/temp-mail-api.md +136 -0
  93. package/skills/creator-analysis/references/api-tags/threads-web-api.md +472 -0
  94. package/skills/creator-analysis/references/api-tags/tikhub-downloader-api.md +65 -0
  95. package/skills/creator-analysis/references/api-tags/tikhub-user-api.md +253 -0
  96. package/skills/creator-analysis/references/api-tags/tiktok-ads-api.md +1393 -0
  97. package/skills/creator-analysis/references/api-tags/tiktok-analytics-api.md +179 -0
  98. package/skills/creator-analysis/references/api-tags/tiktok-app-v3-api.md +3264 -0
  99. package/skills/creator-analysis/references/api-tags/tiktok-creator-api.md +709 -0
  100. package/skills/creator-analysis/references/api-tags/tiktok-interaction-api.md +366 -0
  101. package/skills/creator-analysis/references/api-tags/tiktok-shop-web-api.md +663 -0
  102. package/skills/creator-analysis/references/api-tags/tiktok-web-api.md +2516 -0
  103. package/skills/creator-analysis/references/api-tags/toutiao-app-api.md +220 -0
  104. package/skills/creator-analysis/references/api-tags/toutiao-web-api.md +96 -0
  105. package/skills/creator-analysis/references/api-tags/twitter-web-api.md +562 -0
  106. package/skills/creator-analysis/references/api-tags/wechat-channels-api.md +405 -0
  107. package/skills/creator-analysis/references/api-tags/wechat-media-platform-web-api.md +431 -0
  108. package/skills/creator-analysis/references/api-tags/weibo-app-api.md +851 -0
  109. package/skills/creator-analysis/references/api-tags/weibo-web-api.md +470 -0
  110. package/skills/creator-analysis/references/api-tags/weibo-web-v2-api.md +1405 -0
  111. package/skills/creator-analysis/references/api-tags/xiaohongshu-app-api.md +534 -0
  112. package/skills/creator-analysis/references/api-tags/xiaohongshu-app-v2-api.md +934 -0
  113. package/skills/creator-analysis/references/api-tags/xiaohongshu-web-api.md +757 -0
  114. package/skills/creator-analysis/references/api-tags/xiaohongshu-web-v2-api.md +762 -0
  115. package/skills/creator-analysis/references/api-tags/xigua-app-v2-api.md +308 -0
  116. package/skills/creator-analysis/references/api-tags/youtube-web-api.md +934 -0
  117. package/skills/creator-analysis/references/api-tags/youtube-web-v2-api.md +717 -0
  118. package/skills/creator-analysis/references/api-tags/zhihu-web-api.md +1384 -0
  119. package/skills/creator-analysis/references/asr-orchestration.md +33 -0
  120. package/skills/creator-analysis/references/config-templates/defaults.yaml +60 -0
  121. package/skills/creator-analysis/references/contracts/creator-card-fields.md +23 -0
  122. package/skills/creator-analysis/references/contracts/work-card-fields.md +32 -0
  123. package/skills/creator-analysis/references/platform-guides/douyin.md +49 -0
  124. package/skills/creator-analysis/references/platform-guides/generic.md +46 -0
  125. package/skills/creator-analysis/references/platform-guides/xiaohongshu.md +54 -0
  126. package/skills/creator-analysis/references/prompt-contracts/asr-clean.md +28 -0
  127. package/skills/creator-analysis/references/prompt-contracts/author-analysis-v2.md +46 -0
  128. package/skills/creator-analysis/references/prompt-contracts/author-analysis.md +49 -0
  129. package/skills/creator-analysis/references/prompt-contracts/cta.md +24 -0
  130. package/skills/creator-analysis/references/prompt-contracts/hook.md +25 -0
  131. package/skills/creator-analysis/references/prompt-contracts/insight.md +47 -0
  132. package/skills/creator-analysis/references/prompt-contracts/sampled-work-batch-explanations.md +30 -0
  133. package/skills/creator-analysis/references/prompt-contracts/structure.md +25 -0
  134. package/skills/creator-analysis/references/prompt-contracts/style.md +27 -0
  135. package/skills/creator-analysis/references/prompt-contracts/summary.md +29 -0
  136. package/skills/creator-analysis/references/prompt-contracts/topic.md +29 -0
  137. package/skills/creator-analysis/references/schemas/author-analysis-input-v1.schema.json +325 -0
  138. package/skills/creator-analysis/references/schemas/author-analysis-v2.schema.json +158 -0
  139. package/skills/creator-analysis/references/schemas/sampled-work-batch-explanations.schema.json +41 -0
  140. package/skills/creator-analysis/references/service-guides/asr-u2-u3-fallback.md +75 -0
  141. package/skills/creator-analysis/references/workflow.md +18 -0
  142. package/skills/creator-analysis/scripts/__init__.py +0 -0
  143. package/skills/creator-analysis/scripts/author_home/__init__.py +0 -0
  144. package/skills/creator-analysis/scripts/author_home/adapters/__init__.py +0 -0
  145. package/skills/creator-analysis/scripts/author_home/adapters/platform_adapters.py +299 -0
  146. package/skills/creator-analysis/scripts/author_home/analyzers/__init__.py +0 -0
  147. package/skills/creator-analysis/scripts/author_home/analyzers/author_analysis_v2_support.py +1122 -0
  148. package/skills/creator-analysis/scripts/author_home/analyzers/prompt_first_analyzers.py +260 -0
  149. package/skills/creator-analysis/scripts/author_home/analyzers/sampled_work_batch_explainer.py +260 -0
  150. package/skills/creator-analysis/scripts/author_home/asr/__init__.py +5 -0
  151. package/skills/creator-analysis/scripts/author_home/asr/home_asr.py +961 -0
  152. package/skills/creator-analysis/scripts/author_home/builders/__init__.py +0 -0
  153. package/skills/creator-analysis/scripts/author_home/builders/home_builders.py +149 -0
  154. package/skills/creator-analysis/scripts/author_home/collectors/__init__.py +0 -0
  155. package/skills/creator-analysis/scripts/author_home/collectors/homepage_collectors.py +636 -0
  156. package/skills/creator-analysis/scripts/author_home/orchestrator/__init__.py +0 -0
  157. package/skills/creator-analysis/scripts/author_home/orchestrator/run_author_analysis.py +491 -0
  158. package/skills/creator-analysis/scripts/author_home/orchestrator/work_analysis_artifacts.py +553 -0
  159. package/skills/creator-analysis/scripts/author_home/schema.py +417 -0
  160. package/skills/creator-analysis/scripts/core/__init__.py +0 -0
  161. package/skills/creator-analysis/scripts/core/analysis_pipeline.py +133 -0
  162. package/skills/creator-analysis/scripts/core/bootstrap_env.py +35 -0
  163. package/skills/creator-analysis/scripts/core/config_loader.py +418 -0
  164. package/skills/creator-analysis/scripts/core/extract_pipeline.py +173 -0
  165. package/skills/creator-analysis/scripts/core/progress_report.py +111 -0
  166. package/skills/creator-analysis/scripts/core/storage_router.py +253 -0
  167. package/skills/creator-analysis/scripts/core/tikomni_common.py +588 -0
  168. package/skills/creator-analysis/scripts/pipeline/__init__.py +0 -0
  169. package/skills/creator-analysis/scripts/pipeline/asr/__init__.py +0 -0
  170. package/skills/creator-analysis/scripts/pipeline/asr/asr_pipeline.py +1189 -0
  171. package/skills/creator-analysis/scripts/pipeline/asr/poll_u2_task.py +95 -0
  172. package/skills/creator-analysis/scripts/platform/__init__.py +0 -0
  173. package/skills/creator-analysis/scripts/platform/douyin/__init__.py +0 -0
  174. package/skills/creator-analysis/scripts/platform/douyin/douyin_video_type_matrix.py +224 -0
  175. package/skills/creator-analysis/scripts/platform/douyin/run_douyin_single_video.py +1208 -0
  176. package/skills/creator-analysis/scripts/platform/douyin/select_low_quality_video_url.py +200 -0
  177. package/skills/creator-analysis/scripts/platform/xiaohongshu/__init__.py +0 -0
  178. package/skills/creator-analysis/scripts/platform/xiaohongshu/run_xiaohongshu_extract.py +2128 -0
  179. package/skills/creator-analysis/scripts/writers/__init__.py +0 -0
  180. package/skills/creator-analysis/scripts/writers/write_author_homepage_samples.py +106 -0
  181. package/skills/creator-analysis/scripts/writers/write_benchmark_card.py +1402 -0
  182. package/skills/meta-capability/SKILL.md +69 -0
  183. package/skills/meta-capability/agents/openai.yaml +4 -0
  184. package/skills/meta-capability/env.example +42 -0
  185. package/skills/meta-capability/references/api-capability-index.md +92 -0
  186. package/skills/meta-capability/references/api-contracts/asr-api.md +130 -0
  187. package/skills/meta-capability/references/api-contracts/bilibili-app-api.md +776 -0
  188. package/skills/meta-capability/references/api-contracts/bilibili-web-api.md +2017 -0
  189. package/skills/meta-capability/references/api-contracts/demo-api.md +717 -0
  190. package/skills/meta-capability/references/api-contracts/douyin-app-v3-api.md +3594 -0
  191. package/skills/meta-capability/references/api-contracts/douyin-billboard-api.md +2274 -0
  192. package/skills/meta-capability/references/api-contracts/douyin-creator-api.md +1575 -0
  193. package/skills/meta-capability/references/api-contracts/douyin-creator-v2-api.md +3254 -0
  194. package/skills/meta-capability/references/api-contracts/douyin-search-api.md +4118 -0
  195. package/skills/meta-capability/references/api-contracts/douyin-web-api.md +5544 -0
  196. package/skills/meta-capability/references/api-contracts/douyin-xingtu-api.md +1916 -0
  197. package/skills/meta-capability/references/api-contracts/douyin-xingtu-v2-api.md +1540 -0
  198. package/skills/meta-capability/references/api-contracts/health-check.md +69 -0
  199. package/skills/meta-capability/references/api-contracts/hybrid-parsing.md +78 -0
  200. package/skills/meta-capability/references/api-contracts/instagram-v1-api.md +2256 -0
  201. package/skills/meta-capability/references/api-contracts/instagram-v2-api.md +2011 -0
  202. package/skills/meta-capability/references/api-contracts/instagram-v3-api.md +2630 -0
  203. package/skills/meta-capability/references/api-contracts/ios-shortcut.md +44 -0
  204. package/skills/meta-capability/references/api-contracts/kuaishou-app-api.md +1518 -0
  205. package/skills/meta-capability/references/api-contracts/kuaishou-web-api.md +1242 -0
  206. package/skills/meta-capability/references/api-contracts/lemon8-app-api.md +1088 -0
  207. package/skills/meta-capability/references/api-contracts/linkedin-web-api.md +1949 -0
  208. package/skills/meta-capability/references/api-contracts/media-ingest-api.md +126 -0
  209. package/skills/meta-capability/references/api-contracts/pipixia-app-api.md +1142 -0
  210. package/skills/meta-capability/references/api-contracts/reddit-app-api.md +2025 -0
  211. package/skills/meta-capability/references/api-contracts/sora2-api.md +2266 -0
  212. package/skills/meta-capability/references/api-contracts/temp-mail-api.md +208 -0
  213. package/skills/meta-capability/references/api-contracts/threads-web-api.md +897 -0
  214. package/skills/meta-capability/references/api-contracts/tikhub-downloader-api.md +134 -0
  215. package/skills/meta-capability/references/api-contracts/tikhub-user-api.md +494 -0
  216. package/skills/meta-capability/references/api-contracts/tiktok-ads-api.md +5947 -0
  217. package/skills/meta-capability/references/api-contracts/tiktok-analytics-api.md +968 -0
  218. package/skills/meta-capability/references/api-contracts/tiktok-app-v3-api.md +5735 -0
  219. package/skills/meta-capability/references/api-contracts/tiktok-creator-api.md +1951 -0
  220. package/skills/meta-capability/references/api-contracts/tiktok-interaction-api.md +742 -0
  221. package/skills/meta-capability/references/api-contracts/tiktok-shop-web-api.md +1890 -0
  222. package/skills/meta-capability/references/api-contracts/tiktok-web-api.md +4448 -0
  223. package/skills/meta-capability/references/api-contracts/toutiao-app-api.md +342 -0
  224. package/skills/meta-capability/references/api-contracts/toutiao-web-api.md +143 -0
  225. package/skills/meta-capability/references/api-contracts/twitter-web-api.md +989 -0
  226. package/skills/meta-capability/references/api-contracts/wechat-channels-api.md +809 -0
  227. package/skills/meta-capability/references/api-contracts/wechat-media-platform-web-api.md +677 -0
  228. package/skills/meta-capability/references/api-contracts/weibo-app-api.md +1547 -0
  229. package/skills/meta-capability/references/api-contracts/weibo-web-api.md +798 -0
  230. package/skills/meta-capability/references/api-contracts/weibo-web-v2-api.md +2459 -0
  231. package/skills/meta-capability/references/api-contracts/xiaohongshu-app-api.md +1291 -0
  232. package/skills/meta-capability/references/api-contracts/xiaohongshu-app-v2-api.md +1683 -0
  233. package/skills/meta-capability/references/api-contracts/xiaohongshu-web-api.md +1324 -0
  234. package/skills/meta-capability/references/api-contracts/xiaohongshu-web-v2-api.md +1209 -0
  235. package/skills/meta-capability/references/api-contracts/xigua-app-v2-api.md +489 -0
  236. package/skills/meta-capability/references/api-contracts/youtube-web-api.md +2636 -0
  237. package/skills/meta-capability/references/api-contracts/youtube-web-v2-api.md +2660 -0
  238. package/skills/meta-capability/references/api-contracts/zhihu-web-api.md +2315 -0
  239. package/skills/meta-capability/references/api-tags/asr-api.md +100 -0
  240. package/skills/meta-capability/references/api-tags/bilibili-app-api.md +482 -0
  241. package/skills/meta-capability/references/api-tags/bilibili-web-api.md +1267 -0
  242. package/skills/meta-capability/references/api-tags/demo-api.md +365 -0
  243. package/skills/meta-capability/references/api-tags/douyin-app-v3-api.md +2012 -0
  244. package/skills/meta-capability/references/api-tags/douyin-billboard-api.md +1428 -0
  245. package/skills/meta-capability/references/api-tags/douyin-creator-api.md +694 -0
  246. package/skills/meta-capability/references/api-tags/douyin-creator-v2-api.md +694 -0
  247. package/skills/meta-capability/references/api-tags/douyin-search-api.md +1059 -0
  248. package/skills/meta-capability/references/api-tags/douyin-web-api.md +3314 -0
  249. package/skills/meta-capability/references/api-tags/douyin-xingtu-api.md +935 -0
  250. package/skills/meta-capability/references/api-tags/douyin-xingtu-v2-api.md +925 -0
  251. package/skills/meta-capability/references/api-tags/health-check.md +40 -0
  252. package/skills/meta-capability/references/api-tags/hybrid-parsing.md +57 -0
  253. package/skills/meta-capability/references/api-tags/instagram-v1-api.md +1224 -0
  254. package/skills/meta-capability/references/api-tags/instagram-v2-api.md +1147 -0
  255. package/skills/meta-capability/references/api-tags/instagram-v3-api.md +1123 -0
  256. package/skills/meta-capability/references/api-tags/ios-shortcut.md +45 -0
  257. package/skills/meta-capability/references/api-tags/kuaishou-app-api.md +846 -0
  258. package/skills/meta-capability/references/api-tags/kuaishou-web-api.md +551 -0
  259. package/skills/meta-capability/references/api-tags/lemon8-app-api.md +687 -0
  260. package/skills/meta-capability/references/api-tags/linkedin-web-api.md +1105 -0
  261. package/skills/meta-capability/references/api-tags/media-ingest-api.md +112 -0
  262. package/skills/meta-capability/references/api-tags/pipixia-app-api.md +721 -0
  263. package/skills/meta-capability/references/api-tags/reddit-app-api.md +1057 -0
  264. package/skills/meta-capability/references/api-tags/sora2-api.md +737 -0
  265. package/skills/meta-capability/references/api-tags/temp-mail-api.md +136 -0
  266. package/skills/meta-capability/references/api-tags/threads-web-api.md +472 -0
  267. package/skills/meta-capability/references/api-tags/tikhub-downloader-api.md +65 -0
  268. package/skills/meta-capability/references/api-tags/tikhub-user-api.md +253 -0
  269. package/skills/meta-capability/references/api-tags/tiktok-ads-api.md +1393 -0
  270. package/skills/meta-capability/references/api-tags/tiktok-analytics-api.md +179 -0
  271. package/skills/meta-capability/references/api-tags/tiktok-app-v3-api.md +3264 -0
  272. package/skills/meta-capability/references/api-tags/tiktok-creator-api.md +709 -0
  273. package/skills/meta-capability/references/api-tags/tiktok-interaction-api.md +366 -0
  274. package/skills/meta-capability/references/api-tags/tiktok-shop-web-api.md +663 -0
  275. package/skills/meta-capability/references/api-tags/tiktok-web-api.md +2516 -0
  276. package/skills/meta-capability/references/api-tags/toutiao-app-api.md +220 -0
  277. package/skills/meta-capability/references/api-tags/toutiao-web-api.md +96 -0
  278. package/skills/meta-capability/references/api-tags/twitter-web-api.md +562 -0
  279. package/skills/meta-capability/references/api-tags/wechat-channels-api.md +405 -0
  280. package/skills/meta-capability/references/api-tags/wechat-media-platform-web-api.md +431 -0
  281. package/skills/meta-capability/references/api-tags/weibo-app-api.md +851 -0
  282. package/skills/meta-capability/references/api-tags/weibo-web-api.md +470 -0
  283. package/skills/meta-capability/references/api-tags/weibo-web-v2-api.md +1405 -0
  284. package/skills/meta-capability/references/api-tags/xiaohongshu-app-api.md +534 -0
  285. package/skills/meta-capability/references/api-tags/xiaohongshu-app-v2-api.md +934 -0
  286. package/skills/meta-capability/references/api-tags/xiaohongshu-web-api.md +757 -0
  287. package/skills/meta-capability/references/api-tags/xiaohongshu-web-v2-api.md +762 -0
  288. package/skills/meta-capability/references/api-tags/xigua-app-v2-api.md +308 -0
  289. package/skills/meta-capability/references/api-tags/youtube-web-api.md +934 -0
  290. package/skills/meta-capability/references/api-tags/youtube-web-v2-api.md +717 -0
  291. package/skills/meta-capability/references/api-tags/zhihu-web-api.md +1384 -0
  292. package/skills/meta-capability/references/config-templates/defaults.yaml +18 -0
  293. package/skills/meta-capability/references/dispatch.md +27 -0
  294. package/skills/meta-capability/references/execution-guidelines.md +25 -0
  295. package/skills/meta-capability/references/implemented-route-map.md +177 -0
  296. package/skills/meta-capability/references/service-guides/asr-u2-u3-fallback.md +75 -0
  297. package/skills/meta-capability/scripts/__init__.py +1 -0
  298. package/skills/meta-capability/scripts/call_route.py +141 -0
  299. package/skills/meta-capability/scripts/core/__init__.py +1 -0
  300. package/skills/meta-capability/scripts/core/bootstrap_env.py +32 -0
  301. package/skills/meta-capability/scripts/core/config_loader.py +204 -0
  302. package/skills/meta-capability/scripts/core/tikomni_common.py +443 -0
  303. package/skills/meta-capability/scripts/test_auth.py +98 -0
  304. package/skills/single-work-analysis/SKILL.md +62 -0
  305. package/skills/single-work-analysis/agents/openai.yaml +4 -0
  306. package/skills/single-work-analysis/env.example +36 -0
  307. package/skills/single-work-analysis/references/api-capability-index.md +92 -0
  308. package/skills/single-work-analysis/references/api-contracts/asr-api.md +130 -0
  309. package/skills/single-work-analysis/references/api-contracts/bilibili-app-api.md +776 -0
  310. package/skills/single-work-analysis/references/api-contracts/bilibili-web-api.md +2017 -0
  311. package/skills/single-work-analysis/references/api-contracts/demo-api.md +717 -0
  312. package/skills/single-work-analysis/references/api-contracts/douyin-app-v3-api.md +3594 -0
  313. package/skills/single-work-analysis/references/api-contracts/douyin-billboard-api.md +2274 -0
  314. package/skills/single-work-analysis/references/api-contracts/douyin-creator-api.md +1575 -0
  315. package/skills/single-work-analysis/references/api-contracts/douyin-creator-v2-api.md +3254 -0
  316. package/skills/single-work-analysis/references/api-contracts/douyin-search-api.md +4118 -0
  317. package/skills/single-work-analysis/references/api-contracts/douyin-web-api.md +5544 -0
  318. package/skills/single-work-analysis/references/api-contracts/douyin-xingtu-api.md +1916 -0
  319. package/skills/single-work-analysis/references/api-contracts/douyin-xingtu-v2-api.md +1540 -0
  320. package/skills/single-work-analysis/references/api-contracts/health-check.md +69 -0
  321. package/skills/single-work-analysis/references/api-contracts/hybrid-parsing.md +78 -0
  322. package/skills/single-work-analysis/references/api-contracts/instagram-v1-api.md +2256 -0
  323. package/skills/single-work-analysis/references/api-contracts/instagram-v2-api.md +2011 -0
  324. package/skills/single-work-analysis/references/api-contracts/instagram-v3-api.md +2630 -0
  325. package/skills/single-work-analysis/references/api-contracts/ios-shortcut.md +44 -0
  326. package/skills/single-work-analysis/references/api-contracts/kuaishou-app-api.md +1518 -0
  327. package/skills/single-work-analysis/references/api-contracts/kuaishou-web-api.md +1242 -0
  328. package/skills/single-work-analysis/references/api-contracts/lemon8-app-api.md +1088 -0
  329. package/skills/single-work-analysis/references/api-contracts/linkedin-web-api.md +1949 -0
  330. package/skills/single-work-analysis/references/api-contracts/media-ingest-api.md +126 -0
  331. package/skills/single-work-analysis/references/api-contracts/pipixia-app-api.md +1142 -0
  332. package/skills/single-work-analysis/references/api-contracts/reddit-app-api.md +2025 -0
  333. package/skills/single-work-analysis/references/api-contracts/sora2-api.md +2266 -0
  334. package/skills/single-work-analysis/references/api-contracts/temp-mail-api.md +208 -0
  335. package/skills/single-work-analysis/references/api-contracts/threads-web-api.md +897 -0
  336. package/skills/single-work-analysis/references/api-contracts/tikhub-downloader-api.md +134 -0
  337. package/skills/single-work-analysis/references/api-contracts/tikhub-user-api.md +494 -0
  338. package/skills/single-work-analysis/references/api-contracts/tiktok-ads-api.md +5947 -0
  339. package/skills/single-work-analysis/references/api-contracts/tiktok-analytics-api.md +968 -0
  340. package/skills/single-work-analysis/references/api-contracts/tiktok-app-v3-api.md +5735 -0
  341. package/skills/single-work-analysis/references/api-contracts/tiktok-creator-api.md +1951 -0
  342. package/skills/single-work-analysis/references/api-contracts/tiktok-interaction-api.md +742 -0
  343. package/skills/single-work-analysis/references/api-contracts/tiktok-shop-web-api.md +1890 -0
  344. package/skills/single-work-analysis/references/api-contracts/tiktok-web-api.md +4448 -0
  345. package/skills/single-work-analysis/references/api-contracts/toutiao-app-api.md +342 -0
  346. package/skills/single-work-analysis/references/api-contracts/toutiao-web-api.md +143 -0
  347. package/skills/single-work-analysis/references/api-contracts/twitter-web-api.md +989 -0
  348. package/skills/single-work-analysis/references/api-contracts/wechat-channels-api.md +809 -0
  349. package/skills/single-work-analysis/references/api-contracts/wechat-media-platform-web-api.md +677 -0
  350. package/skills/single-work-analysis/references/api-contracts/weibo-app-api.md +1547 -0
  351. package/skills/single-work-analysis/references/api-contracts/weibo-web-api.md +798 -0
  352. package/skills/single-work-analysis/references/api-contracts/weibo-web-v2-api.md +2459 -0
  353. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-app-api.md +1291 -0
  354. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-app-v2-api.md +1683 -0
  355. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-web-api.md +1324 -0
  356. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-web-v2-api.md +1209 -0
  357. package/skills/single-work-analysis/references/api-contracts/xigua-app-v2-api.md +489 -0
  358. package/skills/single-work-analysis/references/api-contracts/youtube-web-api.md +2636 -0
  359. package/skills/single-work-analysis/references/api-contracts/youtube-web-v2-api.md +2660 -0
  360. package/skills/single-work-analysis/references/api-contracts/zhihu-web-api.md +2315 -0
  361. package/skills/single-work-analysis/references/api-tags/asr-api.md +100 -0
  362. package/skills/single-work-analysis/references/api-tags/bilibili-app-api.md +482 -0
  363. package/skills/single-work-analysis/references/api-tags/bilibili-web-api.md +1267 -0
  364. package/skills/single-work-analysis/references/api-tags/demo-api.md +365 -0
  365. package/skills/single-work-analysis/references/api-tags/douyin-app-v3-api.md +2012 -0
  366. package/skills/single-work-analysis/references/api-tags/douyin-billboard-api.md +1428 -0
  367. package/skills/single-work-analysis/references/api-tags/douyin-creator-api.md +694 -0
  368. package/skills/single-work-analysis/references/api-tags/douyin-creator-v2-api.md +694 -0
  369. package/skills/single-work-analysis/references/api-tags/douyin-search-api.md +1059 -0
  370. package/skills/single-work-analysis/references/api-tags/douyin-web-api.md +3314 -0
  371. package/skills/single-work-analysis/references/api-tags/douyin-xingtu-api.md +935 -0
  372. package/skills/single-work-analysis/references/api-tags/douyin-xingtu-v2-api.md +925 -0
  373. package/skills/single-work-analysis/references/api-tags/health-check.md +40 -0
  374. package/skills/single-work-analysis/references/api-tags/hybrid-parsing.md +57 -0
  375. package/skills/single-work-analysis/references/api-tags/instagram-v1-api.md +1224 -0
  376. package/skills/single-work-analysis/references/api-tags/instagram-v2-api.md +1147 -0
  377. package/skills/single-work-analysis/references/api-tags/instagram-v3-api.md +1123 -0
  378. package/skills/single-work-analysis/references/api-tags/ios-shortcut.md +45 -0
  379. package/skills/single-work-analysis/references/api-tags/kuaishou-app-api.md +846 -0
  380. package/skills/single-work-analysis/references/api-tags/kuaishou-web-api.md +551 -0
  381. package/skills/single-work-analysis/references/api-tags/lemon8-app-api.md +687 -0
  382. package/skills/single-work-analysis/references/api-tags/linkedin-web-api.md +1105 -0
  383. package/skills/single-work-analysis/references/api-tags/media-ingest-api.md +112 -0
  384. package/skills/single-work-analysis/references/api-tags/pipixia-app-api.md +721 -0
  385. package/skills/single-work-analysis/references/api-tags/reddit-app-api.md +1057 -0
  386. package/skills/single-work-analysis/references/api-tags/sora2-api.md +737 -0
  387. package/skills/single-work-analysis/references/api-tags/temp-mail-api.md +136 -0
  388. package/skills/single-work-analysis/references/api-tags/threads-web-api.md +472 -0
  389. package/skills/single-work-analysis/references/api-tags/tikhub-downloader-api.md +65 -0
  390. package/skills/single-work-analysis/references/api-tags/tikhub-user-api.md +253 -0
  391. package/skills/single-work-analysis/references/api-tags/tiktok-ads-api.md +1393 -0
  392. package/skills/single-work-analysis/references/api-tags/tiktok-analytics-api.md +179 -0
  393. package/skills/single-work-analysis/references/api-tags/tiktok-app-v3-api.md +3264 -0
  394. package/skills/single-work-analysis/references/api-tags/tiktok-creator-api.md +709 -0
  395. package/skills/single-work-analysis/references/api-tags/tiktok-interaction-api.md +366 -0
  396. package/skills/single-work-analysis/references/api-tags/tiktok-shop-web-api.md +663 -0
  397. package/skills/single-work-analysis/references/api-tags/tiktok-web-api.md +2516 -0
  398. package/skills/single-work-analysis/references/api-tags/toutiao-app-api.md +220 -0
  399. package/skills/single-work-analysis/references/api-tags/toutiao-web-api.md +96 -0
  400. package/skills/single-work-analysis/references/api-tags/twitter-web-api.md +562 -0
  401. package/skills/single-work-analysis/references/api-tags/wechat-channels-api.md +405 -0
  402. package/skills/single-work-analysis/references/api-tags/wechat-media-platform-web-api.md +431 -0
  403. package/skills/single-work-analysis/references/api-tags/weibo-app-api.md +851 -0
  404. package/skills/single-work-analysis/references/api-tags/weibo-web-api.md +470 -0
  405. package/skills/single-work-analysis/references/api-tags/weibo-web-v2-api.md +1405 -0
  406. package/skills/single-work-analysis/references/api-tags/xiaohongshu-app-api.md +534 -0
  407. package/skills/single-work-analysis/references/api-tags/xiaohongshu-app-v2-api.md +934 -0
  408. package/skills/single-work-analysis/references/api-tags/xiaohongshu-web-api.md +757 -0
  409. package/skills/single-work-analysis/references/api-tags/xiaohongshu-web-v2-api.md +762 -0
  410. package/skills/single-work-analysis/references/api-tags/xigua-app-v2-api.md +308 -0
  411. package/skills/single-work-analysis/references/api-tags/youtube-web-api.md +934 -0
  412. package/skills/single-work-analysis/references/api-tags/youtube-web-v2-api.md +717 -0
  413. package/skills/single-work-analysis/references/api-tags/zhihu-web-api.md +1384 -0
  414. package/skills/single-work-analysis/references/asr-and-fallback.md +20 -0
  415. package/skills/single-work-analysis/references/config-templates/defaults.yaml +58 -0
  416. package/skills/single-work-analysis/references/contracts/work-card-fields.md +41 -0
  417. package/skills/single-work-analysis/references/platform-guides/douyin.md +47 -0
  418. package/skills/single-work-analysis/references/platform-guides/generic.md +43 -0
  419. package/skills/single-work-analysis/references/platform-guides/xiaohongshu.md +54 -0
  420. package/skills/single-work-analysis/references/prompt-contracts/asr-clean.md +28 -0
  421. package/skills/single-work-analysis/references/prompt-contracts/cta.md +24 -0
  422. package/skills/single-work-analysis/references/prompt-contracts/hook.md +25 -0
  423. package/skills/single-work-analysis/references/prompt-contracts/insight.md +47 -0
  424. package/skills/single-work-analysis/references/prompt-contracts/structure.md +25 -0
  425. package/skills/single-work-analysis/references/prompt-contracts/style.md +27 -0
  426. package/skills/single-work-analysis/references/prompt-contracts/summary.md +29 -0
  427. package/skills/single-work-analysis/references/prompt-contracts/topic.md +29 -0
  428. package/skills/single-work-analysis/references/schemas/work-card.schema.json +39 -0
  429. package/skills/single-work-analysis/references/service-guides/asr-u2-u3-fallback.md +75 -0
  430. package/skills/single-work-analysis/scripts/__init__.py +0 -0
  431. package/skills/single-work-analysis/scripts/core/__init__.py +0 -0
  432. package/skills/single-work-analysis/scripts/core/analysis_pipeline.py +133 -0
  433. package/skills/single-work-analysis/scripts/core/bootstrap_env.py +35 -0
  434. package/skills/single-work-analysis/scripts/core/config_loader.py +418 -0
  435. package/skills/single-work-analysis/scripts/core/extract_pipeline.py +173 -0
  436. package/skills/single-work-analysis/scripts/core/progress_report.py +111 -0
  437. package/skills/single-work-analysis/scripts/core/storage_router.py +253 -0
  438. package/skills/single-work-analysis/scripts/core/tikomni_common.py +588 -0
  439. package/skills/single-work-analysis/scripts/pipeline/__init__.py +0 -0
  440. package/skills/single-work-analysis/scripts/pipeline/asr/__init__.py +0 -0
  441. package/skills/single-work-analysis/scripts/pipeline/asr/asr_pipeline.py +1189 -0
  442. package/skills/single-work-analysis/scripts/pipeline/asr/poll_u2_task.py +95 -0
  443. package/skills/single-work-analysis/scripts/platform/__init__.py +0 -0
  444. package/skills/single-work-analysis/scripts/platform/douyin/__init__.py +0 -0
  445. package/skills/single-work-analysis/scripts/platform/douyin/douyin_video_type_matrix.py +224 -0
  446. package/skills/single-work-analysis/scripts/platform/douyin/run_douyin_single_video.py +1233 -0
  447. package/skills/single-work-analysis/scripts/platform/douyin/select_low_quality_video_url.py +200 -0
  448. package/skills/single-work-analysis/scripts/platform/xiaohongshu/__init__.py +0 -0
  449. package/skills/single-work-analysis/scripts/platform/xiaohongshu/run_xiaohongshu_extract.py +2156 -0
  450. package/skills/single-work-analysis/scripts/writers/__init__.py +0 -0
  451. package/skills/single-work-analysis/scripts/writers/write_benchmark_card.py +1402 -0
@@ -0,0 +1,2630 @@
1
+ # Instagram-V3-API Full Contract
2
+
3
+ - Back to index: [`api-capability-index.md`](../api-capability-index.md)
4
+ - Back to route summary: [`api-tags/instagram-v3-api.md`](../api-tags/instagram-v3-api.md)
5
+ - Current contract file: `api-contracts/instagram-v3-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: `26`
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: **(Instagram V3数据接口/Instagram-V3-API endpoints)**
12
+
13
+ ## Route Contracts
14
+
15
+ <a id="get-api-u1-v1-instagram-v3-bulk-translate-comments"></a>
16
+ ### `GET /api/u1/v1/instagram/v3/bulk_translate_comments`
17
+
18
+ - Summary: 批量翻译评论/Bulk translate comments
19
+ - Capabilities: comments
20
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
21
+ - operationId: `bulk_translate_comments_api_v1_instagram_v3_bulk_translate_comments_get`
22
+
23
+ #### Notes
24
+
25
+ > # [中文]
26
+ > ### 用途:
27
+ > - 批量翻译Instagram评论
28
+ > - 支持同时翻译多条评论,效率更高
29
+ > - 评论ID可从 get_post_comments 接口获取
30
+ > ### 参数:
31
+ > - comment_ids: 评论ID列表,多个ID用逗号分隔,**最多10条**
32
+ > - 例如: `18099342953509681` (单个)
33
+ > - 例如: `18099342953509681,18099342953509682,18099342953509683` (多个)
34
+ > ### 注意:
35
+ > - 单次请求最多支持10条评论ID,超过会返回错误
36
+ > ### 返回:
37
+ > - `data.comment_translations`: 翻译结果映射
38
+ > - key: 评论ID
39
+ > - value: 翻译后的文本
40
+ > ### 价格:
41
+ > - 0.002 USD/请求
42
+ >
43
+ > # [English]
44
+ > ### Purpose:
45
+ > - Bulk translate Instagram comments
46
+ > - Support translating multiple comments at once for better efficiency
47
+ > - Comment IDs can be obtained from get_post_comments API
48
+ > ### Parameters:
49
+ > - comment_ids: Comment ID list, separated by commas, **max 10 IDs**
50
+ > - Example: `18099342953509681` (single)
51
+ > - Example: `18099342953509681,18099342953509682,18099342953509683` (multiple)
52
+ > ### Note:
53
+ > - Maximum 10 comment IDs per request, exceeding will return an error
54
+ > ### Return:
55
+ > - `data.comment_translations`: Translation result mapping
56
+ > - key: Comment ID
57
+ > - value: Translated text
58
+ > ### Price:
59
+ > - 0.002 USD/request
60
+ >
61
+ > ### 示例/Example
62
+ > ```
63
+ > comment_ids = "18099342953509681"
64
+ > # comment_ids = "18099342953509681,18099342953509682"
65
+ > ```
66
+
67
+ #### Parameters
68
+
69
+ | Field | In | Type | Required | Description | Default | Example | Enum |
70
+ | --- | --- | --- | --- | --- | --- | --- | --- |
71
+ | comment_ids | query | string | Yes | 评论ID列表,逗号分隔/Comment ID list, comma separated | None | 18099342953509681 | None |
72
+
73
+ #### Request Body
74
+
75
+ None
76
+
77
+ #### Success Response
78
+
79
+ ##### `200 application/json`
80
+
81
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
82
+
83
+ | Field | Type | Required | Description | Default | Example | Enum |
84
+ | --- | --- | --- | --- | --- | --- | --- |
85
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
86
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
87
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
88
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
89
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
90
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
91
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
92
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
93
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
94
+ | 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 |
95
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
96
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
97
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
98
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
99
+ | data | null | No | The response data \| 响应数据 | None | None | None |
100
+
101
+ <a id="get-api-u1-v1-instagram-v3-general-search"></a>
102
+ ### `GET /api/u1/v1/instagram/v3/general_search`
103
+
104
+ - Summary: 综合搜索(支持分页)/General search (with pagination)
105
+ - Capabilities: search
106
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
107
+ - operationId: `general_search_api_v1_instagram_v3_general_search_get`
108
+
109
+ #### Notes
110
+
111
+ > # [中文]
112
+ > ### 用途:
113
+ > - Instagram综合搜索接口(支持分页)
114
+ > - 支持通过 next_max_id 分页获取大量搜索结果
115
+ > - 返回用户、话题标签、地点等综合结果
116
+ > ### 参数:
117
+ > - query: 搜索关键词
118
+ > - next_max_id: 分页ID,首次请求不传,从上一次响应的 `data.next_max_id` 获取
119
+ > - rank_token: 排序token,首次请求不传,从上一次响应的 `data.rank_token` 获取
120
+ > - enable_metadata: 是否启用元数据
121
+ > ### 返回:
122
+ > - `data.num_results`: 结果数量
123
+ > - `data.users`: 用户搜索结果列表
124
+ > - `data.places`: 地点搜索结果列表
125
+ > - `data.hashtags`: 话题标签搜索结果列表
126
+ > - `data.next_max_id`: 下一页分页ID(传给下次请求的next_max_id参数)
127
+ > - `data.rank_token`: 排序token(传给下次请求的rank_token参数)
128
+ > - `data.has_more`: 是否有更多结果
129
+ > ### 注意事项:
130
+ > - ⚠️ **已知问题**: 综合搜索结果可能存在重复数据,这是 Instagram API 的已知行为
131
+ > - 搜索话题标签时,query 需要带上 `#` 前缀,例如搜索 fashion 话题应传入 `#fashion`
132
+ > - `#` 符号在 URL 中需要进行 URL 编码为 `%23`,例如: `?query=%23fashion`
133
+ > - 如果使用 HTTP 客户端库(如 requests/httpx),直接传入 `#fashion` 即可,库会自动处理编码
134
+ > ### 分页使用方法:
135
+ > 1. 首次请求:只传 `query` 参数
136
+ > 2. 获取响应中的 `next_max_id` 和 `rank_token`
137
+ > 3. 下次请求:传入 `query`、`next_max_id` 和 `rank_token`
138
+ > 4. 重复步骤 2-3 直到 `has_more` 为 false
139
+ > ### 价格:
140
+ > - 0.002 USD/请求
141
+ >
142
+ > # [English]
143
+ > ### Purpose:
144
+ > - Instagram general search API (with pagination)
145
+ > - Support pagination via next_max_id to fetch more search results
146
+ > - Returns blended results of users, hashtags, places, etc.
147
+ > ### Parameters:
148
+ > - query: Search keyword
149
+ > - next_max_id: Pagination ID, omit for first request, get from previous response `data.next_max_id`
150
+ > - rank_token: Rank token, omit for first request, get from previous response `data.rank_token`
151
+ > - enable_metadata: Enable metadata
152
+ > ### Return:
153
+ > - `data.num_results`: Number of results
154
+ > - `data.users`: User search results
155
+ > - `data.places`: Place search results
156
+ > - `data.hashtags`: Hashtag search results
157
+ > - `data.next_max_id`: Next page pagination ID (use as next_max_id in next request)
158
+ > - `data.rank_token`: Rank token (use as rank_token in next request)
159
+ > - `data.has_more`: Whether has more results
160
+ > ### Notes:
161
+ > - ⚠️ **Known Issue**: General search results may contain duplicate data, this is a known behavior of Instagram API
162
+ > - When searching for hashtags, `query` must include the `#` prefix, e.g., use `#fashion` to search for the fashion hashtag
163
+ > - The `#` character must be URL-encoded as `%23` in the URL, e.g., `?query=%23fashion`
164
+ > - If using an HTTP client library (e.g., requests/httpx), just pass `#fashion` directly and the library will handle encoding automatically
165
+ > ### Pagination usage:
166
+ > 1. First request: Only pass `query` parameter
167
+ > 2. Get `next_max_id` and `rank_token` from response
168
+ > 3. Next request: Pass `query`, `next_max_id` and `rank_token`
169
+ > 4. Repeat steps 2-3 until `has_more` is false
170
+ > ### Price:
171
+ > - 0.002 USD/request
172
+ >
173
+ > ### 示例/Example
174
+ > ```
175
+ > query = "justin"
176
+ > ```
177
+
178
+ #### Parameters
179
+
180
+ | Field | In | Type | Required | Description | Default | Example | Enum |
181
+ | --- | --- | --- | --- | --- | --- | --- | --- |
182
+ | query | query | string | Yes | 搜索关键词/Search keyword | None | justin | None |
183
+ | next_max_id | query | string | No | 分页ID,首次请求不传,从上一次响应的next_max_id获取/Pagination ID, omit for first request, get from previous response next_max_id | None | None | None |
184
+ | rank_token | query | string | No | 排序token,首次请求不传,从上一次响应获取/Rank token, omit for first request, get from previous response | None | None | None |
185
+ | enable_metadata | query | boolean | No | 是否启用元数据/Enable metadata | true | None | None |
186
+
187
+ #### Request Body
188
+
189
+ None
190
+
191
+ #### Success Response
192
+
193
+ ##### `200 application/json`
194
+
195
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
196
+
197
+ | Field | Type | Required | Description | Default | Example | Enum |
198
+ | --- | --- | --- | --- | --- | --- | --- |
199
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
200
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
201
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
202
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
203
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
204
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
205
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
206
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
207
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
208
+ | 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 |
209
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
210
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
211
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
212
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
213
+ | data | null | No | The response data \| 响应数据 | None | None | None |
214
+
215
+ <a id="get-api-u1-v1-instagram-v3-get-comment-replies"></a>
216
+ ### `GET /api/u1/v1/instagram/v3/get_comment_replies`
217
+
218
+ - Summary: 获取评论的子评论/回复/Get comment replies
219
+ - Capabilities: comments
220
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
221
+ - operationId: `get_comment_replies_api_v1_instagram_v3_get_comment_replies_get`
222
+
223
+ #### Notes
224
+
225
+ > # [中文]
226
+ > ### 用途:
227
+ > - 获取Instagram评论的子评论(回复)列表
228
+ > - 支持分页获取所有回复
229
+ > - 父评论的 comment_id 可从 get_post_comments 接口的评论列表中获取
230
+ > - 支持通过 media_id、短代码(code)或帖子URL定位帖子
231
+ > ### 参数(三选一定位帖子):
232
+ > - media_id: 帖子的媒体ID(数字ID)
233
+ > - code: 帖子短代码(如 DUajw4YkorV)
234
+ > - url: 帖子URL(如 `https://www.instagram.com/p/DUajw4YkorV/`)
235
+ > ### 必填参数:
236
+ > - comment_id: 父评论ID(从 get_post_comments 返回的评论中获取 `pk` 字段)
237
+ > ### 其他参数:
238
+ > - min_id: 分页游标,首次请求不传,从上一次响应的 `data.next_min_child_cursor` 获取
239
+ > ### 返回:
240
+ > - `data.child_comments`: 子评论列表
241
+ > - `user`: 评论者信息
242
+ > - `text`: 评论文本
243
+ > - `created_at`: 评论时间戳
244
+ > - `comment_like_count`: 评论点赞数
245
+ > - `pk`: 评论ID
246
+ > - `data.next_min_child_cursor`: 下一页分页游标(传给下次请求的min_id参数)
247
+ > - `data.has_more_tail_child_comments`: 是否有更多子评论
248
+ > - `data.num_tail_child_comments`: 剩余子评论数
249
+ > ### 分页使用方法:
250
+ > 1. 首次请求:传 `media_id` 和 `comment_id` 参数
251
+ > 2. 获取响应中的 `data.next_min_child_cursor`
252
+ > 3. 下次请求:传入 `media_id`、`comment_id` 和 `min_id` (使用上次的next_min_child_cursor)
253
+ > 4. 重复步骤 2-3 直到 `data.has_more_tail_child_comments` 为 false
254
+ > ### 价格:
255
+ > - 0.002 USD/请求
256
+ >
257
+ > # [English]
258
+ > ### Purpose:
259
+ > - Get Instagram comment's child comments (replies) list
260
+ > - Support pagination to fetch all replies
261
+ > - Parent comment's comment_id can be obtained from get_post_comments API
262
+ > - Support querying by media_id, shortcode (code), or post URL
263
+ > ### Parameters (one of to locate post):
264
+ > - media_id: Post media ID (numeric ID)
265
+ > - code: Post shortcode (e.g., DUajw4YkorV)
266
+ > - url: Post URL (e.g., `https://www.instagram.com/p/DUajw4YkorV/`)
267
+ > ### Required:
268
+ > - comment_id: Parent comment ID (get `pk` field from get_post_comments response)
269
+ > ### Other parameters:
270
+ > - min_id: Pagination cursor, omit for first request, get from previous response `data.next_min_child_cursor`
271
+ > ### Return:
272
+ > - `data.child_comments`: Child comments list
273
+ > - `user`: Commenter info
274
+ > - `text`: Comment text
275
+ > - `created_at`: Comment timestamp
276
+ > - `comment_like_count`: Comment likes count
277
+ > - `pk`: Comment ID
278
+ > - `data.next_min_child_cursor`: Next page cursor (use as min_id in next request)
279
+ > - `data.has_more_tail_child_comments`: Whether has more child comments
280
+ > - `data.num_tail_child_comments`: Remaining child comments count
281
+ > ### Pagination usage:
282
+ > 1. First request: Pass `media_id` and `comment_id` parameters
283
+ > 2. Get `data.next_min_child_cursor` from response
284
+ > 3. Next request: Pass `media_id`, `comment_id`, and `min_id` (use next_min_child_cursor from previous)
285
+ > 4. Repeat steps 2-3 until `data.has_more_tail_child_comments` is false
286
+ > ### Price:
287
+ > - 0.002 USD/request
288
+ >
289
+ > ### 示例/Example
290
+ > media_id = "3829530490739515971"
291
+ > comment_id = "18065937092249736"
292
+
293
+ #### Parameters
294
+
295
+ | Field | In | Type | Required | Description | Default | Example | Enum |
296
+ | --- | --- | --- | --- | --- | --- | --- | --- |
297
+ | media_id | query | string | No | 帖子媒体ID/Post media ID | None | 3829530490739515971 | None |
298
+ | code | query | string | No | 帖子短代码/Post shortcode | None | DUajw4YkorV | None |
299
+ | url | query | string | No | 帖子URL/Post URL | None | https://www.instagram.com/p/DUajw4YkorV/ | None |
300
+ | comment_id | query | string | Yes | 父评论ID/Parent comment ID | None | 18065937092249736 | None |
301
+ | min_id | query | string | No | 分页游标,首次请求不传,从上一次响应的 next_min_child_cursor 获取/Pagination cursor, omit for first request, get from previous response next_min_child_cursor | None | None | None |
302
+
303
+ #### Request Body
304
+
305
+ None
306
+
307
+ #### Success Response
308
+
309
+ ##### `200 application/json`
310
+
311
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
312
+
313
+ | Field | Type | Required | Description | Default | Example | Enum |
314
+ | --- | --- | --- | --- | --- | --- | --- |
315
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
316
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
317
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
318
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
319
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
320
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
321
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
322
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
323
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
324
+ | 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 |
325
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
326
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
327
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
328
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
329
+ | data | null | No | The response data \| 响应数据 | None | None | None |
330
+
331
+ <a id="get-api-u1-v1-instagram-v3-get-explore"></a>
332
+ ### `GET /api/u1/v1/instagram/v3/get_explore`
333
+
334
+ - Summary: 获取探索页推荐帖子/Get explore feed
335
+ - Capabilities: general
336
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
337
+ - operationId: `get_explore_api_v1_instagram_v3_get_explore_get`
338
+
339
+ #### Notes
340
+
341
+ > # [中文]
342
+ > ### 用途:
343
+ > - 获取Instagram探索/发现页的推荐帖子
344
+ > - 返回个性化推荐的帖子列表
345
+ > - 支持分页获取更多推荐内容
346
+ > ### 参数:
347
+ > - max_id: 分页游标,首次请求不传,从上一次响应的 `data.next_max_id` 获取
348
+ > ### 返回:
349
+ > - `data.sectional_items`: 推荐内容分区列表
350
+ > - `layout_content.medias`: 媒体列表
351
+ > - `media.id`: 帖子ID
352
+ > - `media.code`: 帖子短代码
353
+ > - `media.media_type`: 媒体类型(1=图片, 2=视频, 8=合集)
354
+ > - `media.like_count`: 点赞数
355
+ > - `media.comment_count`: 评论数
356
+ > - `media.caption.text`: 帖子文本
357
+ > - `media.user`: 发布者信息
358
+ > - `media.image_versions2`: 图片版本列表
359
+ > - `media.video_versions`: 视频版本列表(视频时存在)
360
+ > - `data.next_max_id`: 下一页分页游标(传给下次请求的max_id参数)
361
+ > - `data.more_available`: 是否有更多内容
362
+ > ### 分页使用方法:
363
+ > 1. 首次请求:不传任何参数
364
+ > 2. 获取响应中的 `data.next_max_id`
365
+ > 3. 下次请求:传入 `max_id` (使用上次的next_max_id)
366
+ > 4. 重复步骤 2-3 直到 `data.more_available` 为 false
367
+ > ### 价格:
368
+ > - 0.002 USD/请求
369
+ >
370
+ > # [English]
371
+ > ### Purpose:
372
+ > - Get Instagram Explore/Discover page recommended posts
373
+ > - Returns personalized recommended post list
374
+ > - Support pagination to fetch more recommendations
375
+ > ### Parameters:
376
+ > - max_id: Pagination cursor, omit for first request, get from previous response `data.next_max_id`
377
+ > ### Return:
378
+ > - `data.sectional_items`: Recommended content section list
379
+ > - `layout_content.medias`: Media list
380
+ > - `media.id`: Post ID
381
+ > - `media.code`: Post shortcode
382
+ > - `media.media_type`: Media type (1=image, 2=video, 8=carousel)
383
+ > - `media.like_count`: Likes count
384
+ > - `media.comment_count`: Comments count
385
+ > - `media.caption.text`: Post caption text
386
+ > - `media.user`: Publisher info
387
+ > - `media.image_versions2`: Image version list
388
+ > - `media.video_versions`: Video version list (exists for videos)
389
+ > - `data.next_max_id`: Next page cursor (use as max_id in next request)
390
+ > - `data.more_available`: Whether has more content
391
+ > ### Pagination usage:
392
+ > 1. First request: No parameters needed
393
+ > 2. Get `data.next_max_id` from response
394
+ > 3. Next request: Pass `max_id` (use next_max_id from previous)
395
+ > 4. Repeat steps 2-3 until `data.more_available` is false
396
+ > ### Price:
397
+ > - 0.002 USD/request
398
+ >
399
+ > ### 示例/Example
400
+ > ```
401
+ > # 第一页 / First page (不传参数 / no parameters)
402
+ > # 第二页 / Second page
403
+ > # max_id = "..." # 从第一页响应中获取 / Get from first page response
404
+ > ```
405
+
406
+ #### Parameters
407
+
408
+ | Field | In | Type | Required | Description | Default | Example | Enum |
409
+ | --- | --- | --- | --- | --- | --- | --- | --- |
410
+ | max_id | query | string | No | 分页游标,首次请求不传,从上一次响应的 next_max_id 获取/Pagination cursor, omit for first request, get from previous response next_max_id | None | None | None |
411
+
412
+ #### Request Body
413
+
414
+ None
415
+
416
+ #### Success Response
417
+
418
+ ##### `200 application/json`
419
+
420
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
421
+
422
+ | Field | Type | Required | Description | Default | Example | Enum |
423
+ | --- | --- | --- | --- | --- | --- | --- |
424
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
425
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
426
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
427
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
428
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
429
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
430
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
431
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
432
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
433
+ | 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 |
434
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
435
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
436
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
437
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
438
+ | data | null | No | The response data \| 响应数据 | None | None | None |
439
+
440
+ <a id="get-api-u1-v1-instagram-v3-get-highlight-stories"></a>
441
+ ### `GET /api/u1/v1/instagram/v3/get_highlight_stories`
442
+
443
+ - Summary: 获取Highlight精选详情/Get highlight stories
444
+ - Capabilities: general
445
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
446
+ - operationId: `get_highlight_stories_api_v1_instagram_v3_get_highlight_stories_get`
447
+
448
+ #### Notes
449
+
450
+ > # [中文]
451
+ > ### 用途:
452
+ > - 获取Instagram Highlight精选的详细故事/帖子内容
453
+ > - 返回精选集合中的所有Stories媒体
454
+ > ### 参数:
455
+ > - highlight_id: 精选ID,格式为 `highlight:xxx`(从 get_user_highlights 接口获取)
456
+ > - reel_ids: 精选ID列表,逗号分隔(可选,如不提供则仅查询highlight_id指定的精选)
457
+ > - 例如: `highlight:18064916456320419,highlight:18155682898389765`
458
+ > - 可同时查询多个精选的内容
459
+ > ### 返回:
460
+ > - `data.story_highlight_tray`: 精选故事集合
461
+ > - `id`: 精选ID
462
+ > - `title`: 精选标题
463
+ > - `items`: 故事列表
464
+ > - `id`: 故事ID
465
+ > - `pk`: 故事PK
466
+ > - `taken_at`: 发布时间戳
467
+ > - `media_type`: 媒体类型(1=图片, 2=视频)
468
+ > - `image_versions2`: 图片版本列表
469
+ > - `video_versions`: 视频版本列表(视频时存在)
470
+ > - `user`: 发布者信息
471
+ > ### 价格:
472
+ > - 0.002 USD/请求
473
+ >
474
+ > # [English]
475
+ > ### Purpose:
476
+ > - Get Instagram Highlight's detailed story/post content
477
+ > - Returns all Stories media in the highlight collection
478
+ > ### Parameters:
479
+ > - highlight_id: Highlight ID, format `highlight:xxx` (get from get_user_highlights API)
480
+ > - reel_ids: Highlight ID list, comma separated (optional, if not provided only queries the highlight_id)
481
+ > - Example: `highlight:18064916456320419,highlight:18155682898389765`
482
+ > - Can query multiple highlights at once
483
+ > ### Return:
484
+ > - `data.story_highlight_tray`: Highlight story collection
485
+ > - `id`: Highlight ID
486
+ > - `title`: Highlight title
487
+ > - `items`: Story list
488
+ > - `id`: Story ID
489
+ > - `pk`: Story PK
490
+ > - `taken_at`: Published timestamp
491
+ > - `media_type`: Media type (1=image, 2=video)
492
+ > - `image_versions2`: Image version list
493
+ > - `video_versions`: Video version list (exists for videos)
494
+ > - `user`: Publisher info
495
+ > ### Price:
496
+ > - 0.002 USD/request
497
+ >
498
+ > ### 示例/Example
499
+ > ```
500
+ > highlight_id = "highlight:18064916456320419"
501
+ > # reel_ids = "highlight:18064916456320419,highlight:18155682898389765"
502
+ > ```
503
+
504
+ #### Parameters
505
+
506
+ | Field | In | Type | Required | Description | Default | Example | Enum |
507
+ | --- | --- | --- | --- | --- | --- | --- | --- |
508
+ | highlight_id | query | string | Yes | 精选ID/Highlight ID (格式/format: highlight:xxx) | None | highlight:18064916456320419 | None |
509
+ | reel_ids | query | string | No | 精选ID列表,逗号分隔,如不提供则仅查询highlight_id/Highlight ID list, comma separated, if not provided only query highlight_id | None | None | None |
510
+
511
+ #### Request Body
512
+
513
+ None
514
+
515
+ #### Success Response
516
+
517
+ ##### `200 application/json`
518
+
519
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
520
+
521
+ | Field | Type | Required | Description | Default | Example | Enum |
522
+ | --- | --- | --- | --- | --- | --- | --- |
523
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
524
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
525
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
526
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
527
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
528
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
529
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
530
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
531
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
532
+ | 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 |
533
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
534
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
535
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
536
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
537
+ | data | null | No | The response data \| 响应数据 | None | None | None |
538
+
539
+ <a id="get-api-u1-v1-instagram-v3-get-location-info"></a>
540
+ ### `GET /api/u1/v1/instagram/v3/get_location_info`
541
+
542
+ - Summary: 获取地点详情/Get location info
543
+ - Capabilities: general
544
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
545
+ - operationId: `get_location_info_api_v1_instagram_v3_get_location_info_get`
546
+
547
+ #### Notes
548
+
549
+ > # [中文]
550
+ > ### 用途:
551
+ > - 获取Instagram地点的详细信息
552
+ > - 包含地点名称、地址、坐标、附近地点等
553
+ > - 地点ID可从搜索接口(search_places)或帖子详情中获取
554
+ > ### 参数:
555
+ > - location_id: 地点ID(数字)
556
+ > - show_nearby: 是否显示附近地点(默认true)
557
+ > ### 返回:
558
+ > - `data.native_location_data`: 地点基本信息
559
+ > - `name`: 地点名称
560
+ > - `address`: 地址
561
+ > - `city`: 城市
562
+ > - `lat`: 纬度
563
+ > - `lng`: 经度
564
+ > - `website`: 网站
565
+ > - `phone`: 电话
566
+ > - `category`: 分类
567
+ > - `media_count`: 关联帖子数
568
+ > - `data.ranked`: 热门帖子信息
569
+ > - `data.recent`: 最新帖子信息
570
+ > - `data.nearby_locations`: 附近地点列表(show_nearby=true时)
571
+ > ### 价格:
572
+ > - 0.002 USD/请求
573
+ >
574
+ > # [English]
575
+ > ### Purpose:
576
+ > - Get Instagram location/place detail info
577
+ > - Including name, address, coordinates, nearby places, etc.
578
+ > - Location ID can be obtained from search API (search_places) or post details
579
+ > ### Parameters:
580
+ > - location_id: Location ID (numeric)
581
+ > - show_nearby: Whether to show nearby places (default true)
582
+ > ### Return:
583
+ > - `data.native_location_data`: Location basic info
584
+ > - `name`: Location name
585
+ > - `address`: Address
586
+ > - `city`: City
587
+ > - `lat`: Latitude
588
+ > - `lng`: Longitude
589
+ > - `website`: Website
590
+ > - `phone`: Phone
591
+ > - `category`: Category
592
+ > - `media_count`: Associated posts count
593
+ > - `data.ranked`: Top posts info
594
+ > - `data.recent`: Recent posts info
595
+ > - `data.nearby_locations`: Nearby locations list (when show_nearby=true)
596
+ > ### Price:
597
+ > - 0.002 USD/request
598
+ >
599
+ > ### 示例/Example
600
+ > location_id = "1016248898"
601
+
602
+ #### Parameters
603
+
604
+ | Field | In | Type | Required | Description | Default | Example | Enum |
605
+ | --- | --- | --- | --- | --- | --- | --- | --- |
606
+ | location_id | query | string | Yes | 地点ID/Location ID | None | 1016248898 | None |
607
+ | show_nearby | query | boolean | No | 是否显示附近地点/Whether to show nearby places | true | None | None |
608
+
609
+ #### Request Body
610
+
611
+ None
612
+
613
+ #### Success Response
614
+
615
+ ##### `200 application/json`
616
+
617
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
618
+
619
+ | Field | Type | Required | Description | Default | Example | Enum |
620
+ | --- | --- | --- | --- | --- | --- | --- |
621
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
622
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
623
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
624
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
625
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
626
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
627
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
628
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
629
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
630
+ | 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 |
631
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
632
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
633
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
634
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
635
+ | data | null | No | The response data \| 响应数据 | None | None | None |
636
+
637
+ <a id="get-api-u1-v1-instagram-v3-get-location-posts"></a>
638
+ ### `GET /api/u1/v1/instagram/v3/get_location_posts`
639
+
640
+ - Summary: 获取地点相关帖子/Get location posts
641
+ - Capabilities: content details
642
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
643
+ - operationId: `get_location_posts_api_v1_instagram_v3_get_location_posts_get`
644
+
645
+ #### Notes
646
+
647
+ > # [中文]
648
+ > ### 用途:
649
+ > - 获取Instagram地点相关的帖子列表
650
+ > - 支持按热门或最新排序
651
+ > - 地点ID可从搜索接口(search_places)或帖子详情中获取
652
+ > ### 参数:
653
+ > - location_id: 地点ID(数字)
654
+ > - tab: 帖子排序方式
655
+ > - `ranked`: 热门帖子(默认)
656
+ > - `recent`: 最新帖子
657
+ > - page_size_override: 每页帖子数量(默认12)
658
+ > ### 返回:
659
+ > - `data.sections`: 帖子分区列表
660
+ > - `layout_content.medias`: 媒体列表
661
+ > - `media.id`: 帖子ID
662
+ > - `media.code`: 帖子短代码
663
+ > - `media.media_type`: 媒体类型(1=图片, 2=视频, 8=合集)
664
+ > - `media.like_count`: 点赞数
665
+ > - `media.comment_count`: 评论数
666
+ > - `media.caption.text`: 帖子文本
667
+ > - `media.user`: 发布者信息
668
+ > - `data.next_max_id`: 下一页分页游标
669
+ > - `data.next_page`: 下一页信息
670
+ > - `data.more_available`: 是否有更多内容
671
+ > ### 价格:
672
+ > - 0.002 USD/请求
673
+ >
674
+ > # [English]
675
+ > ### Purpose:
676
+ > - Get Instagram location-related posts
677
+ > - Support sorting by top or latest
678
+ > - Location ID can be obtained from search API (search_places) or post details
679
+ > ### Parameters:
680
+ > - location_id: Location ID (numeric)
681
+ > - tab: Post sort order
682
+ > - `ranked`: Top posts (default)
683
+ > - `recent`: Latest posts
684
+ > - page_size_override: Posts per page (default 12)
685
+ > ### Return:
686
+ > - `data.sections`: Post section list
687
+ > - `layout_content.medias`: Media list
688
+ > - `media.id`: Post ID
689
+ > - `media.code`: Post shortcode
690
+ > - `media.media_type`: Media type (1=image, 2=video, 8=carousel)
691
+ > - `media.like_count`: Likes count
692
+ > - `media.comment_count`: Comments count
693
+ > - `media.caption.text`: Post caption text
694
+ > - `media.user`: Publisher info
695
+ > - `data.next_max_id`: Next page cursor
696
+ > - `data.next_page`: Next page info
697
+ > - `data.more_available`: Whether has more content
698
+ > ### Price:
699
+ > - 0.002 USD/request
700
+ >
701
+ > ### 示例/Example
702
+ > location_id = "1016248898"
703
+ > tab = "ranked"
704
+
705
+ #### Parameters
706
+
707
+ | Field | In | Type | Required | Description | Default | Example | Enum |
708
+ | --- | --- | --- | --- | --- | --- | --- | --- |
709
+ | location_id | query | string | Yes | 地点ID/Location ID | None | 1016248898 | None |
710
+ | tab | query | string | No | 帖子类型: ranked(热门), recent(最新)/Post type: ranked(top), recent(latest) | ranked | None | None |
711
+ | page_size_override | query | integer | No | 每页数量/Page size | 12 | 12 | None |
712
+
713
+ #### Request Body
714
+
715
+ None
716
+
717
+ #### Success Response
718
+
719
+ ##### `200 application/json`
720
+
721
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
722
+
723
+ | Field | Type | Required | Description | Default | Example | Enum |
724
+ | --- | --- | --- | --- | --- | --- | --- |
725
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
726
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
727
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
728
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
729
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
730
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
731
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
732
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
733
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
734
+ | 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 |
735
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
736
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
737
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
738
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
739
+ | data | null | No | The response data \| 响应数据 | None | None | None |
740
+
741
+ <a id="get-api-u1-v1-instagram-v3-get-post-comments"></a>
742
+ ### `GET /api/u1/v1/instagram/v3/get_post_comments`
743
+
744
+ - Summary: 获取帖子评论/Get post comments
745
+ - Capabilities: comments / content details
746
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
747
+ - operationId: `get_post_comments_api_v1_instagram_v3_get_post_comments_get`
748
+
749
+ #### Notes
750
+
751
+ > # [中文]
752
+ > ### 用途:
753
+ > - 获取Instagram帖子的评论列表
754
+ > - 支持分页获取所有评论
755
+ > - 支持按热门或最新排序
756
+ > - 支持通过 media_id、短代码(code)或帖子URL查询
757
+ > ### 参数(三选一):
758
+ > - media_id: 帖子的媒体ID(数字ID)
759
+ > - code: 帖子短代码(如 DUajw4YkorV)
760
+ > - url: 帖子URL(如 `https://www.instagram.com/p/DUajw4YkorV/`)
761
+ > ### 其他参数:
762
+ > - min_id: 分页游标,首次请求不传,从上一次响应的 `data.next_min_id` 获取
763
+ > - sort_order: 排序方式
764
+ > - `popular`: 按热门排序(默认)
765
+ > - `newest`: 按最新排序
766
+ > ### 返回:
767
+ > - `data.comments`: 评论列表
768
+ > - `user`: 评论者信息
769
+ > - `text`: 评论文本
770
+ > - `created_at`: 评论时间戳
771
+ > - `comment_like_count`: 评论点赞数
772
+ > - `child_comment_count`: 子评论数
773
+ > - `data.next_min_id`: 下一页分页游标(传给下次请求的min_id参数)
774
+ > - `data.has_more_comments`: 是否有更多评论
775
+ > - `data.comment_count`: 评论总数
776
+ > ### 分页使用方法:
777
+ > 1. 首次请求:传 `media_id`/`code`/`url` 参数
778
+ > 2. 获取响应中的 `data.next_min_id`
779
+ > 3. 下次请求:传入 `media_id` 和 `min_id` (使用上次的next_min_id)
780
+ > 4. 重复步骤 2-3 直到 `data.has_more_comments` 为 false
781
+ > ### 价格:
782
+ > - 0.002 USD/请求
783
+ >
784
+ > # [English]
785
+ > ### Purpose:
786
+ > - Get Instagram post comment list
787
+ > - Support pagination to fetch all comments
788
+ > - Support sorting by popular or newest
789
+ > - Support querying by media_id, shortcode (code), or post URL
790
+ > ### Parameters (one of):
791
+ > - media_id: Post media ID (numeric ID)
792
+ > - code: Post shortcode (e.g., DUajw4YkorV)
793
+ > - url: Post URL (e.g., `https://www.instagram.com/p/DUajw4YkorV/`)
794
+ > ### Other parameters:
795
+ > - min_id: Pagination cursor, omit for first request, get from previous response `data.next_min_id`
796
+ > - sort_order: Sort order
797
+ > - `popular`: Sort by popular (default)
798
+ > - `newest`: Sort by newest
799
+ > ### Return:
800
+ > - `data.comments`: Comment list
801
+ > - `user`: Commenter info
802
+ > - `text`: Comment text
803
+ > - `created_at`: Comment timestamp
804
+ > - `comment_like_count`: Comment likes count
805
+ > - `child_comment_count`: Child comments count
806
+ > - `data.next_min_id`: Next page cursor (use as min_id in next request)
807
+ > - `data.has_more_comments`: Whether has more comments
808
+ > - `data.comment_count`: Total comment count
809
+ > ### Pagination usage:
810
+ > 1. First request: Pass `media_id`/`code`/`url` parameter
811
+ > 2. Get `data.next_min_id` from response
812
+ > 3. Next request: Pass `media_id` and `min_id` (use next_min_id from previous)
813
+ > 4. Repeat steps 2-3 until `data.has_more_comments` is false
814
+ > ### Price:
815
+ > - 0.002 USD/request
816
+ >
817
+ > ### 示例/Example
818
+ > media_id = "3815455163747032886"
819
+
820
+ #### Parameters
821
+
822
+ | Field | In | Type | Required | Description | Default | Example | Enum |
823
+ | --- | --- | --- | --- | --- | --- | --- | --- |
824
+ | media_id | query | string | No | 帖子媒体ID/Post media ID | None | 3815455163747032886 | None |
825
+ | code | query | string | No | 帖子短代码/Post shortcode (e.g., DUajw4YkorV) | None | DUajw4YkorV | None |
826
+ | url | query | string | No | 帖子URL/Post URL | None | https://www.instagram.com/p/DUajw4YkorV/ | None |
827
+ | min_id | query | string | No | 分页游标,首次请求不传,从上一次响应的 next_min_id 获取/Pagination cursor, omit for first request, get from previous response next_min_id | None | None | None |
828
+ | sort_order | query | string | No | 排序方式: popular(热门), newest(最新)/Sort order: popular, newest | popular | None | None |
829
+
830
+ #### Request Body
831
+
832
+ None
833
+
834
+ #### Success Response
835
+
836
+ ##### `200 application/json`
837
+
838
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
839
+
840
+ | Field | Type | Required | Description | Default | Example | Enum |
841
+ | --- | --- | --- | --- | --- | --- | --- |
842
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
843
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
844
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
845
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
846
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
847
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
848
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
849
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
850
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
851
+ | 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 |
852
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
853
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
854
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
855
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
856
+ | data | null | No | The response data \| 响应数据 | None | None | None |
857
+
858
+ <a id="get-api-u1-v1-instagram-v3-get-post-info"></a>
859
+ ### `GET /api/u1/v1/instagram/v3/get_post_info`
860
+
861
+ - Summary: 获取帖子详情/Get post info (media_id or URL)
862
+ - Capabilities: content details
863
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
864
+ - operationId: `get_post_info_api_v1_instagram_v3_get_post_info_get`
865
+
866
+ #### Notes
867
+
868
+ > # [中文]
869
+ > ### 用途:
870
+ > - 获取帖子详情
871
+ > - 支持通过 media_id 或帖子 URL 获取
872
+ > - 返回帖子的完整信息,包括图片/视频、点赞数、评论数、发布者信息等
873
+ > ### 参数(二选一):
874
+ > - media_id: 帖子的媒体ID(数字ID)
875
+ > - url: 帖子的完整URL(如 `https://www.instagram.com/p/DUajw4YkorV/`)
876
+ > ### 返回:
877
+ > - `data.items`: 帖子信息列表(通常只有一个元素)
878
+ > - `id`: 帖子ID
879
+ > - `code`: 帖子短代码
880
+ > - `media_type`: 媒体类型(1=图片, 2=视频, 8=合集)
881
+ > - `like_count`: 点赞数
882
+ > - `comment_count`: 评论数
883
+ > - `caption.text`: 帖子文本
884
+ > - `user`: 发布者信息
885
+ > - `image_versions2`: 图片版本列表
886
+ > - `video_versions`: 视频版本列表(视频时存在)
887
+ > - `carousel_media`: 合集媒体列表(合集时存在)
888
+ > - `taken_at`: 发布时间戳
889
+ > ### 价格:
890
+ > - 0.002 USD/请求
891
+ >
892
+ > # [English]
893
+ > ### Purpose:
894
+ > - Get post details
895
+ > - Support fetching by media_id or post URL
896
+ > - Returns complete post info including images/videos, likes, comments, author info, etc.
897
+ > ### Parameters (one of):
898
+ > - media_id: Post media ID (numeric ID)
899
+ > - url: Full post URL (e.g., `https://www.instagram.com/p/DUajw4YkorV/`)
900
+ > ### Return:
901
+ > - `data.items`: Post info list (usually only one element)
902
+ > - `id`: Post ID
903
+ > - `code`: Post shortcode
904
+ > - `media_type`: Media type (1=image, 2=video, 8=carousel)
905
+ > - `like_count`: Likes count
906
+ > - `comment_count`: Comments count
907
+ > - `caption.text`: Post caption text
908
+ > - `user`: Publisher info
909
+ > - `image_versions2`: Image version list
910
+ > - `video_versions`: Video version list (exists for videos)
911
+ > - `carousel_media`: Carousel media list (exists for carousels)
912
+ > - `taken_at`: Published timestamp
913
+ > ### Price:
914
+ > - 0.002 USD/request
915
+ >
916
+ > ### 示例/Example
917
+ > ```
918
+ > media_id = "3800418264661789225"
919
+ > # 或通过URL / Or by URL
920
+ > # url = "https://www.instagram.com/p/DUajw4YkorV/"
921
+ > ```
922
+
923
+ #### Parameters
924
+
925
+ | Field | In | Type | Required | Description | Default | Example | Enum |
926
+ | --- | --- | --- | --- | --- | --- | --- | --- |
927
+ | media_id | query | string | No | 帖子媒体ID/Post media ID | None | 3800418264661789225 | None |
928
+ | url | query | string | No | 帖子URL/Post URL | None | https://www.instagram.com/p/DUajw4YkorV/ | None |
929
+
930
+ #### Request Body
931
+
932
+ None
933
+
934
+ #### Success Response
935
+
936
+ ##### `200 application/json`
937
+
938
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
939
+
940
+ | Field | Type | Required | Description | Default | Example | Enum |
941
+ | --- | --- | --- | --- | --- | --- | --- |
942
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
943
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
944
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
945
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
946
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
947
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
948
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
949
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
950
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
951
+ | 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 |
952
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
953
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
954
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
955
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
956
+ | data | null | No | The response data \| 响应数据 | None | None | None |
957
+
958
+ <a id="get-api-u1-v1-instagram-v3-get-post-info-by-code"></a>
959
+ ### `GET /api/u1/v1/instagram/v3/get_post_info_by_code`
960
+
961
+ - Summary: 获取帖子详情(code)/Get post info by shortcode
962
+ - Capabilities: content details
963
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
964
+ - operationId: `get_post_info_by_code_api_v1_instagram_v3_get_post_info_by_code_get`
965
+
966
+ #### Notes
967
+
968
+ > # [中文]
969
+ > ### 用途:
970
+ > - 通过帖子的短代码(code/shortcode)或URL获取帖子详情
971
+ > - 短代码即帖子URL中的标识符,如 `https://www.instagram.com/p/DUajw4YkorV/` 中的 `DUajw4YkorV`
972
+ > - 返回帖子的完整信息
973
+ > ### 参数(二选一):
974
+ > - code: 帖子短代码(如 DUajw4YkorV)
975
+ > - url: 帖子URL(自动提取短代码)
976
+ > ### 返回:
977
+ > - `data.items`: 帖子信息列表
978
+ > - `id`: 帖子ID
979
+ > - `code`: 帖子短代码
980
+ > - `media_type`: 媒体类型(1=图片, 2=视频, 8=合集)
981
+ > - `like_count`: 点赞数
982
+ > - `comment_count`: 评论数
983
+ > - `caption.text`: 帖子文本
984
+ > - `user`: 发布者信息
985
+ > - `image_versions2`: 图片版本列表
986
+ > - `video_versions`: 视频版本列表(视频时存在)
987
+ > - `carousel_media`: 合集媒体列表(合集时存在)
988
+ > - `taken_at`: 发布时间戳
989
+ > ### 价格:
990
+ > - 0.002 USD/请求
991
+ >
992
+ > # [English]
993
+ > ### Purpose:
994
+ > - Get post details by shortcode
995
+ > - Shortcode is the identifier in the post URL, e.g., `DUajw4YkorV` from `https://www.instagram.com/p/DUajw4YkorV/`
996
+ > - Returns complete post info
997
+ > ### Parameters:
998
+ > - code: Post shortcode (e.g., DUajw4YkorV)
999
+ > ### Return:
1000
+ > - `data.items`: Post info list
1001
+ > - `id`: Post ID
1002
+ > - `code`: Post shortcode
1003
+ > - `media_type`: Media type (1=image, 2=video, 8=carousel)
1004
+ > - `like_count`: Likes count
1005
+ > - `comment_count`: Comments count
1006
+ > - `caption.text`: Post caption text
1007
+ > - `user`: Publisher info
1008
+ > - `image_versions2`: Image version list
1009
+ > - `video_versions`: Video version list (exists for videos)
1010
+ > - `carousel_media`: Carousel media list (exists for carousels)
1011
+ > - `taken_at`: Published timestamp
1012
+ > ### Price:
1013
+ > - 0.002 USD/request
1014
+ >
1015
+ > ### 示例/Example
1016
+ > code = "DUajw4YkorV"
1017
+
1018
+ #### Parameters
1019
+
1020
+ | Field | In | Type | Required | Description | Default | Example | Enum |
1021
+ | --- | --- | --- | --- | --- | --- | --- | --- |
1022
+ | code | query | string | No | 帖子短代码/Post shortcode | None | DUajw4YkorV | None |
1023
+ | url | query | string | No | 帖子URL(自动提取短代码)/Post URL (auto extract shortcode) | None | https://www.instagram.com/p/DUajw4YkorV/ | None |
1024
+
1025
+ #### Request Body
1026
+
1027
+ None
1028
+
1029
+ #### Success Response
1030
+
1031
+ ##### `200 application/json`
1032
+
1033
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1034
+
1035
+ | Field | Type | Required | Description | Default | Example | Enum |
1036
+ | --- | --- | --- | --- | --- | --- | --- |
1037
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1038
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1039
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1040
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1041
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1042
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1043
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1044
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1045
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1046
+ | 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 |
1047
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1048
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1049
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1050
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1051
+ | data | null | No | The response data \| 响应数据 | None | None | None |
1052
+
1053
+ <a id="get-api-u1-v1-instagram-v3-get-post-oembed"></a>
1054
+ ### `GET /api/u1/v1/instagram/v3/get_post_oembed`
1055
+
1056
+ - Summary: 获取帖子oEmbed内嵌信息/Get post oEmbed info
1057
+ - Capabilities: content details
1058
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1059
+ - operationId: `get_post_oembed_api_v1_instagram_v3_get_post_oembed_get`
1060
+
1061
+ #### Notes
1062
+
1063
+ > # [中文]
1064
+ > ### 用途:
1065
+ > - 获取Instagram帖子的oEmbed内嵌信息
1066
+ > - 返回可直接嵌入网页的HTML代码和帖子元信息
1067
+ > - 适用于需要在第三方网站嵌入Instagram帖子的场景
1068
+ > ### 参数:
1069
+ > - url: Instagram帖子的完整URL(如 `https://www.instagram.com/p/xxx/` 或 `https://www.instagram.com/reel/xxx/`)
1070
+ > - hidecaption: 是否隐藏帖子文本(默认false)
1071
+ > - maxwidth: 嵌入的最大宽度(像素,默认540)
1072
+ > ### 返回:
1073
+ > - `data.version`: oEmbed版本
1074
+ > - `data.title`: 帖子标题
1075
+ > - `data.author_name`: 作者名称
1076
+ > - `data.author_url`: 作者主页URL
1077
+ > - `data.author_id`: 作者ID
1078
+ > - `data.media_id`: 媒体ID
1079
+ > - `data.provider_name`: 提供者名称(Instagram)
1080
+ > - `data.provider_url`: 提供者URL
1081
+ > - `data.type`: 类型(rich)
1082
+ > - `data.width`: 宽度
1083
+ > - `data.html`: HTML嵌入代码
1084
+ > - `data.thumbnail_url`: 缩略图URL
1085
+ > - `data.thumbnail_width`: 缩略图宽度
1086
+ > - `data.thumbnail_height`: 缩略图高度
1087
+ > ### 价格:
1088
+ > - 0.002 USD/请求
1089
+ >
1090
+ > # [English]
1091
+ > ### Purpose:
1092
+ > - Get Instagram post oEmbed embed info
1093
+ > - Returns HTML code for embedding and post metadata
1094
+ > - Suitable for embedding Instagram posts on third-party websites
1095
+ > ### Parameters:
1096
+ > - url: Full Instagram post URL (e.g., `https://www.instagram.com/p/xxx/` or `https://www.instagram.com/reel/xxx/`)
1097
+ > - hidecaption: Whether to hide caption (default false)
1098
+ > - maxwidth: Max embed width in pixels (default 540)
1099
+ > ### Return:
1100
+ > - `data.version`: oEmbed version
1101
+ > - `data.title`: Post title
1102
+ > - `data.author_name`: Author name
1103
+ > - `data.author_url`: Author profile URL
1104
+ > - `data.author_id`: Author ID
1105
+ > - `data.media_id`: Media ID
1106
+ > - `data.provider_name`: Provider name (Instagram)
1107
+ > - `data.provider_url`: Provider URL
1108
+ > - `data.type`: Type (rich)
1109
+ > - `data.width`: Width
1110
+ > - `data.html`: HTML embed code
1111
+ > - `data.thumbnail_url`: Thumbnail URL
1112
+ > - `data.thumbnail_width`: Thumbnail width
1113
+ > - `data.thumbnail_height`: Thumbnail height
1114
+ > ### Price:
1115
+ > - 0.002 USD/request
1116
+ >
1117
+ > ### 示例/Example
1118
+ > url = "https://www.instagram.com/reel/DUlObENDmJD"
1119
+
1120
+ #### Parameters
1121
+
1122
+ | Field | In | Type | Required | Description | Default | Example | Enum |
1123
+ | --- | --- | --- | --- | --- | --- | --- | --- |
1124
+ | url | query | string | Yes | Instagram帖子的完整URL/Full URL of Instagram post | None | https://www.instagram.com/reel/DUlObENDmJD | None |
1125
+ | hidecaption | query | boolean | No | 是否隐藏帖子文本/Whether to hide caption | false | None | None |
1126
+ | maxwidth | query | integer | No | 最大宽度(像素)/Max width in pixels | 540 | None | None |
1127
+
1128
+ #### Request Body
1129
+
1130
+ None
1131
+
1132
+ #### Success Response
1133
+
1134
+ ##### `200 application/json`
1135
+
1136
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1137
+
1138
+ | Field | Type | Required | Description | Default | Example | Enum |
1139
+ | --- | --- | --- | --- | --- | --- | --- |
1140
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1141
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1142
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1143
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1144
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1145
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1146
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1147
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1148
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1149
+ | 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 |
1150
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1151
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1152
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1153
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1154
+ | data | null | No | The response data \| 响应数据 | None | None | None |
1155
+
1156
+ <a id="get-api-u1-v1-instagram-v3-get-recommended-reels"></a>
1157
+ ### `GET /api/u1/v1/instagram/v3/get_recommended_reels`
1158
+
1159
+ - Summary: 获取Reels推荐列表/Get recommended Reels feed
1160
+ - Capabilities: general
1161
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1162
+ - operationId: `get_recommended_reels_api_v1_instagram_v3_get_recommended_reels_get`
1163
+
1164
+ #### Notes
1165
+
1166
+ > # [中文]
1167
+ > ### 用途:
1168
+ > - 获取Instagram Reels推荐列表
1169
+ > - 支持分页获取更多Reels
1170
+ > ### 参数:
1171
+ > - first: 每次获取的Reels数量(默认12)
1172
+ > - after: 分页游标,首次请求不传,从上一次响应的 `data.page_info.end_cursor` 获取
1173
+ > ### 返回:
1174
+ > - `data.edges`: Reels列表
1175
+ > - `node.media`: Reels媒体信息
1176
+ > - `code`: 帖子短代码
1177
+ > - `pk`: 帖子ID
1178
+ > - `like_count`: 点赞数
1179
+ > - `comment_count`: 评论数
1180
+ > - `play_count`: 播放数
1181
+ > - `caption.text`: 描述文本
1182
+ > - `user`: 发布者信息
1183
+ > - `video_versions`: 视频版本列表
1184
+ > - `image_versions2`: 封面图版本列表
1185
+ > - `data.page_info`: 分页信息
1186
+ > - `has_next_page`: 是否有下一页
1187
+ > - `end_cursor`: 下一页游标(传给下次请求的after参数)
1188
+ > ### 分页使用方法:
1189
+ > 1. 首次请求:只传 `first` 参数
1190
+ > 2. 获取响应中的 `data.page_info.end_cursor`
1191
+ > 3. 下次请求:传入 `first` 和 `after` (使用上次的end_cursor)
1192
+ > 4. 重复步骤 2-3 直到 `data.page_info.has_next_page` 为 false
1193
+ > ### 价格:
1194
+ > - 0.002 USD/请求
1195
+ >
1196
+ > # [English]
1197
+ > ### Purpose:
1198
+ > - Get Instagram Reels recommendation feed
1199
+ > - Support pagination to fetch more Reels
1200
+ > ### Parameters:
1201
+ > - first: Number of Reels to fetch per request (default 12)
1202
+ > - after: Pagination cursor, omit for first request, get from previous response `data.page_info.end_cursor`
1203
+ > ### Return:
1204
+ > - `data.edges`: Reels list
1205
+ > - `node.media`: Reels media info
1206
+ > - `code`: Post shortcode
1207
+ > - `pk`: Post ID
1208
+ > - `like_count`: Likes count
1209
+ > - `comment_count`: Comments count
1210
+ > - `play_count`: Play count
1211
+ > - `caption.text`: Description text
1212
+ > - `user`: Publisher info
1213
+ > - `video_versions`: Video version list
1214
+ > - `image_versions2`: Cover image version list
1215
+ > - `data.page_info`: Pagination info
1216
+ > - `has_next_page`: Whether has next page
1217
+ > - `end_cursor`: Next page cursor (use as after parameter in next request)
1218
+ > ### Pagination usage:
1219
+ > 1. First request: Only pass `first` parameter
1220
+ > 2. Get `data.page_info.end_cursor` from response
1221
+ > 3. Next request: Pass `first` and `after` (use end_cursor from previous)
1222
+ > 4. Repeat steps 2-3 until `data.page_info.has_next_page` is false
1223
+ > ### Price:
1224
+ > - 0.002 USD/request
1225
+ >
1226
+ > ### 示例/Example
1227
+ > first = 12
1228
+
1229
+ #### Parameters
1230
+
1231
+ | Field | In | Type | Required | Description | Default | Example | Enum |
1232
+ | --- | --- | --- | --- | --- | --- | --- | --- |
1233
+ | first | query | integer | No | 获取数量/Number of reels to fetch | 12 | 12 | None |
1234
+ | after | query | string | No | 分页游标,首次请求不传,从上一次响应的 page_info.end_cursor 获取/Pagination cursor, omit for first request, get from previous response page_info.end_cursor | None | None | None |
1235
+
1236
+ #### Request Body
1237
+
1238
+ None
1239
+
1240
+ #### Success Response
1241
+
1242
+ ##### `200 application/json`
1243
+
1244
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1245
+
1246
+ | Field | Type | Required | Description | Default | Example | Enum |
1247
+ | --- | --- | --- | --- | --- | --- | --- |
1248
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1249
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1250
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1251
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1252
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1253
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1254
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1255
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1256
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1257
+ | 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 |
1258
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1259
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1260
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1261
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1262
+ | data | null | No | The response data \| 响应数据 | None | None | None |
1263
+
1264
+ <a id="get-api-u1-v1-instagram-v3-get-user-about"></a>
1265
+ ### `GET /api/u1/v1/instagram/v3/get_user_about`
1266
+
1267
+ - Summary: 获取用户账户简介/Get user about info
1268
+ - Capabilities: profiles / accounts
1269
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1270
+ - operationId: `get_user_about_api_v1_instagram_v3_get_user_about_get`
1271
+
1272
+ #### Notes
1273
+
1274
+ > # [中文]
1275
+ > ### 用途:
1276
+ > - 获取Instagram用户的账户简介信息(About This Account)
1277
+ > - 包含账户创建日期、所在地区、曾用名等信息
1278
+ > ### 参数(二选一):
1279
+ > - user_id: Instagram用户ID(数字)
1280
+ > - username: Instagram用户名
1281
+ > ### 返回:
1282
+ > - 账户创建日期
1283
+ > - 账户所在地区/国家
1284
+ > - 曾用名历史
1285
+ > - 其他账户相关信息
1286
+ > ### 价格:
1287
+ > - 0.002 USD/请求
1288
+ >
1289
+ > # [English]
1290
+ > ### Purpose:
1291
+ > - Get Instagram user's About This Account information
1292
+ > - Including account creation date, location, former usernames, etc.
1293
+ > ### Parameters (one of):
1294
+ > - user_id: Instagram user ID (numeric)
1295
+ > - username: Instagram username
1296
+ > ### Return:
1297
+ > - Account creation date
1298
+ > - Account location/country
1299
+ > - Former username history
1300
+ > - Other account related info
1301
+ > ### Price:
1302
+ > - 0.002 USD/request
1303
+ >
1304
+ > ### 示例/Example
1305
+ > user_id = "791258468"
1306
+
1307
+ #### Parameters
1308
+
1309
+ | Field | In | Type | Required | Description | Default | Example | Enum |
1310
+ | --- | --- | --- | --- | --- | --- | --- | --- |
1311
+ | user_id | query | string | No | 用户ID/User ID | None | 791258468 | None |
1312
+ | username | query | string | No | 用户名/Username | None | liensue.talks | None |
1313
+
1314
+ #### Request Body
1315
+
1316
+ None
1317
+
1318
+ #### Success Response
1319
+
1320
+ ##### `200 application/json`
1321
+
1322
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1323
+
1324
+ | Field | Type | Required | Description | Default | Example | Enum |
1325
+ | --- | --- | --- | --- | --- | --- | --- |
1326
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1327
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1328
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1329
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1330
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1331
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1332
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1333
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1334
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1335
+ | 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 |
1336
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1337
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1338
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1339
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1340
+ | data | null | No | The response data \| 响应数据 | None | None | None |
1341
+
1342
+ <a id="get-api-u1-v1-instagram-v3-get-user-brief"></a>
1343
+ ### `GET /api/u1/v1/instagram/v3/get_user_brief`
1344
+
1345
+ - Summary: 获取用户短详情/Get user brief info
1346
+ - Capabilities: profiles / accounts
1347
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1348
+ - operationId: `get_user_brief_api_v1_instagram_v3_get_user_brief_get`
1349
+
1350
+ #### Notes
1351
+
1352
+ > # [中文]
1353
+ > ### 用途:
1354
+ > - 获取Instagram用户的短详情/悬浮卡片信息
1355
+ > - 返回用户核心信息,响应速度比 get_user_profile 更快
1356
+ > - 适用于批量获取用户摘要信息的场景
1357
+ > ### 参数:
1358
+ > - user_id: Instagram用户ID(数字)
1359
+ > - username: Instagram用户名
1360
+ > ### 返回:
1361
+ > - `data.id`: 用户ID
1362
+ > - `data.username`: 用户名
1363
+ > - `data.full_name`: 全名
1364
+ > - `data.biography`: 个人简介
1365
+ > - `data.profile_pic_url`: 头像URL
1366
+ > - `data.is_verified`: 是否认证
1367
+ > - `data.is_private`: 是否私密账号
1368
+ > - `data.edge_followed_by.count`: 粉丝数
1369
+ > - `data.edge_follow.count`: 关注数
1370
+ > - `data.edge_owner_to_timeline_media`: 最近帖子预览
1371
+ > ### 价格:
1372
+ > - 0.002 USD/请求
1373
+ >
1374
+ > # [English]
1375
+ > ### Purpose:
1376
+ > - Get Instagram user brief/hover card info
1377
+ > - Returns core user info, faster response than get_user_profile
1378
+ > - Suitable for batch fetching user summary info
1379
+ > ### Parameters:
1380
+ > - user_id: Instagram user ID (numeric)
1381
+ > - username: Instagram username
1382
+ > ### Return:
1383
+ > - `data.id`: User ID
1384
+ > - `data.username`: Username
1385
+ > - `data.full_name`: Full name
1386
+ > - `data.biography`: Biography
1387
+ > - `data.profile_pic_url`: Profile picture URL
1388
+ > - `data.is_verified`: Whether verified
1389
+ > - `data.is_private`: Whether private account
1390
+ > - `data.edge_followed_by.count`: Followers count
1391
+ > - `data.edge_follow.count`: Following count
1392
+ > - `data.edge_owner_to_timeline_media`: Recent posts preview
1393
+ > ### Price:
1394
+ > - 0.002 USD/request
1395
+ >
1396
+ > ### 示例/Example
1397
+ > user_id = "77919494141"
1398
+ > username = "emo.__0202"
1399
+
1400
+ #### Parameters
1401
+
1402
+ | Field | In | Type | Required | Description | Default | Example | Enum |
1403
+ | --- | --- | --- | --- | --- | --- | --- | --- |
1404
+ | user_id | query | string | Yes | 用户ID/User ID | None | 77919494141 | None |
1405
+ | username | query | string | Yes | 用户名/Username | None | emo.__0202 | None |
1406
+
1407
+ #### Request Body
1408
+
1409
+ None
1410
+
1411
+ #### Success Response
1412
+
1413
+ ##### `200 application/json`
1414
+
1415
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1416
+
1417
+ | Field | Type | Required | Description | Default | Example | Enum |
1418
+ | --- | --- | --- | --- | --- | --- | --- |
1419
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1420
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1421
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1422
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1423
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1424
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1425
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1426
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1427
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1428
+ | 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 |
1429
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1430
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1431
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1432
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1433
+ | data | null | No | The response data \| 响应数据 | None | None | None |
1434
+
1435
+ <a id="get-api-u1-v1-instagram-v3-get-user-followers"></a>
1436
+ ### `GET /api/u1/v1/instagram/v3/get_user_followers`
1437
+
1438
+ - Summary: 获取用户粉丝列表/Get user followers list
1439
+ - Capabilities: profiles / accounts
1440
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1441
+ - operationId: `get_user_followers_api_v1_instagram_v3_get_user_followers_get`
1442
+
1443
+ #### Notes
1444
+
1445
+ > # [中文]
1446
+ > ### 用途:
1447
+ > - 获取Instagram用户的粉丝列表
1448
+ > - 返回关注该用户的所有账号信息
1449
+ > - 支持分页获取
1450
+ > ### 参数(二选一):
1451
+ > - user_id: Instagram用户ID(数字)
1452
+ > - username: Instagram用户名
1453
+ > - count: 每次获取数量(默认12)
1454
+ > - max_id: 分页游标,首次请求不传,从上一次响应的 `data.next_max_id` 获取
1455
+ > ### 返回:
1456
+ > - `data.users`: 粉丝用户列表
1457
+ > - `pk`: 用户ID
1458
+ > - `username`: 用户名
1459
+ > - `full_name`: 全名
1460
+ > - `is_private`: 是否私密账号
1461
+ > - `is_verified`: 是否认证
1462
+ > - `profile_pic_url`: 头像URL
1463
+ > - `data.next_max_id`: 下一页分页游标(传给下次请求的max_id参数)
1464
+ > - `data.big_list`: 是否有更多数据
1465
+ > - `data.page_size`: 每页数量
1466
+ > - `data.status`: 状态
1467
+ > ### 分页使用方法:
1468
+ > 1. 首次请求:只传 `user_id` 和 `count` 参数
1469
+ > 2. 获取响应中的 `data.next_max_id`
1470
+ > 3. 下次请求:传入 `user_id`、`count` 和 `max_id` (使用上次的next_max_id)
1471
+ > 4. 重复步骤 2-3 直到响应中没有 `next_max_id` 字段
1472
+ > ### 价格:
1473
+ > - 0.002 USD/请求
1474
+ >
1475
+ > # [English]
1476
+ > ### Purpose:
1477
+ > - Get Instagram user's followers list
1478
+ > - Returns all accounts that follow this user
1479
+ > - Support pagination
1480
+ > ### Parameters (one of):
1481
+ > - user_id: Instagram user ID (numeric)
1482
+ > - username: Instagram username
1483
+ > ### Other parameters:
1484
+ > - count: Number of users to fetch per request (default 12)
1485
+ > - max_id: Pagination cursor, omit for first request, get from previous response `data.next_max_id`
1486
+ > ### Return:
1487
+ > - `data.users`: Followers user list
1488
+ > - `pk`: User ID
1489
+ > - `username`: Username
1490
+ > - `full_name`: Full name
1491
+ > - `is_private`: Whether private account
1492
+ > - `is_verified`: Whether verified
1493
+ > - `profile_pic_url`: Profile picture URL
1494
+ > - `data.next_max_id`: Next page cursor (use as max_id in next request)
1495
+ > - `data.big_list`: Whether has more data
1496
+ > - `data.page_size`: Page size
1497
+ > - `data.status`: Status
1498
+ > ### Pagination usage:
1499
+ > 1. First request: Only pass `user_id` and `count` parameters
1500
+ > 2. Get `data.next_max_id` from response
1501
+ > 3. Next request: Pass `user_id`, `count`, and `max_id` (use next_max_id from previous)
1502
+ > 4. Repeat steps 2-3 until response has no `next_max_id` field
1503
+ > ### Price:
1504
+ > - 0.002 USD/request
1505
+ >
1506
+ > ### 示例/Example
1507
+ > user_id = "58208242181"
1508
+ > count = 12
1509
+
1510
+ #### Parameters
1511
+
1512
+ | Field | In | Type | Required | Description | Default | Example | Enum |
1513
+ | --- | --- | --- | --- | --- | --- | --- | --- |
1514
+ | user_id | query | string | No | 用户ID/User ID | None | 58208242181 | None |
1515
+ | username | query | string | No | 用户名/Username | None | liensue.talks | None |
1516
+ | count | query | integer | No | 每次获取数量/Number of users to fetch per request | 12 | 12 | None |
1517
+ | max_id | query | string | No | 分页游标,首次请求不传,从上一次响应的 next_max_id 获取/Pagination cursor, omit for first request, get from previous response next_max_id | None | None | None |
1518
+
1519
+ #### Request Body
1520
+
1521
+ None
1522
+
1523
+ #### Success Response
1524
+
1525
+ ##### `200 application/json`
1526
+
1527
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1528
+
1529
+ | Field | Type | Required | Description | Default | Example | Enum |
1530
+ | --- | --- | --- | --- | --- | --- | --- |
1531
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1532
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1533
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1534
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1535
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1536
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1537
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1538
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1539
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1540
+ | 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 |
1541
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1542
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1543
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1544
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1545
+ | data | null | No | The response data \| 响应数据 | None | None | None |
1546
+
1547
+ <a id="get-api-u1-v1-instagram-v3-get-user-following"></a>
1548
+ ### `GET /api/u1/v1/instagram/v3/get_user_following`
1549
+
1550
+ - Summary: 获取用户关注列表/Get user following list
1551
+ - Capabilities: profiles / accounts
1552
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1553
+ - operationId: `get_user_following_api_v1_instagram_v3_get_user_following_get`
1554
+
1555
+ #### Notes
1556
+
1557
+ > # [中文]
1558
+ > ### 用途:
1559
+ > - 获取Instagram用户的关注列表
1560
+ > - 返回用户关注的所有账号信息
1561
+ > - 支持分页获取
1562
+ > ### 参数(二选一):
1563
+ > - user_id: Instagram用户ID(数字)
1564
+ > - username: Instagram用户名
1565
+ > - count: 每次获取数量(默认12)
1566
+ > - max_id: 分页游标,首次请求不传,从上一次响应的 `data.next_max_id` 获取
1567
+ > ### 返回:
1568
+ > - `data.users`: 关注用户列表
1569
+ > - `pk`: 用户ID
1570
+ > - `username`: 用户名
1571
+ > - `full_name`: 全名
1572
+ > - `is_private`: 是否私密账号
1573
+ > - `is_verified`: 是否认证
1574
+ > - `profile_pic_url`: 头像URL
1575
+ > - `data.next_max_id`: 下一页分页游标(传给下次请求的max_id参数)
1576
+ > - `data.big_list`: 是否有更多数据
1577
+ > - `data.page_size`: 每页数量
1578
+ > - `data.status`: 状态
1579
+ > ### 分页使用方法:
1580
+ > 1. 首次请求:只传 `user_id` 和 `count` 参数
1581
+ > 2. 获取响应中的 `data.next_max_id`
1582
+ > 3. 下次请求:传入 `user_id`、`count` 和 `max_id` (使用上次的next_max_id)
1583
+ > 4. 重复步骤 2-3 直到响应中没有 `next_max_id` 字段
1584
+ > ### 价格:
1585
+ > - 0.002 USD/请求
1586
+ >
1587
+ > # [English]
1588
+ > ### Purpose:
1589
+ > - Get Instagram user's following list
1590
+ > - Returns all accounts the user follows
1591
+ > - Support pagination
1592
+ > ### Parameters (one of):
1593
+ > - user_id: Instagram user ID (numeric)
1594
+ > - username: Instagram username
1595
+ > ### Other parameters:
1596
+ > - count: Number of users to fetch per request (default 12)
1597
+ > - max_id: Pagination cursor, omit for first request, get from previous response `data.next_max_id`
1598
+ > ### Return:
1599
+ > - `data.users`: Following user list
1600
+ > - `pk`: User ID
1601
+ > - `username`: Username
1602
+ > - `full_name`: Full name
1603
+ > - `is_private`: Whether private account
1604
+ > - `is_verified`: Whether verified
1605
+ > - `profile_pic_url`: Profile picture URL
1606
+ > - `data.next_max_id`: Next page cursor (use as max_id in next request)
1607
+ > - `data.big_list`: Whether has more data
1608
+ > - `data.page_size`: Page size
1609
+ > - `data.status`: Status
1610
+ > ### Pagination usage:
1611
+ > 1. First request: Only pass `user_id` and `count` parameters
1612
+ > 2. Get `data.next_max_id` from response
1613
+ > 3. Next request: Pass `user_id`, `count`, and `max_id` (use next_max_id from previous)
1614
+ > 4. Repeat steps 2-3 until response has no `next_max_id` field
1615
+ > ### Price:
1616
+ > - 0.002 USD/request
1617
+ >
1618
+ > ### 示例/Example
1619
+ > user_id = "58208242181"
1620
+ > count = 12
1621
+
1622
+ #### Parameters
1623
+
1624
+ | Field | In | Type | Required | Description | Default | Example | Enum |
1625
+ | --- | --- | --- | --- | --- | --- | --- | --- |
1626
+ | user_id | query | string | No | 用户ID/User ID | None | 58208242181 | None |
1627
+ | username | query | string | No | 用户名/Username | None | liensue.talks | None |
1628
+ | count | query | integer | No | 每次获取数量/Number of users to fetch per request | 12 | 12 | None |
1629
+ | max_id | query | string | No | 分页游标,首次请求不传,从上一次响应的 next_max_id 获取/Pagination cursor, omit for first request, get from previous response next_max_id | None | None | None |
1630
+
1631
+ #### Request Body
1632
+
1633
+ None
1634
+
1635
+ #### Success Response
1636
+
1637
+ ##### `200 application/json`
1638
+
1639
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1640
+
1641
+ | Field | Type | Required | Description | Default | Example | Enum |
1642
+ | --- | --- | --- | --- | --- | --- | --- |
1643
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1644
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1645
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1646
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1647
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1648
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1649
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1650
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1651
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1652
+ | 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 |
1653
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1654
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1655
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1656
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1657
+ | data | null | No | The response data \| 响应数据 | None | None | None |
1658
+
1659
+ <a id="get-api-u1-v1-instagram-v3-get-user-highlights"></a>
1660
+ ### `GET /api/u1/v1/instagram/v3/get_user_highlights`
1661
+
1662
+ - Summary: 获取用户精选Highlights列表/Get user highlights
1663
+ - Capabilities: profiles / accounts
1664
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1665
+ - operationId: `get_user_highlights_api_v1_instagram_v3_get_user_highlights_get`
1666
+
1667
+ #### Notes
1668
+
1669
+ > # [中文]
1670
+ > ### 用途:
1671
+ > - 获取Instagram用户的精选Highlights列表
1672
+ > - 返回用户创建的所有精选集合
1673
+ > - 支持分页获取
1674
+ > ### 参数(二选一):
1675
+ > - user_id: Instagram用户ID(数字)
1676
+ > - username: Instagram用户名
1677
+ > - first: 每次获取的精选数量(默认10)
1678
+ > - after: 分页游标,首次请求不传,从上一次响应的 `data.page_info.end_cursor` 获取
1679
+ > ### 返回:
1680
+ > - `data.edges`: 精选列表
1681
+ > - `node.id`: 精选ID(格式: highlight:xxx)
1682
+ > - `node.title`: 精选标题
1683
+ > - `node.cover_media`: 封面媒体信息
1684
+ > - `node.cover_media_cropped_thumbnail`: 裁剪后的封面缩略图
1685
+ > - `node.media_count`: 精选中的故事数量
1686
+ > - `data.page_info`: 分页信息
1687
+ > - `has_next_page`: 是否有下一页
1688
+ > - `end_cursor`: 下一页游标(传给下次请求的after参数)
1689
+ > ### 分页使用方法:
1690
+ > 1. 首次请求:只传 `user_id` 和 `first` 参数
1691
+ > 2. 获取响应中的 `data.page_info.end_cursor`
1692
+ > 3. 下次请求:传入 `user_id`、`first` 和 `after` (使用上次的end_cursor)
1693
+ > 4. 重复步骤 2-3 直到 `data.page_info.has_next_page` 为 false
1694
+ > ### 价格:
1695
+ > - 0.002 USD/请求
1696
+ >
1697
+ > # [English]
1698
+ > ### Purpose:
1699
+ > - Get Instagram user's Highlights list
1700
+ > - Returns all highlight collections created by the user
1701
+ > - Support pagination
1702
+ > ### Parameters (one of):
1703
+ > - user_id: Instagram user ID (numeric)
1704
+ > - username: Instagram username
1705
+ > ### Other parameters:
1706
+ > - first: Number of highlights to fetch per request (default 10)
1707
+ > - after: Pagination cursor, omit for first request, get from previous response `data.page_info.end_cursor`
1708
+ > ### Return:
1709
+ > - `data.edges`: Highlights list
1710
+ > - `node.id`: Highlight ID (format: highlight:xxx)
1711
+ > - `node.title`: Highlight title
1712
+ > - `node.cover_media`: Cover media info
1713
+ > - `node.cover_media_cropped_thumbnail`: Cropped cover thumbnail
1714
+ > - `node.media_count`: Number of stories in highlight
1715
+ > - `data.page_info`: Pagination info
1716
+ > - `has_next_page`: Whether has next page
1717
+ > - `end_cursor`: Next page cursor (use as after parameter in next request)
1718
+ > ### Pagination usage:
1719
+ > 1. First request: Only pass `user_id` and `first` parameters
1720
+ > 2. Get `data.page_info.end_cursor` from response
1721
+ > 3. Next request: Pass `user_id`, `first`, and `after` (use end_cursor from previous)
1722
+ > 4. Repeat steps 2-3 until `data.page_info.has_next_page` is false
1723
+ > ### Price:
1724
+ > - 0.002 USD/request
1725
+ >
1726
+ > ### 示例/Example
1727
+ > user_id = "58208242181"
1728
+ > first = 10
1729
+
1730
+ #### Parameters
1731
+
1732
+ | Field | In | Type | Required | Description | Default | Example | Enum |
1733
+ | --- | --- | --- | --- | --- | --- | --- | --- |
1734
+ | user_id | query | string | No | 用户ID/User ID | None | 58208242181 | None |
1735
+ | username | query | string | No | 用户名/Username | None | liensue.talks | None |
1736
+ | first | query | integer | No | 获取数量/Number of highlights to fetch | 10 | 10 | None |
1737
+ | after | query | string | No | 分页游标(从上次响应的page_info.end_cursor获取)/Pagination cursor (from previous response page_info.end_cursor) | None | None | None |
1738
+
1739
+ #### Request Body
1740
+
1741
+ None
1742
+
1743
+ #### Success Response
1744
+
1745
+ ##### `200 application/json`
1746
+
1747
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1748
+
1749
+ | Field | Type | Required | Description | Default | Example | Enum |
1750
+ | --- | --- | --- | --- | --- | --- | --- |
1751
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1752
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1753
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1754
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1755
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1756
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1757
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1758
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1759
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1760
+ | 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 |
1761
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1762
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1763
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1764
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1765
+ | data | null | No | The response data \| 响应数据 | None | None | None |
1766
+
1767
+ <a id="get-api-u1-v1-instagram-v3-get-user-posts"></a>
1768
+ ### `GET /api/u1/v1/instagram/v3/get_user_posts`
1769
+
1770
+ - Summary: 获取用户帖子列表/Get user posts
1771
+ - Capabilities: profiles / accounts / content details
1772
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1773
+ - operationId: `get_user_posts_api_v1_instagram_v3_get_user_posts_get`
1774
+
1775
+ #### Notes
1776
+
1777
+ > # [中文]
1778
+ > ### 用途:
1779
+ > - 获取Instagram用户的帖子列表
1780
+ > - 支持分页获取,可获取用户的所有帖子
1781
+ > ### 参数(二选一):
1782
+ > - username: Instagram用户名
1783
+ > - user_id: Instagram用户ID(数字,内部会自动转换为用户名)
1784
+ > - first: 每次获取的帖子数量(默认12)
1785
+ > - after: 分页游标,首次请求不传,从上一次响应的 `data.page_info.end_cursor` 获取
1786
+ > ### 返回:
1787
+ > - `data.edges`: 帖子列表
1788
+ > - `node.id`: 帖子ID
1789
+ > - `node.code`: 帖子短代码
1790
+ > - `node.display_url`: 展示图片URL
1791
+ > - `node.taken_at`: 发布时间戳
1792
+ > - `node.like_count`: 点赞数
1793
+ > - `node.comment_count`: 评论数
1794
+ > - `node.caption.text`: 帖子文本
1795
+ > - `data.page_info`: 分页信息
1796
+ > - `has_next_page`: 是否有下一页
1797
+ > - `end_cursor`: 下一页游标(传给下次请求的after参数)
1798
+ > ### 分页使用方法:
1799
+ > 1. 首次请求:只传 `username` 和 `first` 参数
1800
+ > 2. 获取响应中的 `data.page_info.end_cursor`
1801
+ > 3. 下次请求:传入 `username`、`first` 和 `after` (使用上次的end_cursor)
1802
+ > 4. 重复步骤 2-3 直到 `data.page_info.has_next_page` 为 false
1803
+ > ### 价格:
1804
+ > - 0.002 USD/请求
1805
+ >
1806
+ > # [English]
1807
+ > ### Purpose:
1808
+ > - Get Instagram user's post list
1809
+ > - Support pagination to fetch all user posts
1810
+ > ### Parameters (one of):
1811
+ > - username: Instagram username
1812
+ > - user_id: Instagram user ID (numeric, will be auto-converted to username)
1813
+ > ### Other parameters:
1814
+ > - first: Number of posts to fetch per request (default 12)
1815
+ > - after: Pagination cursor, omit for first request, get from previous response `data.page_info.end_cursor`
1816
+ > ### Return:
1817
+ > - `data.edges`: Post list
1818
+ > - `node.id`: Post ID
1819
+ > - `node.code`: Post shortcode
1820
+ > - `node.display_url`: Display image URL
1821
+ > - `node.taken_at`: Published timestamp
1822
+ > - `node.like_count`: Likes count
1823
+ > - `node.comment_count`: Comments count
1824
+ > - `node.caption.text`: Post caption text
1825
+ > - `data.page_info`: Pagination info
1826
+ > - `has_next_page`: Whether has next page
1827
+ > - `end_cursor`: Next page cursor (use as after parameter in next request)
1828
+ > ### Pagination usage:
1829
+ > 1. First request: Only pass `username` and `first` parameters
1830
+ > 2. Get `data.page_info.end_cursor` from response
1831
+ > 3. Next request: Pass `username`, `first`, and `after` (use end_cursor from previous)
1832
+ > 4. Repeat steps 2-3 until `data.page_info.has_next_page` is false
1833
+ > ### Price:
1834
+ > - 0.002 USD/request
1835
+ >
1836
+ > ### 示例/Example
1837
+ > ```
1838
+ > # 第一页 / First page
1839
+ > username = "liensue.talks"
1840
+ > first = 12
1841
+ >
1842
+ > # 第二页 / Second page
1843
+ > # username = "liensue.talks"
1844
+ > # first = 12
1845
+ > # after = "QVFCcmN1YlF..." # 从第一页响应中获取 / Get from first page response
1846
+ > ```
1847
+
1848
+ #### Parameters
1849
+
1850
+ | Field | In | Type | Required | Description | Default | Example | Enum |
1851
+ | --- | --- | --- | --- | --- | --- | --- | --- |
1852
+ | username | query | string | No | 用户名/Username | None | liensue.talks | None |
1853
+ | user_id | query | string | No | 用户ID/User ID | None | 58208242181 | None |
1854
+ | first | query | integer | No | 获取帖子数量/Number of posts to fetch | 12 | 12 | None |
1855
+ | after | query | string | No | 分页游标(从上次响应的page_info.end_cursor获取)/Pagination cursor (from previous response page_info.end_cursor) | None | None | None |
1856
+
1857
+ #### Request Body
1858
+
1859
+ None
1860
+
1861
+ #### Success Response
1862
+
1863
+ ##### `200 application/json`
1864
+
1865
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1866
+
1867
+ | Field | Type | Required | Description | Default | Example | Enum |
1868
+ | --- | --- | --- | --- | --- | --- | --- |
1869
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1870
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1871
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1872
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1873
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1874
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1875
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1876
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1877
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1878
+ | 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 |
1879
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1880
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1881
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1882
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1883
+ | data | null | No | The response data \| 响应数据 | None | None | None |
1884
+
1885
+ <a id="get-api-u1-v1-instagram-v3-get-user-profile"></a>
1886
+ ### `GET /api/u1/v1/instagram/v3/get_user_profile`
1887
+
1888
+ - Summary: 获取用户信息/Get user profile
1889
+ - Capabilities: profiles / accounts
1890
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1891
+ - operationId: `get_user_profile_api_v1_instagram_v3_get_user_profile_get`
1892
+
1893
+ #### Notes
1894
+
1895
+ > # [中文]
1896
+ > ### 用途:
1897
+ > - 获取Instagram用户的完整个人资料信息
1898
+ > - 包含用户基本信息、统计数据、最近帖子等
1899
+ > ### 参数(二选一):
1900
+ > - user_id: Instagram用户ID(数字)
1901
+ > - username: Instagram用户名
1902
+ > ### 返回:
1903
+ > - `data.user.id`: 用户ID
1904
+ > - `data.user.username`: 用户名
1905
+ > - `data.user.full_name`: 全名
1906
+ > - `data.user.biography`: 个人简介
1907
+ > - `data.user.external_url`: 外部链接
1908
+ > - `data.user.profile_pic_url`: 头像URL(标准)
1909
+ > - `data.user.profile_pic_url_hd`: 头像URL(高清)
1910
+ > - `data.user.is_verified`: 是否认证
1911
+ > - `data.user.is_private`: 是否私密账号
1912
+ > - `data.user.edge_followed_by.count`: 粉丝数
1913
+ > - `data.user.edge_follow.count`: 关注数
1914
+ > - `data.user.edge_owner_to_timeline_media.count`: 帖子总数
1915
+ > - `data.user.edge_felix_video_timeline.count`: Reels/视频数
1916
+ > ### 价格:
1917
+ > - 0.002 USD/请求
1918
+ >
1919
+ > # [English]
1920
+ > ### Purpose:
1921
+ > - Get complete Instagram user profile information
1922
+ > - Including basic info, statistics, recent posts, etc.
1923
+ > ### Parameters (one of):
1924
+ > - user_id: Instagram user ID (numeric)
1925
+ > - username: Instagram username
1926
+ > ### Return:
1927
+ > - `data.user.id`: User ID
1928
+ > - `data.user.username`: Username
1929
+ > - `data.user.full_name`: Full name
1930
+ > - `data.user.biography`: Biography
1931
+ > - `data.user.external_url`: External URL
1932
+ > - `data.user.profile_pic_url`: Profile picture URL (standard)
1933
+ > - `data.user.profile_pic_url_hd`: Profile picture URL (HD)
1934
+ > - `data.user.is_verified`: Whether verified
1935
+ > - `data.user.is_private`: Whether private account
1936
+ > - `data.user.edge_followed_by.count`: Followers count
1937
+ > - `data.user.edge_follow.count`: Following count
1938
+ > - `data.user.edge_owner_to_timeline_media.count`: Total posts count
1939
+ > - `data.user.edge_felix_video_timeline.count`: Reels/videos count
1940
+ > ### Price:
1941
+ > - 0.002 USD/request
1942
+ >
1943
+ > ### 示例/Example
1944
+ > user_id = "58208242181"
1945
+
1946
+ #### Parameters
1947
+
1948
+ | Field | In | Type | Required | Description | Default | Example | Enum |
1949
+ | --- | --- | --- | --- | --- | --- | --- | --- |
1950
+ | user_id | query | string | No | 用户ID/User ID | None | 58208242181 | None |
1951
+ | username | query | string | No | 用户名/Username | None | liensue.talks | None |
1952
+
1953
+ #### Request Body
1954
+
1955
+ None
1956
+
1957
+ #### Success Response
1958
+
1959
+ ##### `200 application/json`
1960
+
1961
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
1962
+
1963
+ | Field | Type | Required | Description | Default | Example | Enum |
1964
+ | --- | --- | --- | --- | --- | --- | --- |
1965
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
1966
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
1967
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
1968
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
1969
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
1970
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
1971
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
1972
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
1973
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
1974
+ | 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 |
1975
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
1976
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
1977
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
1978
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
1979
+ | data | null | No | The response data \| 响应数据 | None | None | None |
1980
+
1981
+ <a id="get-api-u1-v1-instagram-v3-get-user-reels"></a>
1982
+ ### `GET /api/u1/v1/instagram/v3/get_user_reels`
1983
+
1984
+ - Summary: 获取用户Reels列表/Get user reels
1985
+ - Capabilities: profiles / accounts
1986
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
1987
+ - operationId: `get_user_reels_api_v1_instagram_v3_get_user_reels_get`
1988
+
1989
+ #### Notes
1990
+
1991
+ > # [中文]
1992
+ > ### 用途:
1993
+ > - 获取Instagram用户的Reels列表
1994
+ > - 支持分页获取用户发布的所有Reels
1995
+ > ### 参数(二选一):
1996
+ > - user_id: Instagram用户ID(数字)
1997
+ > - username: Instagram用户名
1998
+ > - first: 每次获取的Reels数量(默认12)
1999
+ > - after: 分页游标,首次请求不传,从上一次响应的 `data.page_info.end_cursor` 获取
2000
+ > ### 返回:
2001
+ > - `data.edges`: Reels列表
2002
+ > - `node.media`: Reels媒体信息
2003
+ > - `code`: 帖子短代码
2004
+ > - `pk`: 帖子ID
2005
+ > - `like_count`: 点赞数
2006
+ > - `comment_count`: 评论数
2007
+ > - `play_count`: 播放数
2008
+ > - `caption.text`: 描述文本
2009
+ > - `user`: 发布者信息
2010
+ > - `video_versions`: 视频版本列表
2011
+ > - `image_versions2`: 封面图版本列表
2012
+ > - `data.page_info`: 分页信息
2013
+ > - `has_next_page`: 是否有下一页
2014
+ > - `end_cursor`: 下一页游标(传给下次请求的after参数)
2015
+ > ### 分页使用方法:
2016
+ > 1. 首次请求:只传 `user_id` 和 `first` 参数
2017
+ > 2. 获取响应中的 `data.page_info.end_cursor`
2018
+ > 3. 下次请求:传入 `user_id`、`first` 和 `after` (使用上次的end_cursor)
2019
+ > 4. 重复步骤 2-3 直到 `data.page_info.has_next_page` 为 false
2020
+ > ### 价格:
2021
+ > - 0.002 USD/请求
2022
+ >
2023
+ > # [English]
2024
+ > ### Purpose:
2025
+ > - Get Instagram user's Reels list
2026
+ > - Support pagination to fetch all user's Reels
2027
+ > ### Parameters (one of):
2028
+ > - user_id: Instagram user ID (numeric)
2029
+ > - username: Instagram username
2030
+ > ### Other parameters:
2031
+ > - first: Number of Reels to fetch per request (default 12)
2032
+ > - after: Pagination cursor, omit for first request, get from previous response `data.page_info.end_cursor`
2033
+ > ### Return:
2034
+ > - `data.edges`: Reels list
2035
+ > - `node.media`: Reels media info
2036
+ > - `code`: Post shortcode
2037
+ > - `pk`: Post ID
2038
+ > - `like_count`: Likes count
2039
+ > - `comment_count`: Comments count
2040
+ > - `play_count`: Play count
2041
+ > - `caption.text`: Description text
2042
+ > - `user`: Publisher info
2043
+ > - `video_versions`: Video version list
2044
+ > - `image_versions2`: Cover image version list
2045
+ > - `data.page_info`: Pagination info
2046
+ > - `has_next_page`: Whether has next page
2047
+ > - `end_cursor`: Next page cursor (use as after parameter in next request)
2048
+ > ### Pagination usage:
2049
+ > 1. First request: Only pass `user_id` and `first` parameters
2050
+ > 2. Get `data.page_info.end_cursor` from response
2051
+ > 3. Next request: Pass `user_id`, `first`, and `after` (use end_cursor from previous)
2052
+ > 4. Repeat steps 2-3 until `data.page_info.has_next_page` is false
2053
+ > ### Price:
2054
+ > - 0.002 USD/request
2055
+ >
2056
+ > ### 示例/Example
2057
+ > user_id = "58208242181"
2058
+ > first = 12
2059
+
2060
+ #### Parameters
2061
+
2062
+ | Field | In | Type | Required | Description | Default | Example | Enum |
2063
+ | --- | --- | --- | --- | --- | --- | --- | --- |
2064
+ | user_id | query | string | No | 用户ID/User ID | None | 58208242181 | None |
2065
+ | username | query | string | No | 用户名/Username | None | liensue.talks | None |
2066
+ | first | query | integer | No | 获取数量/Number of reels to fetch | 12 | 12 | None |
2067
+ | after | query | string | No | 分页游标(从上次响应的page_info.end_cursor获取)/Pagination cursor (from previous response page_info.end_cursor) | None | None | None |
2068
+
2069
+ #### Request Body
2070
+
2071
+ None
2072
+
2073
+ #### Success Response
2074
+
2075
+ ##### `200 application/json`
2076
+
2077
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
2078
+
2079
+ | Field | Type | Required | Description | Default | Example | Enum |
2080
+ | --- | --- | --- | --- | --- | --- | --- |
2081
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
2082
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
2083
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
2084
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
2085
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
2086
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
2087
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
2088
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
2089
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
2090
+ | 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 |
2091
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
2092
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
2093
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
2094
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
2095
+ | data | null | No | The response data \| 响应数据 | None | None | None |
2096
+
2097
+ <a id="get-api-u1-v1-instagram-v3-get-user-stories"></a>
2098
+ ### `GET /api/u1/v1/instagram/v3/get_user_stories`
2099
+
2100
+ - Summary: 获取用户Stories(快拍)/Get user stories
2101
+ - Capabilities: profiles / accounts
2102
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
2103
+ - operationId: `get_user_stories_api_v1_instagram_v3_get_user_stories_get`
2104
+
2105
+ #### Notes
2106
+
2107
+ > # [中文]
2108
+ > ### 用途:
2109
+ > - 获取Instagram用户的Stories(快拍)列表
2110
+ > - 即点击用户头像后展示的24小时内发布的快拍内容
2111
+ > - 支持同时获取多个用户的Stories
2112
+ > ### 参数(二选一):
2113
+ > - user_id: Instagram用户ID(数字)
2114
+ > - username: Instagram用户名
2115
+ > - reel_ids: 用户ID列表,逗号分隔(可选,如不提供则仅查询user_id指定的用户)
2116
+ > - 例如: `58208242181,791258468`
2117
+ > - 可同时查询多个用户的Stories
2118
+ > ### 返回:
2119
+ > - `data.reels_media`: Stories列表(按用户分组)
2120
+ > - `id`: 用户ID
2121
+ > - `user`: 用户信息
2122
+ > - `username`: 用户名
2123
+ > - `full_name`: 全名
2124
+ > - `profile_pic_url`: 头像URL
2125
+ > - `items`: Stories条目列表
2126
+ > - `id`: Story ID
2127
+ > - `pk`: Story PK
2128
+ > - `taken_at`: 发布时间戳
2129
+ > - `media_type`: 媒体类型(1=图片, 2=视频)
2130
+ > - `image_versions2`: 图片版本列表
2131
+ > - `video_versions`: 视频版本列表(视频时存在)
2132
+ > - `story_cta`: Story链接(如果有)
2133
+ > - `data.reels`: Stories详细信息
2134
+ > ### 注意:
2135
+ > - Stories有24小时有效期,过期后无法获取
2136
+ > - 私密账号的Stories需要关注后才能查看
2137
+ > ### 价格:
2138
+ > - 0.002 USD/请求
2139
+ >
2140
+ > # [English]
2141
+ > ### Purpose:
2142
+ > - Get Instagram user's Stories list
2143
+ > - Stories displayed when clicking on user's profile picture (published within 24 hours)
2144
+ > - Support fetching multiple users' Stories at once
2145
+ > ### Parameters (one of):
2146
+ > - user_id: Instagram user ID (numeric)
2147
+ > - username: Instagram username
2148
+ > ### Other parameters:
2149
+ > - reel_ids: User ID list, comma separated (optional, if not provided only queries the user_id)
2150
+ > - Example: `58208242181,791258468`
2151
+ > - Can query multiple users' Stories at once
2152
+ > ### Return:
2153
+ > - `data.reels_media`: Stories list (grouped by user)
2154
+ > - `id`: User ID
2155
+ > - `user`: User info
2156
+ > - `username`: Username
2157
+ > - `full_name`: Full name
2158
+ > - `profile_pic_url`: Profile picture URL
2159
+ > - `items`: Stories item list
2160
+ > - `id`: Story ID
2161
+ > - `pk`: Story PK
2162
+ > - `taken_at`: Published timestamp
2163
+ > - `media_type`: Media type (1=image, 2=video)
2164
+ > - `image_versions2`: Image version list
2165
+ > - `video_versions`: Video version list (exists for videos)
2166
+ > - `story_cta`: Story link (if any)
2167
+ > - `data.reels`: Stories detailed info
2168
+ > ### Note:
2169
+ > - Stories have a 24-hour expiration, cannot be fetched after expiration
2170
+ > - Private account's Stories require following to view
2171
+ > ### Price:
2172
+ > - 0.002 USD/request
2173
+ >
2174
+ > ### 示例/Example
2175
+ > ```
2176
+ > user_id = "58208242181"
2177
+ > # reel_ids = "58208242181,791258468"
2178
+ > ```
2179
+
2180
+ #### Parameters
2181
+
2182
+ | Field | In | Type | Required | Description | Default | Example | Enum |
2183
+ | --- | --- | --- | --- | --- | --- | --- | --- |
2184
+ | user_id | query | string | No | 用户ID/User ID | None | 58208242181 | None |
2185
+ | username | query | string | No | 用户名/Username | None | liensue.talks | None |
2186
+ | reel_ids | query | string | No | 用户ID列表,逗号分隔,可同时获取多个用户的Stories(如不提供则仅查询user_id)/User ID list, comma separated, fetch multiple users' stories at once (if not provided, only queries user_id) | None | None | None |
2187
+
2188
+ #### Request Body
2189
+
2190
+ None
2191
+
2192
+ #### Success Response
2193
+
2194
+ ##### `200 application/json`
2195
+
2196
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
2197
+
2198
+ | Field | Type | Required | Description | Default | Example | Enum |
2199
+ | --- | --- | --- | --- | --- | --- | --- |
2200
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
2201
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
2202
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
2203
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
2204
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
2205
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
2206
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
2207
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
2208
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
2209
+ | 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 |
2210
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
2211
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
2212
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
2213
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
2214
+ | data | null | No | The response data \| 响应数据 | None | None | None |
2215
+
2216
+ <a id="get-api-u1-v1-instagram-v3-get-user-tagged-posts"></a>
2217
+ ### `GET /api/u1/v1/instagram/v3/get_user_tagged_posts`
2218
+
2219
+ - Summary: 获取用户被标记的帖子/Get user tagged posts
2220
+ - Capabilities: profiles / accounts / content details
2221
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
2222
+ - operationId: `get_user_tagged_posts_api_v1_instagram_v3_get_user_tagged_posts_get`
2223
+
2224
+ #### Notes
2225
+
2226
+ > # [中文]
2227
+ > ### 用途:
2228
+ > - 获取Instagram用户被标记(tagged)的帖子列表
2229
+ > - 即其他用户在帖子中标记了该用户的内容
2230
+ > - 支持分页获取
2231
+ > ### 参数(二选一):
2232
+ > - user_id: Instagram用户ID(数字)
2233
+ > - username: Instagram用户名
2234
+ > - first: 每次获取的帖子数量(默认12)
2235
+ > - after: 分页游标,首次请求不传,从上一次响应的 `data.page_info.end_cursor` 获取
2236
+ > ### 返回:
2237
+ > - `data.edges`: 帖子列表
2238
+ > - `node.id`: 帖子ID
2239
+ > - `node.code`: 帖子短代码
2240
+ > - `node.display_url`: 展示图片URL
2241
+ > - `node.taken_at`: 发布时间戳
2242
+ > - `node.like_count`: 点赞数
2243
+ > - `node.comment_count`: 评论数
2244
+ > - `node.caption.text`: 帖子文本
2245
+ > - `node.user`: 发帖者信息
2246
+ > - `data.page_info`: 分页信息
2247
+ > - `has_next_page`: 是否有下一页
2248
+ > - `end_cursor`: 下一页游标(传给下次请求的after参数)
2249
+ > ### 分页使用方法:
2250
+ > 1. 首次请求:只传 `user_id` 和 `first` 参数
2251
+ > 2. 获取响应中的 `data.page_info.end_cursor`
2252
+ > 3. 下次请求:传入 `user_id`、`first` 和 `after` (使用上次的end_cursor)
2253
+ > 4. 重复步骤 2-3 直到 `data.page_info.has_next_page` 为 false
2254
+ > ### 价格:
2255
+ > - 0.002 USD/请求
2256
+ >
2257
+ > # [English]
2258
+ > ### Purpose:
2259
+ > - Get Instagram user's tagged posts list
2260
+ > - Posts where other users tagged this user
2261
+ > - Support pagination
2262
+ > ### Parameters (one of):
2263
+ > - user_id: Instagram user ID (numeric)
2264
+ > - username: Instagram username
2265
+ > ### Other parameters:
2266
+ > - first: Number of posts to fetch per request (default 12)
2267
+ > - after: Pagination cursor, omit for first request, get from previous response `data.page_info.end_cursor`
2268
+ > ### Return:
2269
+ > - `data.edges`: Post list
2270
+ > - `node.id`: Post ID
2271
+ > - `node.code`: Post shortcode
2272
+ > - `node.display_url`: Display image URL
2273
+ > - `node.taken_at`: Published timestamp
2274
+ > - `node.like_count`: Likes count
2275
+ > - `node.comment_count`: Comments count
2276
+ > - `node.caption.text`: Post caption text
2277
+ > - `node.user`: Post author info
2278
+ > - `data.page_info`: Pagination info
2279
+ > - `has_next_page`: Whether has next page
2280
+ > - `end_cursor`: Next page cursor (use as after parameter in next request)
2281
+ > ### Pagination usage:
2282
+ > 1. First request: Only pass `user_id`/`username` and `first` parameters
2283
+ > 2. Get `data.page_info.end_cursor` from response
2284
+ > 3. Next request: Pass `user_id`, `first`, and `after` (use end_cursor from previous)
2285
+ > 4. Repeat steps 2-3 until `data.page_info.has_next_page` is false
2286
+ > ### Price:
2287
+ > - 0.002 USD/request
2288
+ >
2289
+ > ### 示例/Example
2290
+ > user_id = "58208242181"
2291
+ > first = 12
2292
+
2293
+ #### Parameters
2294
+
2295
+ | Field | In | Type | Required | Description | Default | Example | Enum |
2296
+ | --- | --- | --- | --- | --- | --- | --- | --- |
2297
+ | user_id | query | string | No | 用户ID/User ID | None | 58208242181 | None |
2298
+ | username | query | string | No | 用户名/Username | None | liensue.talks | None |
2299
+ | first | query | integer | No | 获取帖子数量/Number of posts to fetch | 12 | 12 | None |
2300
+ | after | query | string | No | 分页游标(从上次响应的page_info.end_cursor获取)/Pagination cursor (from previous response page_info.end_cursor) | None | None | None |
2301
+
2302
+ #### Request Body
2303
+
2304
+ None
2305
+
2306
+ #### Success Response
2307
+
2308
+ ##### `200 application/json`
2309
+
2310
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
2311
+
2312
+ | Field | Type | Required | Description | Default | Example | Enum |
2313
+ | --- | --- | --- | --- | --- | --- | --- |
2314
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
2315
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
2316
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
2317
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
2318
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
2319
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
2320
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
2321
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
2322
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
2323
+ | 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 |
2324
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
2325
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
2326
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
2327
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
2328
+ | data | null | No | The response data \| 响应数据 | None | None | None |
2329
+
2330
+ <a id="get-api-u1-v1-instagram-v3-search-hashtags"></a>
2331
+ ### `GET /api/u1/v1/instagram/v3/search_hashtags`
2332
+
2333
+ - Summary: 搜索话题标签/Search hashtags
2334
+ - Capabilities: search / topics
2335
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
2336
+ - operationId: `search_hashtags_api_v1_instagram_v3_search_hashtags_get`
2337
+
2338
+ #### Notes
2339
+
2340
+ > # [中文]
2341
+ > ### 用途:
2342
+ > - Instagram话题标签搜索接口
2343
+ > - 仅返回话题标签搜索结果
2344
+ > ### 参数:
2345
+ > - query: 搜索关键词
2346
+ > ### 返回:
2347
+ > - `data.hashtags`: 话题标签搜索结果列表
2348
+ > - `data.rank_token`: 排序token
2349
+ > - `data.see_more`: 更多信息
2350
+ > - `data.inform_module`: 提示模块
2351
+ > ### 价格:
2352
+ > - 0.002 USD/请求
2353
+ >
2354
+ > # [English]
2355
+ > ### Purpose:
2356
+ > - Instagram hashtag search API
2357
+ > - Returns only hashtag search results
2358
+ > ### Parameters:
2359
+ > - query: Search keyword
2360
+ > ### Return:
2361
+ > - `data.hashtags`: Hashtag search results
2362
+ > - `data.rank_token`: Rank token
2363
+ > - `data.see_more`: See more info
2364
+ > - `data.inform_module`: Inform module
2365
+ > ### Price:
2366
+ > - 0.002 USD/request
2367
+ >
2368
+ > ### 示例/Example
2369
+ > query = "fashion"
2370
+
2371
+ #### Parameters
2372
+
2373
+ | Field | In | Type | Required | Description | Default | Example | Enum |
2374
+ | --- | --- | --- | --- | --- | --- | --- | --- |
2375
+ | query | query | string | Yes | 搜索关键词/Search keyword | None | fashion | None |
2376
+
2377
+ #### Request Body
2378
+
2379
+ None
2380
+
2381
+ #### Success Response
2382
+
2383
+ ##### `200 application/json`
2384
+
2385
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
2386
+
2387
+ | Field | Type | Required | Description | Default | Example | Enum |
2388
+ | --- | --- | --- | --- | --- | --- | --- |
2389
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
2390
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
2391
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
2392
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
2393
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
2394
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
2395
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
2396
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
2397
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
2398
+ | 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 |
2399
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
2400
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
2401
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
2402
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
2403
+ | data | null | No | The response data \| 响应数据 | None | None | None |
2404
+
2405
+ <a id="get-api-u1-v1-instagram-v3-search-places"></a>
2406
+ ### `GET /api/u1/v1/instagram/v3/search_places`
2407
+
2408
+ - Summary: 搜索地点/Search places
2409
+ - Capabilities: search
2410
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
2411
+ - operationId: `search_places_api_v1_instagram_v3_search_places_get`
2412
+
2413
+ #### Notes
2414
+
2415
+ > # [中文]
2416
+ > ### 用途:
2417
+ > - Instagram地点搜索接口
2418
+ > - 仅返回地点搜索结果
2419
+ > ### 参数:
2420
+ > - query: 搜索关键词
2421
+ > ### 返回:
2422
+ > - `data.places`: 地点搜索结果列表
2423
+ > - `data.rank_token`: 排序token
2424
+ > - `data.see_more`: 更多信息
2425
+ > - `data.inform_module`: 提示模块
2426
+ > ### 价格:
2427
+ > - 0.002 USD/请求
2428
+ >
2429
+ > # [English]
2430
+ > ### Purpose:
2431
+ > - Instagram place search API
2432
+ > - Returns only place search results
2433
+ > ### Parameters:
2434
+ > - query: Search keyword
2435
+ > ### Return:
2436
+ > - `data.places`: Place search results
2437
+ > - `data.rank_token`: Rank token
2438
+ > - `data.see_more`: See more info
2439
+ > - `data.inform_module`: Inform module
2440
+ > ### Price:
2441
+ > - 0.002 USD/request
2442
+ >
2443
+ > ### 示例/Example
2444
+ > query = "tokyo"
2445
+
2446
+ #### Parameters
2447
+
2448
+ | Field | In | Type | Required | Description | Default | Example | Enum |
2449
+ | --- | --- | --- | --- | --- | --- | --- | --- |
2450
+ | query | query | string | Yes | 搜索关键词/Search keyword | None | tokyo | None |
2451
+
2452
+ #### Request Body
2453
+
2454
+ None
2455
+
2456
+ #### Success Response
2457
+
2458
+ ##### `200 application/json`
2459
+
2460
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
2461
+
2462
+ | Field | Type | Required | Description | Default | Example | Enum |
2463
+ | --- | --- | --- | --- | --- | --- | --- |
2464
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
2465
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
2466
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
2467
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
2468
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
2469
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
2470
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
2471
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
2472
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
2473
+ | 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 |
2474
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
2475
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
2476
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
2477
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
2478
+ | data | null | No | The response data \| 响应数据 | None | None | None |
2479
+
2480
+ <a id="get-api-u1-v1-instagram-v3-search-users"></a>
2481
+ ### `GET /api/u1/v1/instagram/v3/search_users`
2482
+
2483
+ - Summary: 搜索用户/Search users
2484
+ - Capabilities: search / profiles / accounts
2485
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
2486
+ - operationId: `search_users_api_v1_instagram_v3_search_users_get`
2487
+
2488
+ #### Notes
2489
+
2490
+ > # [中文]
2491
+ > ### 用途:
2492
+ > - Instagram用户搜索接口
2493
+ > - 仅返回用户搜索结果
2494
+ > ### 参数:
2495
+ > - query: 搜索关键词
2496
+ > ### 返回:
2497
+ > - `data.users`: 用户搜索结果列表
2498
+ > - `data.rank_token`: 排序token
2499
+ > - `data.see_more`: 更多信息
2500
+ > - `data.inform_module`: 提示模块
2501
+ > ### 价格:
2502
+ > - 0.002 USD/请求
2503
+ >
2504
+ > # [English]
2505
+ > ### Purpose:
2506
+ > - Instagram user search API
2507
+ > - Returns only user search results
2508
+ > ### Parameters:
2509
+ > - query: Search keyword
2510
+ > ### Return:
2511
+ > - `data.users`: User search results
2512
+ > - `data.rank_token`: Rank token
2513
+ > - `data.see_more`: See more info
2514
+ > - `data.inform_module`: Inform module
2515
+ > ### Price:
2516
+ > - 0.002 USD/request
2517
+ >
2518
+ > ### 示例/Example
2519
+ > query = "justin"
2520
+
2521
+ #### Parameters
2522
+
2523
+ | Field | In | Type | Required | Description | Default | Example | Enum |
2524
+ | --- | --- | --- | --- | --- | --- | --- | --- |
2525
+ | query | query | string | Yes | 搜索关键词/Search keyword | None | justin | None |
2526
+
2527
+ #### Request Body
2528
+
2529
+ None
2530
+
2531
+ #### Success Response
2532
+
2533
+ ##### `200 application/json`
2534
+
2535
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
2536
+
2537
+ | Field | Type | Required | Description | Default | Example | Enum |
2538
+ | --- | --- | --- | --- | --- | --- | --- |
2539
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
2540
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
2541
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
2542
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
2543
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
2544
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
2545
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
2546
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
2547
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
2548
+ | 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 |
2549
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
2550
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
2551
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
2552
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
2553
+ | data | null | No | The response data \| 响应数据 | None | None | None |
2554
+
2555
+ <a id="get-api-u1-v1-instagram-v3-translate-comment"></a>
2556
+ ### `GET /api/u1/v1/instagram/v3/translate_comment`
2557
+
2558
+ - Summary: 翻译评论/帖子文本/Translate comment or caption
2559
+ - Capabilities: comments
2560
+ - Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
2561
+ - operationId: `translate_comment_api_v1_instagram_v3_translate_comment_get`
2562
+
2563
+ #### Notes
2564
+
2565
+ > # [中文]
2566
+ > ### 用途:
2567
+ > - 翻译Instagram帖子文本(caption)
2568
+ > - 内部强制 is_caption=True,专门用于翻译帖子的文字说明
2569
+ > ### 参数:
2570
+ > - comment_id: 帖子媒体ID
2571
+ > ### 返回:
2572
+ > - `data.translation`: 翻译后的文本
2573
+ > - `data.source_language`: 原文语言
2574
+ > ### 注意:
2575
+ > - 翻译目标语言取决于请求所使用的 Cookie 对应账号的语言设置(通常为英语)
2576
+ > - 无法指定翻译目标语言,由 Instagram 服务端根据账号设置自动决定
2577
+ > ### 价格:
2578
+ > - 0.002 USD/请求
2579
+ >
2580
+ > # [English]
2581
+ > ### Purpose:
2582
+ > - Translate Instagram post caption
2583
+ > - Internally forces is_caption=True, specifically for translating post captions
2584
+ > ### Parameters:
2585
+ > - comment_id: Post media ID
2586
+ > ### Return:
2587
+ > - `data.translation`: Translated text
2588
+ > - `data.source_language`: Source language
2589
+ > ### Note:
2590
+ > - The target translation language depends on the language setting of the account associated with the cookie used (usually English)
2591
+ > - Cannot specify the target language, it is automatically determined by Instagram based on the account settings
2592
+ > ### Price:
2593
+ > - 0.002 USD/request
2594
+ >
2595
+ > ### 示例/Example
2596
+ > comment_id = "18191961100350646"
2597
+
2598
+ #### Parameters
2599
+
2600
+ | Field | In | Type | Required | Description | Default | Example | Enum |
2601
+ | --- | --- | --- | --- | --- | --- | --- | --- |
2602
+ | comment_id | query | string | Yes | 帖子媒体ID/Post media ID | None | 18191961100350646 | None |
2603
+
2604
+ #### Request Body
2605
+
2606
+ None
2607
+
2608
+ #### Success Response
2609
+
2610
+ ##### `200 application/json`
2611
+
2612
+ - Schema summary: `code`:integer, `request_id`:string, `message`:string, `message_zh`:string, `support`:string, `time`:string, `time_stamp`:integer, `time_zone`:string, ...
2613
+
2614
+ | Field | Type | Required | Description | Default | Example | Enum |
2615
+ | --- | --- | --- | --- | --- | --- | --- |
2616
+ | code | integer | No | HTTP status code \| HTTP状态码 | 200 | None | None |
2617
+ | request_id | string | No | Unique request identifier \| 唯一请求标识符 | None | None | None |
2618
+ | message | string | No | Response message (EN-US) \| 响应消息 (English) | Request successful. This request will incur a charge. | None | None |
2619
+ | message_zh | string | No | Response message (ZH-CN) \| 响应消息 (中文) | 请求成功,本次请求将被计费。 | None | None |
2620
+ | support | string | No | Support message \| 支持消息 | Discord: https://discord.gg/aMEAS8Xsvz | None | None |
2621
+ | time | string | No | The time the response was generated \| 生成响应的时间 | None | None | None |
2622
+ | time_stamp | integer | No | The timestamp the response was generated \| 生成响应的时间戳 | None | None | None |
2623
+ | time_zone | string | No | The timezone of the response time \| 响应时间的时区 | America/Los_Angeles | None | None |
2624
+ | docs | string | No | Link to the API Swagger documentation for this endpoint \| 此端点的 API Swagger 文档链接 | None | None | None |
2625
+ | 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 |
2626
+ | cache_message_zh | string | No | Cache message (ZH-CN) \| 缓存消息 (中文) | 本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。 | None | None |
2627
+ | cache_url | string | No | The URL to access the cached result \| 访问缓存结果的 URL | None | None | None |
2628
+ | router | string | No | The endpoint that generated this response \| 生成此响应的端点 | None | None | None |
2629
+ | params | dynamic object | No | The parameters used in the request \| 请求中使用的参数 | None | None | None |
2630
+ | data | null | No | The response data \| 响应数据 | None | None | None |