Instagram 公开数据 API
通过统一异步流程查询已知 username 或发现公开主页，并采集粉丝列表记录、关注关系、账号发布的帖子、标记主页的帖子、hashtag 结果、Reels、字幕文本、评论、账号计数、互动指标和媒体元数据。
可用的 Instagram API
根据需求选择已知主页查询、主页发现、粉丝列表采集、关注关系采集、账号计数、账号发布的帖子、标记主页的帖子、hashtag 发现、Reels、字幕文本或评论接口。所有接口使用相同的 SocQ 鉴权和任务结果流程。
instagram/posts
帖子每条结果 0.34 积分
instagram/post-info
帖子每条结果 0.5 积分
instagram/hashtag-posts
搜索每条结果 0.5 积分
instagram/reels-search
搜索每条结果 0.5 积分
instagram/story-highlights
帖子每条结果 0.5 积分
instagram/tagged-posts
帖子每条结果 0.5 积分
instagram/transcript
帖子每条结果 0.7 积分
instagram/audio-reels
帖子每条结果 0.5 积分
instagram/comments
评论每条结果 0.3 积分
instagram/followers-count
主页每条结果 0.52 积分
instagram/profiles
主页每条结果 0.6 积分
instagram/followers-list
主页每条结果 0.3 积分
instagram/following-list
主页每条结果 0.3 积分
instagram/reels
帖子每条结果 0.52 积分
instagram/search
搜索每条结果 0.54 积分
instagram/highlight-items
帖子每条结果 0.5 积分
instagram/trending-reels
帖子每条结果 0.5 积分
可以获取哪些 Instagram 数据？
SocQ 将公开 Instagram 结果整理成稳定的 JSON 记录，产品团队无需分别维护浏览器自动化和响应清洗流程。
主页与发现
查询已知 username 或搜索公开账号，返回 username、显示名称、bio、主页 URL、头像、验证状态和可见账号信号。
粉丝与账号计数
按公开 username 或主页 URL 获取可见粉丝数、关注数和帖子数。
公开粉丝列表记录
按来源 username 采集可见粉丝资料，返回标准化身份、头像、可见性标记、关系上下文、观测位置和采集时间。
公开关注关系
采集一个或多个来源账号公开可见的已关注主页，返回身份、可见性、来源、关系、位置和可用账号计数上下文。
账号发布与标记主页的帖子
采集指定 username 发布的帖子或标记指定主页的帖子，返回 caption、作者、媒体、标记上下文、时间和可见互动。
Hashtag 帖子发现
按一个或多个 hashtag 发现公开帖子，可选时间范围和 Reels 筛选，并保留匹配的来源 hashtag。
公开 Reels
在字段可用时采集 Reel caption、媒体引用、播放与互动计数、时长、hashtag、mention 和音频信息。
Post 与 Reel 字幕
从公开 Post 或 Reel URL 提取字幕文本、语言、格式和来源信息；没有语音的媒体可能不返回记录。
公开评论
按公开 Instagram Post URL 采集评论文本、作者字段、时间、Post 引用和可见点赞或回复计数。
SocQ 与 Instagram Graph API 对比
两者解决不同的集成问题：SocQ 面向标准化公开数据采集；Meta 官方 API 主要面向已授权专业账号和平台操作。
| 能力 | SocQ | Instagram Graph API |
|---|---|---|
| 主要用途 | 采集公开主页、粉丝列表、关注关系、内容和评论数据 | 管理已授权的 Business 和 Creator 账号 |
| 用户 OAuth | 使用 SocQ API key，无需用户 Instagram OAuth | 需要 Meta 应用配置和账号授权 |
| 发布内容 | 不支持 | 符合条件的专业账号可用 |
| 私密内容 | 不支持 | 仅限授权权限允许的数据 |
| 响应格式 | 在 SocQ 接口间保持标准化 | Meta Graph 原生响应结构 |
Instagram API 如何工作
全部 Instagram 接口使用相同的异步流程，避免长时间采集占用业务请求线程。
1. 提交任务
通过 POST 传入搜索词、username、hashtag、公开主页或内容 URL，并可指定 results_limit。
2. 轮询任务状态
使用返回的 task ID 等待 succeeded 或 failed，并使用 backoff 避免高频轮询。
3. 读取标准化结果
获取结果记录、保存稳定 ID，并在有更多数据时继续传 next_cursor。
使用 SocQ API key 鉴权。以下示例启动公开 Instagram 主页搜索；已知主页查询、粉丝列表、关注关系、账号发布或标记主页的帖子、hashtag 发现、Reels、字幕、评论和账号计数接口使用相同任务流程。
curl -X POST "https://api.socq.ai/v1/instagram/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"sustainable travel","results_limit":25}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 GET /v1/tasks/{task_id}?limit=50常见 Instagram API 使用场景
达人发现
发现相关公开主页，再用帖子、Reels 和可见粉丝指标补全选中的账号。
粉丝列表研究
抽样公开可见粉丝资料，比较选定来源账号间的重合，并把筛选出的 username 加入资料补全队列。
内容监控
跟踪活动、竞品、达人或固定内容形式相关的账号发布帖子、标记主页的帖子、hashtag 结果、Reels、字幕记录和选定公开评论。
分析数据补全
为内部仪表盘、数据仓库和报表系统补充公开社媒身份与互动字段。
研究目录
使用稳定 URL、ID 和采集时间构建可审核的公开账号与内容数据集。
限制与公开数据政策
SocQ 的范围限定在公开可用的 Instagram 结果，账号、内容和公开数据源发生变化时，字段可用性也可能变化。
- 不支持私密、受限、已删除或登录后才可见的内容。
- 粉丝列表结果是公开样本，不保证完整导出；同一资料也可能出现在多个提交的来源账号下。
- 部分公开记录可能缺少计数、评论字段、媒体引用、bio 或音频字段。
- 建议使用保守请求频率、cursor 分页，并在遇到限速时进行 backoff。
- 这些接口不用于发布、编辑或删除 Instagram 内容。
Instagram API 常见问题
这是 Instagram 官方 Graph API 吗？
不是。SocQ 提供对受支持公开 Instagram 结果的标准化访问。需要授权账号管理或发布内容时，应使用 Meta Graph API。
用户需要连接 Instagram 账号吗？
受支持的公开数据接口不需要用户进行 Instagram OAuth，调用请求使用 SocQ API key。
可以访问私密主页吗？
不可以。私密、受限和登录后才可见的 Instagram 内容不在支持范围内。
如何计费？
每个接口卡片都会显示当前每条结果的积分价格，任务按照返回的标准化结果记录计费。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
TikTok API
通过统一异步流程采集受支持的 TikTok 公开资料、直接视频元数据、顶级评论、视频搜索结果和指定标签下的视频。
YouTube API
通过统一异步流程采集受支持的公开 YouTube 频道资料、视频详情、频道视频、评论、Shorts、关键词与话题标签结果和可用字幕。
X API
获取公开账号、关注者与关注列表、帖子、回复、引用帖、转发用户、搜索结果和当前趋势，用于研究和监测。
Facebook API
采集公开 Facebook Page、帖子、群组帖子、评论、关键词匹配活动和可用视频字幕，获得标准化身份、内容、来源、格式、地点、媒体、reaction、出席和互动字段。
Google Ad Library API
发现公开广告主、采集公司的创意，或通过 URL 获取一条已知 Transparency Center 创意，用于研究和审阅。
Google Maps API
发现公开地点、按已知 Maps URL 获取标准化详情，并采集带来源地点与作者上下文的公开评价。