概览
Instagram 帖子详情历史查询用于从已有数据中找回指定帖子过去留存的公开资料。输入已知的帖子 shortcode 后,可以得到正文、媒体、互动数量和发布账号信息,适合在不重新采集页面的情况下补齐研究底表。
历史记录保留了采集发生时的页面状态,因此更适合资料归档、旧内容复盘和跨帖子比较。它把内容信息、互动表现与账号资料放在同一条记录中,减少在多个来源之间反复核对的工作。
数据说明
数据来自历史库中已经收录的 Instagram 帖子详情,并按内容标识去重;没有被历史库收录的帖子不会产生记录。点赞数、评论数、浏览数、播放数和认证状态都是对应采集时刻的历史快照,不代表帖子当前状态,采集时间可用于判断记录的新旧。图片地址和视频地址可能在同一文本中包含多项,话题标签与提及账号以列表文本保存。数据只覆盖当时能够公开获取并成功留存的帖子和账号字段。
结果长什么样
每条记录代表一个历史库中命中的 Instagram 帖子:
| 帖子短码 | 账号名称 | 媒体类型 | 点赞数 | 采集时间 |
|---|---|---|---|---|
| DcOu1AfKTuG | binaofficial | Video | 3 | 2026-08-20T10:04:37 |
| BohGHnXnFQj | taylorswift | Image | 2078559 | 2026-08-19T18:36:44 |
另有帖子正文、帖子地址、发布时间、评论数、浏览数、播放数、账号主页和认证状态等字段。
应用场景
- 做旧内容复盘时,结合「帖子正文」「发布时间」「点赞数」「评论数」,比较不同选题在历史采集时的互动表现。
- 做媒体形态分析时,按「媒体类型」分组,再对照「浏览数」「播放数」,观察图片、轮播和视频内容的表现差异。
- 做账号资料归档时,使用「账号名称」「账号主页」「是否认证」整理发布主体,并用「采集时间」标记资料快照的形成时间。
适用边界
单次最多查询 100 个 Instagram 帖子 shortcode;只查询历史库已有记录,不触发实时采集;最多返回 100 条匹配记录。
- 适合用于
- 需要快速查询历史库中已有的 Instagram 帖子详情时
- 已经知道帖子 shortcode,希望补充正文、互动和账号公开信息时
- 不要用于
- 需要现场重新采集最新帖子详情时——请使用 Instagram 帖子详情实时采集 App
- 需要按账号、关键词或时间范围搜索帖子时——本 App 只按 shortcode 精确匹配
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1鉴权或授权失败时联系管理员检查数据服务权限
- 2返回空结果通常表示历史库中没有匹配记录,可改用实时采集 App
- 3临时限流或服务不可用时可稍后原样重试
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| shortcodes | 帖子 shortcode 清单 | array<string> | 是 | — | 最多 100 项 | ["DcOu1AfKTuG"] | 要从历史库查询的 Instagram 帖子 shortcode 列表,通常是帖子地址末尾的标识,最多 100 个。 |
| pageIndex | pageIndex | integer | 是 | — | 1–100 | 1 | 分页的页数,最多获取100页的数据 |
| pageSize | pageSize | integer | 是 | — | 1–100 | 100 | 分页每页条数,每页最多100条数据 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| content_id | 内容标识 | string | — | 帖子内容唯一标识,可能为空。 |
| short_code | 帖子短码 | string | — | Instagram 帖子 shortcode,可能为空。 |
| content_url | 帖子地址 | string | — | 帖子公开地址,可能为空。 |
| content_text | 帖子正文 | string | — | 帖子正文,可能为空。 |
| publish_time | 发布时间 | string | — | 帖子发布时间,可能为空。 |
| crawl_time | 采集时间 | string | — | 帖子详情采集时间,可能为空。 |
| media_type | 媒体类型 | string | — | 帖子媒体类型,可能为空。 |
| image_urls | 图片地址 | string | — | 帖子图片地址列表文本,可能为空。 |
| video_urls | 视频地址 | string | — | 帖子视频地址列表文本,可能为空。 |
| like_count | 点赞数 | string | — | 帖子点赞数量文本,可能为空。 |
| comment_count | 评论数 | string | — | 帖子评论数量文本,可能为空。 |
| view_count | 浏览数 | string | — | 帖子浏览数量文本,可能为空。 |
| play_count | 播放数 | string | — | 帖子播放数量文本,可能为空。 |
| account_id | 账号标识 | string | — | 发布账号公开标识,可能为空。 |
| account_name | 账号名称 | string | — | 发布账号名称,可能为空。 |
| full_name | 账号全名 | string | — | 发布账号完整名称,可能为空。 |
| profile_url | 账号主页 | string | — | 发布账号主页地址,可能为空。 |
| is_verified | 是否认证 | boolean | — | 发布账号是否认证,可能为空。 |
| hashtags | 话题标签 | string | — | 帖子话题标签列表文本,可能为空。 |
| mentions | 提及账号 | string | — | 帖子提及账号列表文本,可能为空。 |
记录 Schema
输出按记录逐条返回。记录主键为 content_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"content_id": {
"type": "string",
"title": "内容标识",
"description": "帖子内容唯一标识,可能为空。"
},
"short_code": {
"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": "帖子详情采集时间,可能为空。"
},
"media_type": {
"type": "string",
"title": "媒体类型",
"description": "帖子媒体类型,可能为空。"
},
"image_urls": {
"type": "string",
"title": "图片地址",
"description": "帖子图片地址列表文本,可能为空。"
},
"video_urls": {
"type": "string",
"title": "视频地址",
"description": "帖子视频地址列表文本,可能为空。"
},
"like_count": {
"type": "string",
"title": "点赞数",
"description": "帖子点赞数量文本,可能为空。"
},
"comment_count": {
"type": "string",
"title": "评论数",
"description": "帖子评论数量文本,可能为空。"
},
"view_count": {
"type": "string",
"title": "浏览数",
"description": "帖子浏览数量文本,可能为空。"
},
"play_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": "发布账号主页地址,可能为空。"
},
"is_verified": {
"type": "boolean",
"title": "是否认证",
"description": "发布账号是否认证,可能为空。"
},
"hashtags": {
"type": "string",
"title": "话题标签",
"description": "帖子话题标签列表文本,可能为空。"
},
"mentions": {
"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": {
"rookieyao__instagram-detail-history": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=rookieyao/instagram-detail-history",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。