@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.
- package/.skill-package-allowlist.txt +4 -0
- package/LICENSE +21 -0
- package/README.md +167 -0
- package/README.zh-CN.md +167 -0
- package/bin/tikomni-skills.js +127 -0
- package/env.example +160 -0
- package/lib/installer.js +176 -0
- package/package.json +44 -0
- package/skills/creator-analysis/SKILL.md +71 -0
- package/skills/creator-analysis/agents/openai.yaml +4 -0
- package/skills/creator-analysis/env.example +36 -0
- package/skills/creator-analysis/references/api-capability-index.md +92 -0
- package/skills/creator-analysis/references/api-contracts/asr-api.md +130 -0
- package/skills/creator-analysis/references/api-contracts/bilibili-app-api.md +776 -0
- package/skills/creator-analysis/references/api-contracts/bilibili-web-api.md +2017 -0
- package/skills/creator-analysis/references/api-contracts/demo-api.md +717 -0
- package/skills/creator-analysis/references/api-contracts/douyin-app-v3-api.md +3594 -0
- package/skills/creator-analysis/references/api-contracts/douyin-billboard-api.md +2274 -0
- package/skills/creator-analysis/references/api-contracts/douyin-creator-api.md +1575 -0
- package/skills/creator-analysis/references/api-contracts/douyin-creator-v2-api.md +3254 -0
- package/skills/creator-analysis/references/api-contracts/douyin-search-api.md +4118 -0
- package/skills/creator-analysis/references/api-contracts/douyin-web-api.md +5544 -0
- package/skills/creator-analysis/references/api-contracts/douyin-xingtu-api.md +1916 -0
- package/skills/creator-analysis/references/api-contracts/douyin-xingtu-v2-api.md +1540 -0
- package/skills/creator-analysis/references/api-contracts/health-check.md +69 -0
- package/skills/creator-analysis/references/api-contracts/hybrid-parsing.md +78 -0
- package/skills/creator-analysis/references/api-contracts/instagram-v1-api.md +2256 -0
- package/skills/creator-analysis/references/api-contracts/instagram-v2-api.md +2011 -0
- package/skills/creator-analysis/references/api-contracts/instagram-v3-api.md +2630 -0
- package/skills/creator-analysis/references/api-contracts/ios-shortcut.md +44 -0
- package/skills/creator-analysis/references/api-contracts/kuaishou-app-api.md +1518 -0
- package/skills/creator-analysis/references/api-contracts/kuaishou-web-api.md +1242 -0
- package/skills/creator-analysis/references/api-contracts/lemon8-app-api.md +1088 -0
- package/skills/creator-analysis/references/api-contracts/linkedin-web-api.md +1949 -0
- package/skills/creator-analysis/references/api-contracts/media-ingest-api.md +126 -0
- package/skills/creator-analysis/references/api-contracts/pipixia-app-api.md +1142 -0
- package/skills/creator-analysis/references/api-contracts/reddit-app-api.md +2025 -0
- package/skills/creator-analysis/references/api-contracts/sora2-api.md +2266 -0
- package/skills/creator-analysis/references/api-contracts/temp-mail-api.md +208 -0
- package/skills/creator-analysis/references/api-contracts/threads-web-api.md +897 -0
- package/skills/creator-analysis/references/api-contracts/tikhub-downloader-api.md +134 -0
- package/skills/creator-analysis/references/api-contracts/tikhub-user-api.md +494 -0
- package/skills/creator-analysis/references/api-contracts/tiktok-ads-api.md +5947 -0
- package/skills/creator-analysis/references/api-contracts/tiktok-analytics-api.md +968 -0
- package/skills/creator-analysis/references/api-contracts/tiktok-app-v3-api.md +5735 -0
- package/skills/creator-analysis/references/api-contracts/tiktok-creator-api.md +1951 -0
- package/skills/creator-analysis/references/api-contracts/tiktok-interaction-api.md +742 -0
- package/skills/creator-analysis/references/api-contracts/tiktok-shop-web-api.md +1890 -0
- package/skills/creator-analysis/references/api-contracts/tiktok-web-api.md +4448 -0
- package/skills/creator-analysis/references/api-contracts/toutiao-app-api.md +342 -0
- package/skills/creator-analysis/references/api-contracts/toutiao-web-api.md +143 -0
- package/skills/creator-analysis/references/api-contracts/twitter-web-api.md +989 -0
- package/skills/creator-analysis/references/api-contracts/wechat-channels-api.md +809 -0
- package/skills/creator-analysis/references/api-contracts/wechat-media-platform-web-api.md +677 -0
- package/skills/creator-analysis/references/api-contracts/weibo-app-api.md +1547 -0
- package/skills/creator-analysis/references/api-contracts/weibo-web-api.md +798 -0
- package/skills/creator-analysis/references/api-contracts/weibo-web-v2-api.md +2459 -0
- package/skills/creator-analysis/references/api-contracts/xiaohongshu-app-api.md +1291 -0
- package/skills/creator-analysis/references/api-contracts/xiaohongshu-app-v2-api.md +1683 -0
- package/skills/creator-analysis/references/api-contracts/xiaohongshu-web-api.md +1324 -0
- package/skills/creator-analysis/references/api-contracts/xiaohongshu-web-v2-api.md +1209 -0
- package/skills/creator-analysis/references/api-contracts/xigua-app-v2-api.md +489 -0
- package/skills/creator-analysis/references/api-contracts/youtube-web-api.md +2636 -0
- package/skills/creator-analysis/references/api-contracts/youtube-web-v2-api.md +2660 -0
- package/skills/creator-analysis/references/api-contracts/zhihu-web-api.md +2315 -0
- package/skills/creator-analysis/references/api-tags/asr-api.md +100 -0
- package/skills/creator-analysis/references/api-tags/bilibili-app-api.md +482 -0
- package/skills/creator-analysis/references/api-tags/bilibili-web-api.md +1267 -0
- package/skills/creator-analysis/references/api-tags/demo-api.md +365 -0
- package/skills/creator-analysis/references/api-tags/douyin-app-v3-api.md +2012 -0
- package/skills/creator-analysis/references/api-tags/douyin-billboard-api.md +1428 -0
- package/skills/creator-analysis/references/api-tags/douyin-creator-api.md +694 -0
- package/skills/creator-analysis/references/api-tags/douyin-creator-v2-api.md +694 -0
- package/skills/creator-analysis/references/api-tags/douyin-search-api.md +1059 -0
- package/skills/creator-analysis/references/api-tags/douyin-web-api.md +3314 -0
- package/skills/creator-analysis/references/api-tags/douyin-xingtu-api.md +935 -0
- package/skills/creator-analysis/references/api-tags/douyin-xingtu-v2-api.md +925 -0
- package/skills/creator-analysis/references/api-tags/health-check.md +40 -0
- package/skills/creator-analysis/references/api-tags/hybrid-parsing.md +57 -0
- package/skills/creator-analysis/references/api-tags/instagram-v1-api.md +1224 -0
- package/skills/creator-analysis/references/api-tags/instagram-v2-api.md +1147 -0
- package/skills/creator-analysis/references/api-tags/instagram-v3-api.md +1123 -0
- package/skills/creator-analysis/references/api-tags/ios-shortcut.md +45 -0
- package/skills/creator-analysis/references/api-tags/kuaishou-app-api.md +846 -0
- package/skills/creator-analysis/references/api-tags/kuaishou-web-api.md +551 -0
- package/skills/creator-analysis/references/api-tags/lemon8-app-api.md +687 -0
- package/skills/creator-analysis/references/api-tags/linkedin-web-api.md +1105 -0
- package/skills/creator-analysis/references/api-tags/media-ingest-api.md +112 -0
- package/skills/creator-analysis/references/api-tags/pipixia-app-api.md +721 -0
- package/skills/creator-analysis/references/api-tags/reddit-app-api.md +1057 -0
- package/skills/creator-analysis/references/api-tags/sora2-api.md +737 -0
- package/skills/creator-analysis/references/api-tags/temp-mail-api.md +136 -0
- package/skills/creator-analysis/references/api-tags/threads-web-api.md +472 -0
- package/skills/creator-analysis/references/api-tags/tikhub-downloader-api.md +65 -0
- package/skills/creator-analysis/references/api-tags/tikhub-user-api.md +253 -0
- package/skills/creator-analysis/references/api-tags/tiktok-ads-api.md +1393 -0
- package/skills/creator-analysis/references/api-tags/tiktok-analytics-api.md +179 -0
- package/skills/creator-analysis/references/api-tags/tiktok-app-v3-api.md +3264 -0
- package/skills/creator-analysis/references/api-tags/tiktok-creator-api.md +709 -0
- package/skills/creator-analysis/references/api-tags/tiktok-interaction-api.md +366 -0
- package/skills/creator-analysis/references/api-tags/tiktok-shop-web-api.md +663 -0
- package/skills/creator-analysis/references/api-tags/tiktok-web-api.md +2516 -0
- package/skills/creator-analysis/references/api-tags/toutiao-app-api.md +220 -0
- package/skills/creator-analysis/references/api-tags/toutiao-web-api.md +96 -0
- package/skills/creator-analysis/references/api-tags/twitter-web-api.md +562 -0
- package/skills/creator-analysis/references/api-tags/wechat-channels-api.md +405 -0
- package/skills/creator-analysis/references/api-tags/wechat-media-platform-web-api.md +431 -0
- package/skills/creator-analysis/references/api-tags/weibo-app-api.md +851 -0
- package/skills/creator-analysis/references/api-tags/weibo-web-api.md +470 -0
- package/skills/creator-analysis/references/api-tags/weibo-web-v2-api.md +1405 -0
- package/skills/creator-analysis/references/api-tags/xiaohongshu-app-api.md +534 -0
- package/skills/creator-analysis/references/api-tags/xiaohongshu-app-v2-api.md +934 -0
- package/skills/creator-analysis/references/api-tags/xiaohongshu-web-api.md +757 -0
- package/skills/creator-analysis/references/api-tags/xiaohongshu-web-v2-api.md +762 -0
- package/skills/creator-analysis/references/api-tags/xigua-app-v2-api.md +308 -0
- package/skills/creator-analysis/references/api-tags/youtube-web-api.md +934 -0
- package/skills/creator-analysis/references/api-tags/youtube-web-v2-api.md +717 -0
- package/skills/creator-analysis/references/api-tags/zhihu-web-api.md +1384 -0
- package/skills/creator-analysis/references/asr-orchestration.md +33 -0
- package/skills/creator-analysis/references/config-templates/defaults.yaml +60 -0
- package/skills/creator-analysis/references/contracts/creator-card-fields.md +23 -0
- package/skills/creator-analysis/references/contracts/work-card-fields.md +32 -0
- package/skills/creator-analysis/references/platform-guides/douyin.md +49 -0
- package/skills/creator-analysis/references/platform-guides/generic.md +46 -0
- package/skills/creator-analysis/references/platform-guides/xiaohongshu.md +54 -0
- package/skills/creator-analysis/references/prompt-contracts/asr-clean.md +28 -0
- package/skills/creator-analysis/references/prompt-contracts/author-analysis-v2.md +46 -0
- package/skills/creator-analysis/references/prompt-contracts/author-analysis.md +49 -0
- package/skills/creator-analysis/references/prompt-contracts/cta.md +24 -0
- package/skills/creator-analysis/references/prompt-contracts/hook.md +25 -0
- package/skills/creator-analysis/references/prompt-contracts/insight.md +47 -0
- package/skills/creator-analysis/references/prompt-contracts/sampled-work-batch-explanations.md +30 -0
- package/skills/creator-analysis/references/prompt-contracts/structure.md +25 -0
- package/skills/creator-analysis/references/prompt-contracts/style.md +27 -0
- package/skills/creator-analysis/references/prompt-contracts/summary.md +29 -0
- package/skills/creator-analysis/references/prompt-contracts/topic.md +29 -0
- package/skills/creator-analysis/references/schemas/author-analysis-input-v1.schema.json +325 -0
- package/skills/creator-analysis/references/schemas/author-analysis-v2.schema.json +158 -0
- package/skills/creator-analysis/references/schemas/sampled-work-batch-explanations.schema.json +41 -0
- package/skills/creator-analysis/references/service-guides/asr-u2-u3-fallback.md +75 -0
- package/skills/creator-analysis/references/workflow.md +18 -0
- package/skills/creator-analysis/scripts/__init__.py +0 -0
- package/skills/creator-analysis/scripts/author_home/__init__.py +0 -0
- package/skills/creator-analysis/scripts/author_home/adapters/__init__.py +0 -0
- package/skills/creator-analysis/scripts/author_home/adapters/platform_adapters.py +299 -0
- package/skills/creator-analysis/scripts/author_home/analyzers/__init__.py +0 -0
- package/skills/creator-analysis/scripts/author_home/analyzers/author_analysis_v2_support.py +1122 -0
- package/skills/creator-analysis/scripts/author_home/analyzers/prompt_first_analyzers.py +260 -0
- package/skills/creator-analysis/scripts/author_home/analyzers/sampled_work_batch_explainer.py +260 -0
- package/skills/creator-analysis/scripts/author_home/asr/__init__.py +5 -0
- package/skills/creator-analysis/scripts/author_home/asr/home_asr.py +961 -0
- package/skills/creator-analysis/scripts/author_home/builders/__init__.py +0 -0
- package/skills/creator-analysis/scripts/author_home/builders/home_builders.py +149 -0
- package/skills/creator-analysis/scripts/author_home/collectors/__init__.py +0 -0
- package/skills/creator-analysis/scripts/author_home/collectors/homepage_collectors.py +636 -0
- package/skills/creator-analysis/scripts/author_home/orchestrator/__init__.py +0 -0
- package/skills/creator-analysis/scripts/author_home/orchestrator/run_author_analysis.py +491 -0
- package/skills/creator-analysis/scripts/author_home/orchestrator/work_analysis_artifacts.py +553 -0
- package/skills/creator-analysis/scripts/author_home/schema.py +417 -0
- package/skills/creator-analysis/scripts/core/__init__.py +0 -0
- package/skills/creator-analysis/scripts/core/analysis_pipeline.py +133 -0
- package/skills/creator-analysis/scripts/core/bootstrap_env.py +35 -0
- package/skills/creator-analysis/scripts/core/config_loader.py +418 -0
- package/skills/creator-analysis/scripts/core/extract_pipeline.py +173 -0
- package/skills/creator-analysis/scripts/core/progress_report.py +111 -0
- package/skills/creator-analysis/scripts/core/storage_router.py +253 -0
- package/skills/creator-analysis/scripts/core/tikomni_common.py +588 -0
- package/skills/creator-analysis/scripts/pipeline/__init__.py +0 -0
- package/skills/creator-analysis/scripts/pipeline/asr/__init__.py +0 -0
- package/skills/creator-analysis/scripts/pipeline/asr/asr_pipeline.py +1189 -0
- package/skills/creator-analysis/scripts/pipeline/asr/poll_u2_task.py +95 -0
- package/skills/creator-analysis/scripts/platform/__init__.py +0 -0
- package/skills/creator-analysis/scripts/platform/douyin/__init__.py +0 -0
- package/skills/creator-analysis/scripts/platform/douyin/douyin_video_type_matrix.py +224 -0
- package/skills/creator-analysis/scripts/platform/douyin/run_douyin_single_video.py +1208 -0
- package/skills/creator-analysis/scripts/platform/douyin/select_low_quality_video_url.py +200 -0
- package/skills/creator-analysis/scripts/platform/xiaohongshu/__init__.py +0 -0
- package/skills/creator-analysis/scripts/platform/xiaohongshu/run_xiaohongshu_extract.py +2128 -0
- package/skills/creator-analysis/scripts/writers/__init__.py +0 -0
- package/skills/creator-analysis/scripts/writers/write_author_homepage_samples.py +106 -0
- package/skills/creator-analysis/scripts/writers/write_benchmark_card.py +1402 -0
- package/skills/meta-capability/SKILL.md +69 -0
- package/skills/meta-capability/agents/openai.yaml +4 -0
- package/skills/meta-capability/env.example +42 -0
- package/skills/meta-capability/references/api-capability-index.md +92 -0
- package/skills/meta-capability/references/api-contracts/asr-api.md +130 -0
- package/skills/meta-capability/references/api-contracts/bilibili-app-api.md +776 -0
- package/skills/meta-capability/references/api-contracts/bilibili-web-api.md +2017 -0
- package/skills/meta-capability/references/api-contracts/demo-api.md +717 -0
- package/skills/meta-capability/references/api-contracts/douyin-app-v3-api.md +3594 -0
- package/skills/meta-capability/references/api-contracts/douyin-billboard-api.md +2274 -0
- package/skills/meta-capability/references/api-contracts/douyin-creator-api.md +1575 -0
- package/skills/meta-capability/references/api-contracts/douyin-creator-v2-api.md +3254 -0
- package/skills/meta-capability/references/api-contracts/douyin-search-api.md +4118 -0
- package/skills/meta-capability/references/api-contracts/douyin-web-api.md +5544 -0
- package/skills/meta-capability/references/api-contracts/douyin-xingtu-api.md +1916 -0
- package/skills/meta-capability/references/api-contracts/douyin-xingtu-v2-api.md +1540 -0
- package/skills/meta-capability/references/api-contracts/health-check.md +69 -0
- package/skills/meta-capability/references/api-contracts/hybrid-parsing.md +78 -0
- package/skills/meta-capability/references/api-contracts/instagram-v1-api.md +2256 -0
- package/skills/meta-capability/references/api-contracts/instagram-v2-api.md +2011 -0
- package/skills/meta-capability/references/api-contracts/instagram-v3-api.md +2630 -0
- package/skills/meta-capability/references/api-contracts/ios-shortcut.md +44 -0
- package/skills/meta-capability/references/api-contracts/kuaishou-app-api.md +1518 -0
- package/skills/meta-capability/references/api-contracts/kuaishou-web-api.md +1242 -0
- package/skills/meta-capability/references/api-contracts/lemon8-app-api.md +1088 -0
- package/skills/meta-capability/references/api-contracts/linkedin-web-api.md +1949 -0
- package/skills/meta-capability/references/api-contracts/media-ingest-api.md +126 -0
- package/skills/meta-capability/references/api-contracts/pipixia-app-api.md +1142 -0
- package/skills/meta-capability/references/api-contracts/reddit-app-api.md +2025 -0
- package/skills/meta-capability/references/api-contracts/sora2-api.md +2266 -0
- package/skills/meta-capability/references/api-contracts/temp-mail-api.md +208 -0
- package/skills/meta-capability/references/api-contracts/threads-web-api.md +897 -0
- package/skills/meta-capability/references/api-contracts/tikhub-downloader-api.md +134 -0
- package/skills/meta-capability/references/api-contracts/tikhub-user-api.md +494 -0
- package/skills/meta-capability/references/api-contracts/tiktok-ads-api.md +5947 -0
- package/skills/meta-capability/references/api-contracts/tiktok-analytics-api.md +968 -0
- package/skills/meta-capability/references/api-contracts/tiktok-app-v3-api.md +5735 -0
- package/skills/meta-capability/references/api-contracts/tiktok-creator-api.md +1951 -0
- package/skills/meta-capability/references/api-contracts/tiktok-interaction-api.md +742 -0
- package/skills/meta-capability/references/api-contracts/tiktok-shop-web-api.md +1890 -0
- package/skills/meta-capability/references/api-contracts/tiktok-web-api.md +4448 -0
- package/skills/meta-capability/references/api-contracts/toutiao-app-api.md +342 -0
- package/skills/meta-capability/references/api-contracts/toutiao-web-api.md +143 -0
- package/skills/meta-capability/references/api-contracts/twitter-web-api.md +989 -0
- package/skills/meta-capability/references/api-contracts/wechat-channels-api.md +809 -0
- package/skills/meta-capability/references/api-contracts/wechat-media-platform-web-api.md +677 -0
- package/skills/meta-capability/references/api-contracts/weibo-app-api.md +1547 -0
- package/skills/meta-capability/references/api-contracts/weibo-web-api.md +798 -0
- package/skills/meta-capability/references/api-contracts/weibo-web-v2-api.md +2459 -0
- package/skills/meta-capability/references/api-contracts/xiaohongshu-app-api.md +1291 -0
- package/skills/meta-capability/references/api-contracts/xiaohongshu-app-v2-api.md +1683 -0
- package/skills/meta-capability/references/api-contracts/xiaohongshu-web-api.md +1324 -0
- package/skills/meta-capability/references/api-contracts/xiaohongshu-web-v2-api.md +1209 -0
- package/skills/meta-capability/references/api-contracts/xigua-app-v2-api.md +489 -0
- package/skills/meta-capability/references/api-contracts/youtube-web-api.md +2636 -0
- package/skills/meta-capability/references/api-contracts/youtube-web-v2-api.md +2660 -0
- package/skills/meta-capability/references/api-contracts/zhihu-web-api.md +2315 -0
- package/skills/meta-capability/references/api-tags/asr-api.md +100 -0
- package/skills/meta-capability/references/api-tags/bilibili-app-api.md +482 -0
- package/skills/meta-capability/references/api-tags/bilibili-web-api.md +1267 -0
- package/skills/meta-capability/references/api-tags/demo-api.md +365 -0
- package/skills/meta-capability/references/api-tags/douyin-app-v3-api.md +2012 -0
- package/skills/meta-capability/references/api-tags/douyin-billboard-api.md +1428 -0
- package/skills/meta-capability/references/api-tags/douyin-creator-api.md +694 -0
- package/skills/meta-capability/references/api-tags/douyin-creator-v2-api.md +694 -0
- package/skills/meta-capability/references/api-tags/douyin-search-api.md +1059 -0
- package/skills/meta-capability/references/api-tags/douyin-web-api.md +3314 -0
- package/skills/meta-capability/references/api-tags/douyin-xingtu-api.md +935 -0
- package/skills/meta-capability/references/api-tags/douyin-xingtu-v2-api.md +925 -0
- package/skills/meta-capability/references/api-tags/health-check.md +40 -0
- package/skills/meta-capability/references/api-tags/hybrid-parsing.md +57 -0
- package/skills/meta-capability/references/api-tags/instagram-v1-api.md +1224 -0
- package/skills/meta-capability/references/api-tags/instagram-v2-api.md +1147 -0
- package/skills/meta-capability/references/api-tags/instagram-v3-api.md +1123 -0
- package/skills/meta-capability/references/api-tags/ios-shortcut.md +45 -0
- package/skills/meta-capability/references/api-tags/kuaishou-app-api.md +846 -0
- package/skills/meta-capability/references/api-tags/kuaishou-web-api.md +551 -0
- package/skills/meta-capability/references/api-tags/lemon8-app-api.md +687 -0
- package/skills/meta-capability/references/api-tags/linkedin-web-api.md +1105 -0
- package/skills/meta-capability/references/api-tags/media-ingest-api.md +112 -0
- package/skills/meta-capability/references/api-tags/pipixia-app-api.md +721 -0
- package/skills/meta-capability/references/api-tags/reddit-app-api.md +1057 -0
- package/skills/meta-capability/references/api-tags/sora2-api.md +737 -0
- package/skills/meta-capability/references/api-tags/temp-mail-api.md +136 -0
- package/skills/meta-capability/references/api-tags/threads-web-api.md +472 -0
- package/skills/meta-capability/references/api-tags/tikhub-downloader-api.md +65 -0
- package/skills/meta-capability/references/api-tags/tikhub-user-api.md +253 -0
- package/skills/meta-capability/references/api-tags/tiktok-ads-api.md +1393 -0
- package/skills/meta-capability/references/api-tags/tiktok-analytics-api.md +179 -0
- package/skills/meta-capability/references/api-tags/tiktok-app-v3-api.md +3264 -0
- package/skills/meta-capability/references/api-tags/tiktok-creator-api.md +709 -0
- package/skills/meta-capability/references/api-tags/tiktok-interaction-api.md +366 -0
- package/skills/meta-capability/references/api-tags/tiktok-shop-web-api.md +663 -0
- package/skills/meta-capability/references/api-tags/tiktok-web-api.md +2516 -0
- package/skills/meta-capability/references/api-tags/toutiao-app-api.md +220 -0
- package/skills/meta-capability/references/api-tags/toutiao-web-api.md +96 -0
- package/skills/meta-capability/references/api-tags/twitter-web-api.md +562 -0
- package/skills/meta-capability/references/api-tags/wechat-channels-api.md +405 -0
- package/skills/meta-capability/references/api-tags/wechat-media-platform-web-api.md +431 -0
- package/skills/meta-capability/references/api-tags/weibo-app-api.md +851 -0
- package/skills/meta-capability/references/api-tags/weibo-web-api.md +470 -0
- package/skills/meta-capability/references/api-tags/weibo-web-v2-api.md +1405 -0
- package/skills/meta-capability/references/api-tags/xiaohongshu-app-api.md +534 -0
- package/skills/meta-capability/references/api-tags/xiaohongshu-app-v2-api.md +934 -0
- package/skills/meta-capability/references/api-tags/xiaohongshu-web-api.md +757 -0
- package/skills/meta-capability/references/api-tags/xiaohongshu-web-v2-api.md +762 -0
- package/skills/meta-capability/references/api-tags/xigua-app-v2-api.md +308 -0
- package/skills/meta-capability/references/api-tags/youtube-web-api.md +934 -0
- package/skills/meta-capability/references/api-tags/youtube-web-v2-api.md +717 -0
- package/skills/meta-capability/references/api-tags/zhihu-web-api.md +1384 -0
- package/skills/meta-capability/references/config-templates/defaults.yaml +18 -0
- package/skills/meta-capability/references/dispatch.md +27 -0
- package/skills/meta-capability/references/execution-guidelines.md +25 -0
- package/skills/meta-capability/references/implemented-route-map.md +177 -0
- package/skills/meta-capability/references/service-guides/asr-u2-u3-fallback.md +75 -0
- package/skills/meta-capability/scripts/__init__.py +1 -0
- package/skills/meta-capability/scripts/call_route.py +141 -0
- package/skills/meta-capability/scripts/core/__init__.py +1 -0
- package/skills/meta-capability/scripts/core/bootstrap_env.py +32 -0
- package/skills/meta-capability/scripts/core/config_loader.py +204 -0
- package/skills/meta-capability/scripts/core/tikomni_common.py +443 -0
- package/skills/meta-capability/scripts/test_auth.py +98 -0
- package/skills/single-work-analysis/SKILL.md +62 -0
- package/skills/single-work-analysis/agents/openai.yaml +4 -0
- package/skills/single-work-analysis/env.example +36 -0
- package/skills/single-work-analysis/references/api-capability-index.md +92 -0
- package/skills/single-work-analysis/references/api-contracts/asr-api.md +130 -0
- package/skills/single-work-analysis/references/api-contracts/bilibili-app-api.md +776 -0
- package/skills/single-work-analysis/references/api-contracts/bilibili-web-api.md +2017 -0
- package/skills/single-work-analysis/references/api-contracts/demo-api.md +717 -0
- package/skills/single-work-analysis/references/api-contracts/douyin-app-v3-api.md +3594 -0
- package/skills/single-work-analysis/references/api-contracts/douyin-billboard-api.md +2274 -0
- package/skills/single-work-analysis/references/api-contracts/douyin-creator-api.md +1575 -0
- package/skills/single-work-analysis/references/api-contracts/douyin-creator-v2-api.md +3254 -0
- package/skills/single-work-analysis/references/api-contracts/douyin-search-api.md +4118 -0
- package/skills/single-work-analysis/references/api-contracts/douyin-web-api.md +5544 -0
- package/skills/single-work-analysis/references/api-contracts/douyin-xingtu-api.md +1916 -0
- package/skills/single-work-analysis/references/api-contracts/douyin-xingtu-v2-api.md +1540 -0
- package/skills/single-work-analysis/references/api-contracts/health-check.md +69 -0
- package/skills/single-work-analysis/references/api-contracts/hybrid-parsing.md +78 -0
- package/skills/single-work-analysis/references/api-contracts/instagram-v1-api.md +2256 -0
- package/skills/single-work-analysis/references/api-contracts/instagram-v2-api.md +2011 -0
- package/skills/single-work-analysis/references/api-contracts/instagram-v3-api.md +2630 -0
- package/skills/single-work-analysis/references/api-contracts/ios-shortcut.md +44 -0
- package/skills/single-work-analysis/references/api-contracts/kuaishou-app-api.md +1518 -0
- package/skills/single-work-analysis/references/api-contracts/kuaishou-web-api.md +1242 -0
- package/skills/single-work-analysis/references/api-contracts/lemon8-app-api.md +1088 -0
- package/skills/single-work-analysis/references/api-contracts/linkedin-web-api.md +1949 -0
- package/skills/single-work-analysis/references/api-contracts/media-ingest-api.md +126 -0
- package/skills/single-work-analysis/references/api-contracts/pipixia-app-api.md +1142 -0
- package/skills/single-work-analysis/references/api-contracts/reddit-app-api.md +2025 -0
- package/skills/single-work-analysis/references/api-contracts/sora2-api.md +2266 -0
- package/skills/single-work-analysis/references/api-contracts/temp-mail-api.md +208 -0
- package/skills/single-work-analysis/references/api-contracts/threads-web-api.md +897 -0
- package/skills/single-work-analysis/references/api-contracts/tikhub-downloader-api.md +134 -0
- package/skills/single-work-analysis/references/api-contracts/tikhub-user-api.md +494 -0
- package/skills/single-work-analysis/references/api-contracts/tiktok-ads-api.md +5947 -0
- package/skills/single-work-analysis/references/api-contracts/tiktok-analytics-api.md +968 -0
- package/skills/single-work-analysis/references/api-contracts/tiktok-app-v3-api.md +5735 -0
- package/skills/single-work-analysis/references/api-contracts/tiktok-creator-api.md +1951 -0
- package/skills/single-work-analysis/references/api-contracts/tiktok-interaction-api.md +742 -0
- package/skills/single-work-analysis/references/api-contracts/tiktok-shop-web-api.md +1890 -0
- package/skills/single-work-analysis/references/api-contracts/tiktok-web-api.md +4448 -0
- package/skills/single-work-analysis/references/api-contracts/toutiao-app-api.md +342 -0
- package/skills/single-work-analysis/references/api-contracts/toutiao-web-api.md +143 -0
- package/skills/single-work-analysis/references/api-contracts/twitter-web-api.md +989 -0
- package/skills/single-work-analysis/references/api-contracts/wechat-channels-api.md +809 -0
- package/skills/single-work-analysis/references/api-contracts/wechat-media-platform-web-api.md +677 -0
- package/skills/single-work-analysis/references/api-contracts/weibo-app-api.md +1547 -0
- package/skills/single-work-analysis/references/api-contracts/weibo-web-api.md +798 -0
- package/skills/single-work-analysis/references/api-contracts/weibo-web-v2-api.md +2459 -0
- package/skills/single-work-analysis/references/api-contracts/xiaohongshu-app-api.md +1291 -0
- package/skills/single-work-analysis/references/api-contracts/xiaohongshu-app-v2-api.md +1683 -0
- package/skills/single-work-analysis/references/api-contracts/xiaohongshu-web-api.md +1324 -0
- package/skills/single-work-analysis/references/api-contracts/xiaohongshu-web-v2-api.md +1209 -0
- package/skills/single-work-analysis/references/api-contracts/xigua-app-v2-api.md +489 -0
- package/skills/single-work-analysis/references/api-contracts/youtube-web-api.md +2636 -0
- package/skills/single-work-analysis/references/api-contracts/youtube-web-v2-api.md +2660 -0
- package/skills/single-work-analysis/references/api-contracts/zhihu-web-api.md +2315 -0
- package/skills/single-work-analysis/references/api-tags/asr-api.md +100 -0
- package/skills/single-work-analysis/references/api-tags/bilibili-app-api.md +482 -0
- package/skills/single-work-analysis/references/api-tags/bilibili-web-api.md +1267 -0
- package/skills/single-work-analysis/references/api-tags/demo-api.md +365 -0
- package/skills/single-work-analysis/references/api-tags/douyin-app-v3-api.md +2012 -0
- package/skills/single-work-analysis/references/api-tags/douyin-billboard-api.md +1428 -0
- package/skills/single-work-analysis/references/api-tags/douyin-creator-api.md +694 -0
- package/skills/single-work-analysis/references/api-tags/douyin-creator-v2-api.md +694 -0
- package/skills/single-work-analysis/references/api-tags/douyin-search-api.md +1059 -0
- package/skills/single-work-analysis/references/api-tags/douyin-web-api.md +3314 -0
- package/skills/single-work-analysis/references/api-tags/douyin-xingtu-api.md +935 -0
- package/skills/single-work-analysis/references/api-tags/douyin-xingtu-v2-api.md +925 -0
- package/skills/single-work-analysis/references/api-tags/health-check.md +40 -0
- package/skills/single-work-analysis/references/api-tags/hybrid-parsing.md +57 -0
- package/skills/single-work-analysis/references/api-tags/instagram-v1-api.md +1224 -0
- package/skills/single-work-analysis/references/api-tags/instagram-v2-api.md +1147 -0
- package/skills/single-work-analysis/references/api-tags/instagram-v3-api.md +1123 -0
- package/skills/single-work-analysis/references/api-tags/ios-shortcut.md +45 -0
- package/skills/single-work-analysis/references/api-tags/kuaishou-app-api.md +846 -0
- package/skills/single-work-analysis/references/api-tags/kuaishou-web-api.md +551 -0
- package/skills/single-work-analysis/references/api-tags/lemon8-app-api.md +687 -0
- package/skills/single-work-analysis/references/api-tags/linkedin-web-api.md +1105 -0
- package/skills/single-work-analysis/references/api-tags/media-ingest-api.md +112 -0
- package/skills/single-work-analysis/references/api-tags/pipixia-app-api.md +721 -0
- package/skills/single-work-analysis/references/api-tags/reddit-app-api.md +1057 -0
- package/skills/single-work-analysis/references/api-tags/sora2-api.md +737 -0
- package/skills/single-work-analysis/references/api-tags/temp-mail-api.md +136 -0
- package/skills/single-work-analysis/references/api-tags/threads-web-api.md +472 -0
- package/skills/single-work-analysis/references/api-tags/tikhub-downloader-api.md +65 -0
- package/skills/single-work-analysis/references/api-tags/tikhub-user-api.md +253 -0
- package/skills/single-work-analysis/references/api-tags/tiktok-ads-api.md +1393 -0
- package/skills/single-work-analysis/references/api-tags/tiktok-analytics-api.md +179 -0
- package/skills/single-work-analysis/references/api-tags/tiktok-app-v3-api.md +3264 -0
- package/skills/single-work-analysis/references/api-tags/tiktok-creator-api.md +709 -0
- package/skills/single-work-analysis/references/api-tags/tiktok-interaction-api.md +366 -0
- package/skills/single-work-analysis/references/api-tags/tiktok-shop-web-api.md +663 -0
- package/skills/single-work-analysis/references/api-tags/tiktok-web-api.md +2516 -0
- package/skills/single-work-analysis/references/api-tags/toutiao-app-api.md +220 -0
- package/skills/single-work-analysis/references/api-tags/toutiao-web-api.md +96 -0
- package/skills/single-work-analysis/references/api-tags/twitter-web-api.md +562 -0
- package/skills/single-work-analysis/references/api-tags/wechat-channels-api.md +405 -0
- package/skills/single-work-analysis/references/api-tags/wechat-media-platform-web-api.md +431 -0
- package/skills/single-work-analysis/references/api-tags/weibo-app-api.md +851 -0
- package/skills/single-work-analysis/references/api-tags/weibo-web-api.md +470 -0
- package/skills/single-work-analysis/references/api-tags/weibo-web-v2-api.md +1405 -0
- package/skills/single-work-analysis/references/api-tags/xiaohongshu-app-api.md +534 -0
- package/skills/single-work-analysis/references/api-tags/xiaohongshu-app-v2-api.md +934 -0
- package/skills/single-work-analysis/references/api-tags/xiaohongshu-web-api.md +757 -0
- package/skills/single-work-analysis/references/api-tags/xiaohongshu-web-v2-api.md +762 -0
- package/skills/single-work-analysis/references/api-tags/xigua-app-v2-api.md +308 -0
- package/skills/single-work-analysis/references/api-tags/youtube-web-api.md +934 -0
- package/skills/single-work-analysis/references/api-tags/youtube-web-v2-api.md +717 -0
- package/skills/single-work-analysis/references/api-tags/zhihu-web-api.md +1384 -0
- package/skills/single-work-analysis/references/asr-and-fallback.md +20 -0
- package/skills/single-work-analysis/references/config-templates/defaults.yaml +58 -0
- package/skills/single-work-analysis/references/contracts/work-card-fields.md +41 -0
- package/skills/single-work-analysis/references/platform-guides/douyin.md +47 -0
- package/skills/single-work-analysis/references/platform-guides/generic.md +43 -0
- package/skills/single-work-analysis/references/platform-guides/xiaohongshu.md +54 -0
- package/skills/single-work-analysis/references/prompt-contracts/asr-clean.md +28 -0
- package/skills/single-work-analysis/references/prompt-contracts/cta.md +24 -0
- package/skills/single-work-analysis/references/prompt-contracts/hook.md +25 -0
- package/skills/single-work-analysis/references/prompt-contracts/insight.md +47 -0
- package/skills/single-work-analysis/references/prompt-contracts/structure.md +25 -0
- package/skills/single-work-analysis/references/prompt-contracts/style.md +27 -0
- package/skills/single-work-analysis/references/prompt-contracts/summary.md +29 -0
- package/skills/single-work-analysis/references/prompt-contracts/topic.md +29 -0
- package/skills/single-work-analysis/references/schemas/work-card.schema.json +39 -0
- package/skills/single-work-analysis/references/service-guides/asr-u2-u3-fallback.md +75 -0
- package/skills/single-work-analysis/scripts/__init__.py +0 -0
- package/skills/single-work-analysis/scripts/core/__init__.py +0 -0
- package/skills/single-work-analysis/scripts/core/analysis_pipeline.py +133 -0
- package/skills/single-work-analysis/scripts/core/bootstrap_env.py +35 -0
- package/skills/single-work-analysis/scripts/core/config_loader.py +418 -0
- package/skills/single-work-analysis/scripts/core/extract_pipeline.py +173 -0
- package/skills/single-work-analysis/scripts/core/progress_report.py +111 -0
- package/skills/single-work-analysis/scripts/core/storage_router.py +253 -0
- package/skills/single-work-analysis/scripts/core/tikomni_common.py +588 -0
- package/skills/single-work-analysis/scripts/pipeline/__init__.py +0 -0
- package/skills/single-work-analysis/scripts/pipeline/asr/__init__.py +0 -0
- package/skills/single-work-analysis/scripts/pipeline/asr/asr_pipeline.py +1189 -0
- package/skills/single-work-analysis/scripts/pipeline/asr/poll_u2_task.py +95 -0
- package/skills/single-work-analysis/scripts/platform/__init__.py +0 -0
- package/skills/single-work-analysis/scripts/platform/douyin/__init__.py +0 -0
- package/skills/single-work-analysis/scripts/platform/douyin/douyin_video_type_matrix.py +224 -0
- package/skills/single-work-analysis/scripts/platform/douyin/run_douyin_single_video.py +1233 -0
- package/skills/single-work-analysis/scripts/platform/douyin/select_low_quality_video_url.py +200 -0
- package/skills/single-work-analysis/scripts/platform/xiaohongshu/__init__.py +0 -0
- package/skills/single-work-analysis/scripts/platform/xiaohongshu/run_xiaohongshu_extract.py +2156 -0
- package/skills/single-work-analysis/scripts/writers/__init__.py +0 -0
- 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 |
|