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
提交一个用户名,分页读取它“媒体”标签页里的帖子。
- 向 /v1/x/user-media 发送 {"username": "NASA", "results_limit": 20}。
- 每隔几秒查询一次 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 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 为所附媒体自动添加的链接。
相关 API
除了 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 视频里的语音转成文字,并返回视频时长。
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- X User Replies API
- Twitter Follow Checker API