logo

Twitter 帖子详情采集

提交帖子编号,返回正文、互动数据与作者信息等公开详情

概览

想看清某条 Twitter 帖子的正文、点赞转发、评论数和作者信息——但逐条打开页面太低效?提交帖子编号清单,任务在后台完成后,你会拿到结构化的帖子详情表,可以直接做互动分析或导出给下游工具。

比起手工复制帖子内容与互动数字,它把多个帖子编号的公开字段一次拉全并对齐成统一列名,互动指标与发布信息都是取数当时的快照,适合当作舆情监测、内容对标和传播分析的数据底表。

数据说明

详情取自 Twitter 公开可见的帖子页面,按本次提交的编号逐条对应,每个编号最多一条记录。点赞数、评论数、转发数、引用数与浏览数是取数当时的公开统计值;正文为帖子公开文字内容,可能含链接与媒体引用。转发帖会标记「是否转发」,并尽量给出被转推的原帖子编号。仅覆盖公开可见内容,受保护账号或已删除帖子不在其中。

结果长什么样

每条记录是一条 Twitter 帖子:

帖子编号作者昵称点赞数评论数转发数发布时间
1034243881263542272ヒビトラ11012018-08-28T08:58:51

另有帖子正文、帖子链接、内容类型、作者粉丝数等字段。

应用场景

  • 做传播分析时,按「点赞数」「转发数」「浏览数」对比多条帖子的互动表现。
  • 做内容对标时,结合「帖子正文」与「内容类型」,归纳高互动帖的表述与媒介形式。
  • 追踪舆情帖时,用「提交编号」对齐监测清单,定期重跑比对互动数变化。
  • 串联分析流水线时,从账号帖子列表 App 拿到编号,交给本 App 补齐正文与互动明细。

适用边界

单次最多 100 个帖子编号;每个编号最多返回一条公开详情,不含私密或未公开内容。

  • 适合用于
  • 需要获取 Twitter 帖子的正文、点赞、转发、评论数等互动明细时
  • 已有帖子编号清单,需要补齐作者信息与发布时间等字段时
  • 不要用于
  • 只有账号编号、需要拉时间线帖子列表时——用账号帖子列表类 App
  • 需要帖子下全部评论明细时——用评论采集类 App

失败处理

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

  1. 1任务失败或过期可原样重新提交;部分编号失败时仍可拉取已成功采集的结果
  2. 2帖子编号无效或内容不可公开访问时,对应记录可能缺失或字段为空
  3. 3鉴权失败属不可重试错误,需先配置有效 API 密钥

输入参数

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

字段名业务名称类型必填默认值枚举 / 约束示例说明
post_ids帖子编号array<object>最多 100 项[{"kw":"1034243881263542272"}]要采集详情的 Twitter 帖子编号(content ID),纯数字,可从帖子链接末尾或账号帖子列表结果中获取,一次最多 100 个

输出数据

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

字段名业务名称类型示例说明
content_id帖子编号string帖子在平台内的唯一编号
content_url帖子链接string帖子页面 URL
content_text帖子正文string帖子文字内容
content_type内容类型string帖子内容类型,如 video、text 等
publish_time发布时间string帖子公开发布时间
publish_location发布位置string帖子标注的发布地点
crawl_time采集时间string本条详情采集完成的时间
like_count点赞数string帖子点赞数,取数当时的公开统计值
comment_count评论数string帖子评论数,取数当时的公开统计值
forward_count转发数string帖子转发数,取数当时的公开统计值
retweet_num转推数string帖子转推次数,取数当时的公开统计值
quote_count引用数string帖子被引用次数,取数当时的公开统计值
view_count浏览数string帖子浏览次数,取数当时的公开统计值
collect_count收藏数string帖子收藏数,取数当时的公开统计值
is_forward是否转发boolean该帖子是否为转发内容
parent_content_id父帖子编号string回复或转发链路的父帖子编号
retweeted_content_id被转推编号string被转推的原帖子编号
account_id作者编号string发布者账号在平台内的唯一编号
account_name作者昵称string发布者账号展示昵称
biz_id业务编号string帖子关联的业务标识编号
account_home_url作者主页string发布者账号主页 URL
account_avatar_url作者头像string发布者头像图片地址
account_fans_count作者粉丝数string发布者粉丝数,取数当时的公开统计值
image_urls图片链接string帖子附带的图片地址
video_urls视频链接string帖子附带的视频或封面地址
submitted_post_id提交编号string本次任务提交时填写的帖子编号

记录 Schema

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

output.schema
{
  "type": "object",
  "properties": {
    "content_id": {
      "type": "string",
      "title": "帖子编号",
      "description": "帖子在平台内的唯一编号"
    },
    "content_url": {
      "type": "string",
      "title": "帖子链接",
      "description": "帖子页面 URL"
    },
    "content_text": {
      "type": "string",
      "title": "帖子正文",
      "description": "帖子文字内容"
    },
    "content_type": {
      "type": "string",
      "title": "内容类型",
      "description": "帖子内容类型,如 video、text 等"
    },
    "publish_time": {
      "type": "string",
      "title": "发布时间",
      "description": "帖子公开发布时间"
    },
    "publish_location": {
      "type": "string",
      "title": "发布位置",
      "description": "帖子标注的发布地点"
    },
    "crawl_time": {
      "type": "string",
      "title": "采集时间",
      "description": "本条详情采集完成的时间"
    },
    "like_count": {
      "type": "string",
      "title": "点赞数",
      "description": "帖子点赞数,取数当时的公开统计值"
    },
    "comment_count": {
      "type": "string",
      "title": "评论数",
      "description": "帖子评论数,取数当时的公开统计值"
    },
    "forward_count": {
      "type": "string",
      "title": "转发数",
      "description": "帖子转发数,取数当时的公开统计值"
    },
    "retweet_num": {
      "type": "string",
      "title": "转推数",
      "description": "帖子转推次数,取数当时的公开统计值"
    },
    "quote_count": {
      "type": "string",
      "title": "引用数",
      "description": "帖子被引用次数,取数当时的公开统计值"
    },
    "view_count": {
      "type": "string",
      "title": "浏览数",
      "description": "帖子浏览次数,取数当时的公开统计值"
    },
    "collect_count": {
      "type": "string",
      "title": "收藏数",
      "description": "帖子收藏数,取数当时的公开统计值"
    },
    "is_forward": {
      "type": "boolean",
      "title": "是否转发",
      "description": "该帖子是否为转发内容"
    },
    "parent_content_id": {
      "type": "string",
      "title": "父帖子编号",
      "description": "回复或转发链路的父帖子编号"
    },
    "retweeted_content_id": {
      "type": "string",
      "title": "被转推编号",
      "description": "被转推的原帖子编号"
    },
    "account_id": {
      "type": "string",
      "title": "作者编号",
      "description": "发布者账号在平台内的唯一编号"
    },
    "account_name": {
      "type": "string",
      "title": "作者昵称",
      "description": "发布者账号展示昵称"
    },
    "biz_id": {
      "type": "string",
      "title": "业务编号",
      "description": "帖子关联的业务标识编号"
    },
    "account_home_url": {
      "type": "string",
      "title": "作者主页",
      "description": "发布者账号主页 URL"
    },
    "account_avatar_url": {
      "type": "string",
      "title": "作者头像",
      "description": "发布者头像图片地址"
    },
    "account_fans_count": {
      "type": "string",
      "title": "作者粉丝数",
      "description": "发布者粉丝数,取数当时的公开统计值"
    },
    "image_urls": {
      "type": "string",
      "title": "图片链接",
      "description": "帖子附带的图片地址"
    },
    "video_urls": {
      "type": "string",
      "title": "视频链接",
      "description": "帖子附带的视频或封面地址"
    },
    "submitted_post_id": {
      "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": {
    "SpiderKing999__twitter-post-detail": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=SpiderKing999/twitter-post-detail",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

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

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

价格

提交一次详情采集

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

¥0.05/
返回一条帖子详情

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

¥0.006/

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

立即体验

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

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