x/
user-media

输入用户名即可采集 X 账号“媒体”标签页里带图片、视频或 GIF 的帖子,按从新到旧排列,附带正文、点赞、浏览数和媒体文件直链,视频为最高码率 MP4。

Twitter Media Scraper API

用户名输入
图片、视频和 GIF
最高码率 MP4
每条结果 0.7 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Twitter Media Scraper

X(Twitter)个人主页的“媒体”标签页汇集了账号发过的所有带图片、视频或 GIF 的推文,按从新到旧排列,每条都带有正文以及点赞、回复、转发和浏览数。把这些帖子当成一条信息流来看,就能了解账号在视觉内容上发了什么、哪些视频播放最多,以及图片和视频的使用比例如何随时间变化。

Twitter Media Scraper API 主要特性

  • 一个用户名拿到整个媒体标签页提交一个用户名,开头的 @ 可带可不带,即可按“媒体”标签页的顺序拿到该账号带图片、视频或 GIF 的推文,最新的在前。
  • 最高码率的视频文件视频的 media.url 指向最高码率的 MP4,thumbnail_url 是它的预览图,可以按 X 提供的最佳画质保存视频。
  • 一条帖子的附件放在同一个列表media 逐个列出帖子里的图片和视频并标明类型,一条帖子配了多张图时,这些图都归在同一段正文下。
  • 每条帖子的正文、链接和互动每条帖子还带有 text、url、published_at、author,以及点赞、评论、转发和浏览数,每个文件都能对应回它所在的帖子。

Twitter Media Scraper API 参数

参数必填描述
username必填要采集“媒体”标签页的 X 用户名,开头的 @ 可带可不带。
results_limit可选返回的媒体帖子数量,取值 1 到 1,000,默认 20。

如何使用 Twitter Media Scraper API

提交一个用户名,分页读取它“媒体”标签页里的帖子。

  1. 向 /v1/x/user-media 发送 {"username": "NASA", "results_limit": 20}。
  2. 每隔几秒查询一次 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 从 results.items 读取帖子并下载每个 media.url;has_more 为 true 时,用 results.next_cursor 请求下一页。
curl -X POST "https://api.socq.ai/v1/x/user-media" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"NASA","results_limit":20}'

# 视频的 media.url 是最高码率 MP4,thumbnail_url 是预览图。

Twitter Media Scraper API 最佳使用场景

  • 存档账号的图片和视频: 下载每个 media.url,并和帖子的 url、published_at 一起归档,留下一份带日期的账号媒体存档。
  • 找出账号播放最多的视频: 筛出 media 类型为 video 的帖子,按 views_count 和 likes_count 排序,挑出表现最好的视频。
  • 盘点品牌的视觉内容结构: 根据 published_at 和 media.type 按月统计图片帖和视频帖的数量,看品牌在图片和视频之间的比重如何变化。
  • 为报告和简报准备配图: 把 thumbnail_url、图片链接与每条帖子的正文和浏览数放在一起,用于竞品分析或活动复盘的配图。

Twitter Media Scraper API 使用建议

  • 保存文件时用帖子 id 加上附件在 media 中的位置命名,一条帖子有多张图时也能保持原来的顺序。
  • 更新存档时把 results_limit 设小一些,翻页遇到已经存过的帖子 id 就停下,因为最新的帖子总在最前面。
  • 排版需要精确尺寸时,从下载下来的文件里读取宽高。
  • 分析正文前,先去掉 text 末尾的 https://t.co 链接,这是 X 为所附媒体自动添加的链接。

除了 Twitter Media Scraper API,需要其他类型的 X 公开数据时,可以使用以下 API。

  • Twitter Tweet Scraper API — 从 x.com 或 twitter.com status URL 获取公开帖子正文、作者、互动、媒体、标签、提及和会话关系。
  • Twitter User Tweets Scraper API — 按 username 采集近期公开帖子、作者、媒体、标签、提及和互动指标,并排除回复。
  • X Post Quotes API — 按已知 status URL 采集公开引用帖,返回评论正文、作者、互动、媒体、时间和来源帖子上下文。
  • X Post Replies API — 从 X 帖子 URL 采集公开回复,支持选择排序,并返回回复正文、作者、可见互动、媒体和父帖信息。
  • Twitter Mentions API — 采集提及指定账号的公开帖子。
  • Twitter Video Transcript API — 把 X 视频里的语音转成文字,并返回视频时长。

探索其他平台

还可以将 X 数据与其他已支持社交平台的公开数据结合使用。

Twitter Media Scraper API — 常见问题

Twitter Media Scraper API 是一个用于根据用户名采集 X 账号“媒体”标签页中图片、视频和 GIF 帖子的 API。它返回每条帖子的正文、作者、互动数据和带文件直链的媒体列表,视频为最高码率 MP4。

提交账号的用户名,把 results_limit 设成需要的数量,再逐个下载返回帖子里的 media.url。每个文件都可以通过 url 和 published_at 对应回原帖。

每个视频的 media.url 都是可用码率最高的 MP4,thumbnail_url 是预览图。

包含。带 GIF 的帖子属于“媒体”标签页,会和图片帖、视频帖一起按从新到旧的顺序返回。

1 到 1,000 条,由 results_limit 决定,默认 20 条。结果分页返回,has_more 为 true 时用 next_cursor 继续读取。

每次请求只接收一个用户名。每个账号单独提交一次,再按 author.username 合并结果。