{
  "spec_version": "0.2",
  "namespace": "SpiderKing999",
  "app_name": "twitter-account-posts",
  "app_id": "app_13115a42b5e1",
  "status": "published",
  "open_to": "public",
  "accepting_runs": true,
  "source_locale": "zh-CN",
  "identity": {
    "app_name": "twitter-account-posts",
    "name": "Twitter 账号帖子列表采集",
    "summary": "给一个 Twitter 账号编号，返回该账号下已发布帖子的编号与发布时间清单",
    "type": "data",
    "version": "0.1.2"
  },
  "discovery": {
    "capability": "data-acquisition",
    "keywords": [
      "Twitter",
      "X",
      "帖子",
      "推文",
      "时间线"
    ],
    "boundary": "单次仅支持一个账号编号；帖子条数由「最多采集条数」控制，默认 100 条、上限 1000 条。"
  },
  "input": {
    "schema": {
      "type": "object",
      "properties": {
        "account_id": {
          "type": "string",
          "title": "账号编号",
          "description": "要采集帖子列表的 Twitter 账号编号（纯数字 account ID），可从账号信息采集结果中的「账号编号」字段获取",
          "pattern": "^[0-9]{10,25}$",
          "prefill": "1611637588921815040"
        },
        "max_posts": {
          "type": "integer",
          "title": "最多采集条数",
          "description": "本次任务最多采集多少条帖子，不填默认 100 条；值越大耗时和费用越高",
          "default": 100,
          "minimum": 1,
          "maximum": 1000
        }
      },
      "required": [
        "account_id"
      ],
      "additionalProperties": false
    }
  },
  "output": {
    "id_field": "content_id",
    "schema": {
      "type": "object",
      "properties": {
        "content_id": {
          "type": "string",
          "title": "帖子编号",
          "description": "帖子在平台内的唯一编号"
        },
        "publish_time": {
          "type": "string",
          "title": "发布时间",
          "description": "帖子公开发布时间"
        },
        "crawl_time": {
          "type": "string",
          "title": "采集时间",
          "description": "本条结果被采集的时间"
        },
        "clean_update_time": {
          "type": "string",
          "title": "更新时间",
          "description": "结果最近清洗落库的时间"
        },
        "keyword_type": {
          "type": "string",
          "title": "关联类型",
          "description": "结果与提交参数的关联类型标识"
        },
        "related_id": {
          "type": "string",
          "title": "关联编号",
          "description": "结果关联的账号或检索标识"
        },
        "biz_id": {
          "type": "string",
          "title": "业务标识",
          "description": "该结果对应的业务对象标识"
        },
        "submitted_account_id": {
          "type": "string",
          "title": "提交账号编号",
          "description": "本次任务提交时填写的账号编号"
        },
        "no_data": {
          "type": "boolean",
          "title": "无数据",
          "description": "该账号是否未采集到有效帖子"
        }
      },
      "required": [],
      "additionalProperties": false
    }
  },
  "execution": {
    "mode": "async",
    "timeout_seconds": 2100,
    "cancel_notify": false,
    "recovers_partial_on_cancel": false
  },
  "knowledge": {
    "when_to_use": [
      "需要获取某个 Twitter 账号已发布帖子的编号与时间线清单时",
      "已有账号编号，想批量拿到帖子 ID 再交给详情类 App 深挖时"
    ],
    "when_not_to_use": [
      "只有用户名、还没有账号编号时——先用账号信息采集类 App 获取编号",
      "需要帖子正文、互动数等完整详情时——本 App 只返回帖子编号与时间等列表字段"
    ],
    "failure_handling": [
      "任务失败或过期可原样重新提交",
      "账号无公开帖子或编号无效时可能返回空列表或标记为无数据",
      "鉴权失败属不可重试错误，需先配置有效 API 密钥"
    ]
  },
  "pricing": {
    "events": [
      {
        "event": "start",
        "label": "提交一次帖子列表采集",
        "unit_price": 0.05,
        "qty_from": "",
        "unit_size": null
      },
      {
        "event": "record",
        "label": "返回一条帖子",
        "unit_price": 0.009,
        "qty_from": "",
        "unit_size": 20
      }
    ]
  },
  "examples": [
    {
      "id": "basic",
      "goal": "采集指定 Twitter 账号的最近帖子列表",
      "input": {
        "account_id": "1611637588921815040"
      },
      "use_as_test": true
    },
    {
      "id": "more-posts",
      "goal": "采集指定账号最多 500 条帖子",
      "input": {
        "account_id": "1611637588921815040",
        "max_posts": 500
      },
      "use_as_test": false
    }
  ],
  "published_at": "2026-09-22T04:39:32.070522+00:00",
  "publisher": {
    "id": "SpiderKing999",
    "name": "SpiderKing999"
  },
  "maintainers": [
    {
      "id": "SpiderKing999",
      "name": "SpiderKing999"
    }
  ],
  "trust_tier": "community",
  "readme": "想摸清某个 Twitter 账号最近发了哪些帖、按时间怎么排列——但手动翻时间线太低效？给一个账号编号，任务在后台完成后，你会拿到该账号下已发布帖子的编号与发布时间清单，可以直接做时间线分析或交给详情类 App 继续补字段。\n\n比起在主页里一页页翻历史帖子，它把指定账号的公开帖子列表一次拉齐并按发布时间从新到旧排列，每条帖子一行，适合当作账号内容节奏分析、历史帖子盘点和下游详情采集的入口数据。\n\n## 数据说明\n\n清单取自指定 Twitter 账号的公开发帖记录，默认按发布时间从新到旧返回，同一个帖子编号只出现一次。发布时间是平台展示的帖子发布时间；采集时间与更新时间分别为结果被抓取和清洗落库的时间点。仅覆盖公开可见帖子，受保护账号或未公开内容不在其中。单次任务只针对一个账号编号，实际返回条数不超过你设定的「最多采集条数」。本 App 返回帖子编号与时间等列表字段，不含帖子正文与互动数。\n\n## 结果长什么样\n\n每条记录是一条帖子：\n\n| 帖子编号 | 发布时间 | 关联类型 | 提交账号编号 | 采集时间 |\n|---|---|---|---|---|\n| 2090273873988325464 | 2023-01-07T16:15:39 | account | 1611637588921815040 | 2026-08-25T14:44:45 |\n| 2064543452764021187 | 2026-06-10T11:01:31 | account | 1611637588921815040 | 2026-08-25T13:43:05 |\n\n另有更新时间、关联编号、无数据标记等字段。\n\n## 应用场景\n\n- 分析发文节奏时，按「发布时间」排序，看账号在什么时段更活跃、最近是否停更。\n- 搭建采集流水线时，把「帖子编号」清单交给详情类 App，逐条补齐正文与互动数据。\n- 做历史盘点时，对同一「提交账号编号」定期跑任务，比对新增「帖子编号」识别新发布内容。\n- 评估账号体量时，结合返回条数与「最多采集条数」设置，判断是否需要提高采集上限。\n",
  "favorite_count": 0,
  "labels": {
    "industry": [],
    "platform": [
      {
        "slug": "x_twitter",
        "label": "X (Twitter)"
      }
    ],
    "content": [
      {
        "slug": "post",
        "label": "帖子动态"
      }
    ]
  },
  "display_locale": "zh-CN",
  "translation_origin": null,
  "version": "0.1.2"
}