logo

Instagram 粉丝列表历史查询

给出一个 Instagram 账号 ID,返回历史库中匹配的粉丝账号明细

概览

这个 App 整理指定 Instagram 账号已收录的粉丝关系,返回粉丝账号 ID、用户名、展示名称、头像、账号状态和采集时间。它不会重新采集。

历史明细保留采集时间和记录 ID,适合追溯来源、核对批次并构建长期观察底表,也便于筛选、分组和跨时间比较。

数据说明

数据来自已保存的 Instagram 粉丝关系明细,并按采集时间从早到晚返回。记录以记录 ID 区分,不按粉丝账号跨批次合并,因此同一粉丝可能保留多条记录。展示名、头像、私密状态与认证状态是采集时保存的值,不代表当前状态。结果只覆盖已收录的数据,尚未采集、已被清理或当时未能取得的资料不会出现,部分账号资料可能为空。

结果长什么样

每条记录代表某次采集保存的一条粉丝关系:

记录 ID目标账号 ID粉丝账号 ID粉丝用户名是否私密采集时间
6a6868b1dd3d02672d5fa594206770137137916608506eolioenne2026-07-28T12:23:17
6a740679ab02c6134f5d9d3b2067701371348326859245nestuitive2026-08-06T11:58:47

结果中另有展示名、头像、认证状态和关系类型等信息。

应用场景

  • 核对历史批次时,按「采集时间」分组并用「记录 ID」定位明细,判断各批次保存了哪些粉丝关系。
  • 做受众样本整理时,以「粉丝账号 ID」统计独立账号,再结合「粉丝用户名」「是否私密」观察样本构成。
  • 做关系变化分析时,锁定「目标账号 ID」,比较不同「采集时间」的「粉丝账号 ID」,识别新增或持续出现的样本。

适用边界

一次查询一个 Instagram 数字账号 ID,只读取历史库已有的粉丝明细;最多汇总 10 万条记录。

  • 适合用于
  • 需要快速查询历史库中已有的 Instagram 粉丝列表时
  • 需要整理粉丝账号 ID、用户名、头像和认证状态时
  • 需要根据采集时间复核历史粉丝关系时
  • 不要用于
  • 需要现场重新采集最新粉丝列表时——请使用 Instagram 粉丝列表实时采集 App
  • 只知道 Instagram 用户名或主页地址时——本 App 要求准确的账号 ID
  • 需要历史库未收录的资料时——本 App 只返回已有历史记录

失败处理

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

  1. 1鉴权或授权失败时联系管理员检查 Instagram 数据服务权限
  2. 2返回空结果通常表示账号 ID 错误或历史库尚未收录,可改用实时采集 App
  3. 3临时限流、服务不可用或超时时可稍后原样重试

输入参数

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

字段名业务名称类型必填默认值枚举 / 约束示例说明
account_idInstagram 账号 IDstring20677013713填写要查询粉丝列表的 Instagram 数字账号 ID,不要填写用户名、@ 符号或主页地址。
pageIndexpageIndexinteger1–1001历史数据分页获取的页码值,最多获取100页数据,
pageSizepageSizeinteger1–1001历史数据分页获取每页的数据条数,每页最多获取100条数据,

输出数据

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

字段名业务名称类型示例说明
cur_id记录 IDstring本条历史粉丝关系记录的唯一标识,可能为空。
account_id目标账号 IDstring被查询的 Instagram 账号 ID,可能为空。
biz_id业务标识string本条数据关联的业务标识,可能为空。
keyword采集关键词string触发本条记录的 Instagram 账号 ID,可能为空。
fan_account_id粉丝账号 IDstring粉丝账号的 Instagram 唯一标识,可能为空。
fan_account_name粉丝展示名string粉丝账号公开展示的名称,可能为空。
fan_username粉丝用户名string粉丝账号的 Instagram 用户名,可能为空。
fan_avatar_url粉丝头像string粉丝账号的公开头像地址,可能为空。
is_private是否私密boolean粉丝账号是否为私密账号,未判断时可能为空。
is_verified是否认证boolean粉丝账号是否为认证账号,未判断时可能为空。
relation_type关系类型string账号关系类型,例如粉丝关系,可能为空。
crawl_time采集时间string本条粉丝关系的采集时间,可能为空。

记录 Schema

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

output.schema
{
  "type": "object",
  "properties": {
    "cur_id": {
      "type": "string",
      "title": "记录 ID",
      "description": "本条历史粉丝关系记录的唯一标识,可能为空。"
    },
    "account_id": {
      "type": "string",
      "title": "目标账号 ID",
      "description": "被查询的 Instagram 账号 ID,可能为空。"
    },
    "biz_id": {
      "type": "string",
      "title": "业务标识",
      "description": "本条数据关联的业务标识,可能为空。"
    },
    "keyword": {
      "type": "string",
      "title": "采集关键词",
      "description": "触发本条记录的 Instagram 账号 ID,可能为空。"
    },
    "fan_account_id": {
      "type": "string",
      "title": "粉丝账号 ID",
      "description": "粉丝账号的 Instagram 唯一标识,可能为空。"
    },
    "fan_account_name": {
      "type": "string",
      "title": "粉丝展示名",
      "description": "粉丝账号公开展示的名称,可能为空。"
    },
    "fan_username": {
      "type": "string",
      "title": "粉丝用户名",
      "description": "粉丝账号的 Instagram 用户名,可能为空。"
    },
    "fan_avatar_url": {
      "type": "string",
      "title": "粉丝头像",
      "description": "粉丝账号的公开头像地址,可能为空。"
    },
    "is_private": {
      "type": "boolean",
      "title": "是否私密",
      "description": "粉丝账号是否为私密账号,未判断时可能为空。"
    },
    "is_verified": {
      "type": "boolean",
      "title": "是否认证",
      "description": "粉丝账号是否为认证账号,未判断时可能为空。"
    },
    "relation_type": {
      "type": "string",
      "title": "关系类型",
      "description": "账号关系类型,例如粉丝关系,可能为空。"
    },
    "crawl_time": {
      "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-fans-history": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=rookieyao/instagram-fans-history",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

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

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

价格

返回一条 Instagram 历史粉丝关系记录

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

¥0.001/

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

立即体验

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

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