{
  "spec_version": "0.2",
  "namespace": "rookieyao",
  "app_name": "instagram-post-ids",
  "app_id": "app_0e3aa0134ee4",
  "status": "published",
  "open_to": "public",
  "accepting_runs": true,
  "source_locale": "zh-CN",
  "identity": {
    "app_name": "instagram-post-ids",
    "name": "Instagram 账号帖子 ID 列表采集",
    "summary": "给出 Instagram 账号 ID、采集数量和可选最早发布时间，返回该账号的帖子 ID 清单",
    "type": "data",
    "version": "0.1.2"
  },
  "discovery": {
    "capability": "data-acquisition",
    "keywords": [
      "Instagram",
      "帖子 ID",
      "账号帖子",
      "shortcode",
      "内容清单"
    ],
    "boundary": "一次处理一个 Instagram 数字账号 ID，采集数量最多 100000 条；仅覆盖可公开采集的帖子。"
  },
  "input": {
    "schema": {
      "type": "object",
      "properties": {
        "account_id": {
          "type": "string",
          "title": "Instagram 账号 ID",
          "description": "要采集帖子列表的 Instagram 数字账号 ID，不能填写账号昵称。",
          "pattern": "^[0-9]{1,512}$",
          "prefill": "31489157"
        },
        "crawl_num": {
          "type": "integer",
          "title": "采集数量",
          "description": "希望采集的帖子数量，范围为 1 至 100000；数量越大，耗时和费用可能越高。",
          "minimum": 1,
          "maximum": 100000,
          "prefill": 1
        },
        "time_limit": {
          "type": "string",
          "title": "最早发布时间",
          "description": "只采集发布时间不早于该时刻的帖子，填写 13 位 Unix 毫秒时间戳；不填则不限制最早发布时间。",
          "pattern": "^[0-9]{13}$"
        }
      },
      "required": [
        "account_id",
        "crawl_num"
      ],
      "additionalProperties": false
    }
  },
  "output": {
    "id_field": "content_id",
    "schema": {
      "type": "object",
      "properties": {
        "content_id": {
          "type": "string",
          "title": "帖子 ID",
          "description": "Instagram 帖子的唯一内容标识；无可采集内容时可能为空。"
        },
        "content_shortcode": {
          "type": "string",
          "title": "帖子短码",
          "description": "Instagram 帖子的公开 shortcode；无可采集内容时可能为空。"
        },
        "crawl_time": {
          "type": "string",
          "title": "采集时间",
          "description": "本条帖子索引被采集的时间；无可采集内容时可能为空。"
        },
        "keyword": {
          "type": "string",
          "title": "账号 ID",
          "description": "触发本条采集的 Instagram 账号 ID；无可采集内容时可能为空。"
        },
        "keyword_type": {
          "type": "string",
          "title": "目标类型",
          "description": "采集目标的类型，本 App 通常返回 account；无可采集内容时可能为空。"
        },
        "publish_content_count": {
          "type": "string",
          "title": "账号内容数",
          "description": "账号公开内容总数的文本值；无可采集内容时可能为空。"
        },
        "publish_time": {
          "type": "string",
          "title": "发布时间",
          "description": "帖子公开发布的时间；无可采集内容时可能为空。"
        },
        "task_item": {
          "type": "string",
          "title": "任务目标",
          "description": "本条记录所属任务的 Instagram 账号 ID。"
        },
        "no_data": {
          "type": "boolean",
          "title": "无数据标记",
          "description": "该任务目标是否没有可返回的帖子记录。"
        }
      },
      "required": [],
      "additionalProperties": false
    }
  },
  "execution": {
    "mode": "async",
    "timeout_seconds": 1860,
    "cancel_notify": false,
    "recovers_partial_on_cancel": false
  },
  "knowledge": {
    "when_to_use": [
      "需要获取一个 Instagram 账号的帖子 ID、shortcode 和发布时间清单时",
      "需要建立账号内容索引或分析历史发帖节奏时"
    ],
    "when_not_to_use": [
      "需要帖子正文、图片、视频或互动数据时，应使用帖子详情类数据能力",
      "需要一次处理多个账号时，应为每个账号分别运行",
      "需要私有账号或已删除内容时，本 App 只覆盖可公开采集的帖子"
    ],
    "failure_handling": [
      "返回空列表时先核对账号 ID、公开可见性和最早发布时间限制，再决定是否重试",
      "鉴权或授权失败不可通过重复提交解决，应先检查执行环境中的凭证和权限",
      "临时限流或服务不可用可稍后重试；任务失败或过期后可重新运行"
    ]
  },
  "pricing": {
    "events": [
      {
        "event": "start",
        "label": "提交一次 Instagram 账号帖子 ID 列表采集任务",
        "unit_price": 0.001,
        "qty_from": "",
        "unit_size": null
      },
      {
        "event": "record",
        "label": "返回一条 Instagram 帖子 ID 记录",
        "unit_price": 0.02,
        "qty_from": "",
        "unit_size": 12
      }
    ]
  },
  "examples": [
    {
      "id": "basic",
      "goal": "采集一个 Instagram 账号的帖子 ID 列表",
      "input": {
        "account_id": "31489157",
        "crawl_num": 1
      },
      "use_as_test": true
    }
  ],
  "published_at": "2026-09-03T07:48:05.255742+00:00",
  "publisher": {
    "id": "rookieyao",
    "name": "rookieyao"
  },
  "maintainers": [
    {
      "id": "rookieyao",
      "name": "rookieyao"
    }
  ],
  "trust_tier": "community",
  "readme": "盘点一个 Instagram 账号发布过哪些内容，通常从帖子 ID 与 shortcode 开始。这份数据会把指定账号下可公开采集的帖子整理成清单，并附上发布时间、采集时间和账号内容数。\n\n相较于手工翻看账号主页，这份清单更适合历史盘点、内容归档和周期比对。帖子 ID 可识别同一条内容，shortcode 便于关联公开帖子，时间信息则能支撑发布节奏判断。\n\n## 数据说明\n\n清单来自指定 Instagram 账号可公开采集的帖子列表，同一个帖子 ID 只保留一条。发布时间表示对外发布时间，采集时间表示索引获取时间；账号内容数是采集时返回的公开内容总数文本。无数据标记用于区分“账号没有可返回内容”和普通记录。私有账号、已删除帖子以及当时不可公开访问的内容可能不在结果中。\n\n## 结果长什么样\n\n每条普通记录代表一个 Instagram 帖子索引：\n\n| 帖子 ID | 帖子短码 | 发布时间 | 账号 ID | 无数据标记 |\n|---|---|---|---|---|\n| 1894814149847137149 | BpLu24dBbt9 | 2018-10-21T13:24:30 | 31489157 | 否 |\n| 2111943669967708192 | B1PIZQKD2Ag | 2019-08-17T03:22:06 | 31489157 | 否 |\n\n另有采集时间、目标类型、账号内容数和任务目标等信息。\n\n## 应用场景\n\n- 建立内容索引时，用「帖子 ID」作为主键，以「帖子短码」关联公开内容，减少重复归档。\n- 分析发布节奏时，按「发布时间」聚合发帖数量，观察账号活跃周期。\n- 检查覆盖时，对照「账号内容数」与返回量，并结合「无数据标记」识别没有可采集内容的目标。\n- 做周期盘点时，比对两次结果的「帖子 ID」，再用「采集时间」确认获取时点。\n",
  "favorite_count": 0,
  "labels": {
    "industry": [
      {
        "slug": "social_media",
        "label": "社交媒体"
      }
    ],
    "platform": [
      {
        "slug": "instagram",
        "label": "Instagram"
      }
    ],
    "content": [
      {
        "slug": "engagement",
        "label": "互动数据"
      }
    ]
  },
  "display_locale": "zh-CN",
  "translation_origin": null,
  "version": "0.1.2"
}