logo

Instagram 帖子详情实时采集

给出一个或多个 Instagram 帖子 shortcode,实时采集帖子详情

概览

Instagram 帖子详情实时采集面向历史库尚未收录、需要重新观察当前公开状态的帖子。它把分散在帖子页面和账号页面的信息整理成逐帖记录,正文、媒体、互动表现与发布账号资料可以放在同一张数据表里比较。

这份数据适合作为内容复盘、创作者观察和传播表现分析的基础材料。相比手工打开帖子逐项摘录,它能够用统一字段保留每次采集的结果,让不同帖子之间更容易横向对照,也便于后续留存快照。

数据说明

数据来自采集时公开可访问的 Instagram 帖子及发布账号页面,每条记录按内容标识去重。点赞数、评论数和账号资料反映采集当时可见的页面状态,采集时间用于区分不同批次;发布时间和内容更新时间沿用数据源给出的时间值,不额外换算时区。图片地址、视频地址和音频地址可能在同一文本中包含多项,话题标签与提及账号同样以列表文本保存。私有、已删除或当时无法公开访问的内容可能无法形成完整记录。

结果长什么样

每条记录代表一个 Instagram 帖子,并带有内容、媒体、互动和发布账号信息:

帖子短码帖子地址媒体类型点赞数
DYvgdDPpBHThttps://www.instagram.com/p/DYvgdDPpBHTVideo169
BohGHnXnFQjhttps://www.instagram.com/p/BohGHnXnFQjImage2078559

另有帖子正文、帖子地址、采集时间、图片地址、视频地址、评论数和话题标签等字段。

应用场景

  • 做内容表现复盘时,对照「媒体类型」「点赞数」「评论数」,观察图片、视频等形态的互动差异。
  • 做选题与文案分析时,结合「帖子正文」「话题标签」「发布时间」,归纳高互动内容的主题、表达方式和发布节奏。
  • 做创作者观察时,使用「账号名称」「账号主页」「内容标识」汇总同一账号的帖子,建立可持续更新的内容样本库。

适用边界

一次调用至少提交 1 个 Instagram 帖子 shortcode,提交内容受 1 MB 请求体限制;每页最多整理 1000 条,平台最多汇总约 10 万条;仅返回已配置的公开字段。

  • 适合用于
  • 历史库没有目标帖子,需要实时采集帖子详情时
  • 需要获取一个或多个 Instagram 帖子的正文、媒体和互动数据时
  • 需要补充帖子发布账号的公开信息时
  • 不要用于
  • 历史库已有目标帖子且希望快速返回时——请使用 Instagram 帖子详情历史查询 App
  • 需要私有帖子或未配置字段时——本 App 只返回已配置的公开字段
  • 必须马上拿到结果时——实时采集需要后台处理

失败处理

作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1鉴权或授权失败不是重试问题,应先让管理员检查数据服务权限
  2. 2等待超时后先查看原任务状态,再决定是否重新运行,避免重复提交
  3. 3临时限流或服务不可用可稍后重试;任务失败或过期后可以重新运行

输入参数

调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。

字段名业务名称类型必填默认值枚举 / 约束示例说明
items帖子 shortcode 清单array<object>[{"kw":"DYvgdDPpBHT"}]要实时采集的 Instagram 帖子 shortcode 列表,每项填写一个 shortcode,至少填写 1 项。

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

字段名业务名称类型示例说明
content_id内容标识string帖子内容唯一标识,可能为空。
content_sec_id帖子短码stringInstagram 帖子 shortcode,可能为空。
content_url帖子地址string帖子公开地址,可能为空。
content_text帖子正文string帖子正文,可能为空。
publish_time发布时间string帖子发布时间,可能为空。
crawl_time采集时间string帖子详情采集时间,可能为空。
ct_update内容更新时间string帖子内容更新时间,可能为空。
media_type媒体类型string帖子媒体类型,可能为空。
image_urls图片地址string帖子图片地址列表文本,可能为空。
video_urls视频地址string帖子视频地址列表文本,可能为空。
audio_urls音频地址string帖子音频地址列表文本,可能为空。
like_count点赞数string帖子点赞数量文本,可能为空。
comment_count评论数string帖子评论数量文本,可能为空。
account_id账号标识string发布账号公开标识,可能为空。
account_name账号名称string发布账号名称,可能为空。
full_name账号全名string发布账号完整名称,可能为空。
profile_url账号主页string发布账号主页地址,可能为空。
hashtags话题标签string帖子话题标签列表文本,可能为空。
mentions提及账号string帖子提及账号列表文本,可能为空。
product_type展示类型string帖子产品或展示类型,可能为空。

记录 Schema

输出按记录逐条返回。记录主键为 content_id,去重、增量、关联以它为准。

output.schema
{
  "type": "object",
  "properties": {
    "content_id": {
      "type": "string",
      "title": "内容标识",
      "description": "帖子内容唯一标识,可能为空。"
    },
    "content_sec_id": {
      "type": "string",
      "title": "帖子短码",
      "description": "Instagram 帖子 shortcode,可能为空。"
    },
    "content_url": {
      "type": "string",
      "title": "帖子地址",
      "description": "帖子公开地址,可能为空。"
    },
    "content_text": {
      "type": "string",
      "title": "帖子正文",
      "description": "帖子正文,可能为空。"
    },
    "publish_time": {
      "type": "string",
      "title": "发布时间",
      "description": "帖子发布时间,可能为空。"
    },
    "crawl_time": {
      "type": "string",
      "title": "采集时间",
      "description": "帖子详情采集时间,可能为空。"
    },
    "ct_update": {
      "type": "string",
      "title": "内容更新时间",
      "description": "帖子内容更新时间,可能为空。"
    },
    "media_type": {
      "type": "string",
      "title": "媒体类型",
      "description": "帖子媒体类型,可能为空。"
    },
    "image_urls": {
      "type": "string",
      "title": "图片地址",
      "description": "帖子图片地址列表文本,可能为空。"
    },
    "video_urls": {
      "type": "string",
      "title": "视频地址",
      "description": "帖子视频地址列表文本,可能为空。"
    },
    "audio_urls": {
      "type": "string",
      "title": "音频地址",
      "description": "帖子音频地址列表文本,可能为空。"
    },
    "like_count": {
      "type": "string",
      "title": "点赞数",
      "description": "帖子点赞数量文本,可能为空。"
    },
    "comment_count": {
      "type": "string",
      "title": "评论数",
      "description": "帖子评论数量文本,可能为空。"
    },
    "account_id": {
      "type": "string",
      "title": "账号标识",
      "description": "发布账号公开标识,可能为空。"
    },
    "account_name": {
      "type": "string",
      "title": "账号名称",
      "description": "发布账号名称,可能为空。"
    },
    "full_name": {
      "type": "string",
      "title": "账号全名",
      "description": "发布账号完整名称,可能为空。"
    },
    "profile_url": {
      "type": "string",
      "title": "账号主页",
      "description": "发布账号主页地址,可能为空。"
    },
    "hashtags": {
      "type": "string",
      "title": "话题标签",
      "description": "帖子话题标签列表文本,可能为空。"
    },
    "mentions": {
      "type": "string",
      "title": "提及账号",
      "description": "帖子提及账号列表文本,可能为空。"
    },
    "product_type": {
      "type": "string",
      "title": "展示类型",
      "description": "帖子产品或展示类型,可能为空。"
    }
  },
  "required": [],
  "additionalProperties": false
}

调用方式

本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。

通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。

客户端配置

把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。

mcpServers 配置
{
  "mcpServers": {
    "rookieyao__instagram-detail": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=rookieyao/instagram-detail",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。

如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。

价格

提交一次 Instagram 帖子详情实时采集任务

每提交一次任务计费一次,与返回条数无关。

¥0.001/
返回一条 Instagram 帖子详情记录

按实际成功返回的数据条数计费,任务失败不计费。

¥0.006/

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
请先填写必填参数
¥0.006 / 条起