X Data API

Scrape X (Twitter) data: user profiles, tweets, timelines, and download media (photos, videos, GIFs)

原始信息汇总

X Data API 数据集概述

基本信息

• 数据集名称：X Data API
• 类别：Social
• 提供者：elis-lab
• 订阅者数量：1
• 当前版本：v1
• API类型：X (Twitter) Scraper API

订阅计划与定价

• BASIC：$0.00 / 月
• PRO：$9.99 / 月
• ULTRA：$49.99 / 月
• MEGA：$149.99 / 月

核心功能

• 用户资料：获取详细资料，包括姓名、简介、关注者数量、关注数量、推文数量、验证状态。
• 推文详情：获取完整的推文数据及互动指标（点赞、转推、回复、浏览量、书签）。
• 用户时间线：支持基于游标分页的推文时间线。
• 媒体下载：直接从推文下载照片和视频，支持质量选择。
• 视频质量选项：支持选择最高或最低质量进行视频下载。
• 多媒体支持：处理包含多张照片、视频和动画GIF的推文。

独特优势

• 提供竞争对手API不具备的独特媒体下载端点。
• 快速响应时间（< 1秒）。
• 清晰、结构良好的JSON响应。
• 基于游标的分页，实现高效数据检索。
• 全面的推文元数据，包括浏览量和书签。

端点列表

方法	路径	描述
GET	/user/profile	通过用户名获取用户资料
GET	/tweet/details	获取包含媒体的完整推文详情
GET	/tweet/user-tweets	获取带分页的用户时间线
GET	/tweet/media	获取推文媒体信息（URL、尺寸、质量）
GET	/tweet/download	从推文下载照片或视频

快速开始示例

获取用户资料

curl "https://x-api-mu.vercel.app/api/v1/user/profile?username=elonmusk"

获取推文详情

curl "https://x-api-mu.vercel.app/api/v1/tweet/details?tweetId=1519480761749016577"

获取用户时间线

curl "https://x-api-mu.vercel.app/api/v1/tweet/user-tweets?username=elonmusk&count=10"

获取媒体信息

curl "https://x-api-mu.vercel.app/api/v1/tweet/media?tweetId=1812258574049157405"

下载媒体

curl -o photo.jpg "https://x-api-mu.vercel.app/api/v1/tweet/download?tweetId=1812258574049157405"

关键参数参考

用户资料

参数	必需	类型	描述
username	是	string	X用户名（不带@）

推文详情

参数	必需	类型	描述
tweetId	是	string	推文/帖子ID

用户时间线

参数	必需	类型	默认值	描述
username	是	string	—	X用户名
count	否	integer	20	推文数量 (1-100)
cursor	否	string	—	分页游标

媒体下载

参数	必需	类型	默认值	描述
tweetId	是	string	—	推文/帖子ID
mediaIndex	否	integer	0	媒体项索引（用于多照片推文）
quality	否	string	highest	视频质量：highest 或 lowest

主要响应字段

用户资料

• id — 用户ID
• name — 显示名称
• username — 用户名（不带@）
• description — 简介文本
• profile_image_url — 个人资料图片URL (400x400)
• profile_banner_url — 横幅图片URL
• verified — 传统验证状态
• is_blue_verified — X Premium验证
• location — 用户位置
• website — 用户网站URL
• created_at — 账户创建日期 (ISO 8601)
• followers_count — 关注者数量
• following_count — 关注数量
• tweet_count — 总推文数
• media_count — 总媒体帖子数

推文

• id — 推文ID
• text — 完整推文文本
• created_at — 发布日期 (ISO 8601)
• favorite_count — 点赞数
• retweet_count — 转推数
• reply_count — 回复数
• view_count — 浏览量
• media — 媒体项数组（照片、视频）
• author — 作者资料信息
• quoted_tweet — 引用的推文（如果适用）

媒体项

• type — photo、video 或 animated_gif
• media_url — 直接CDN URL
• width, height — 尺寸
• duration_ms — 视频持续时间（毫秒）
• video_variants — 包含比特率和URL的质量选项数组

分页机制

用户时间线使用基于游标的分页：

1. 首次请求：GET /tweet/user-tweets?username=elonmusk&count=20
2. 下一页：使用响应中的 cursor_bottom 作为 cursor 参数
3. 持续直到 cursor_bottom 为 null 或推文数组为空

错误代码

状态码	描述
200	成功
400	错误请求
404	用户或推文未找到
422	验证错误（参数缺失/无效）
429	速率限制
502	上游错误（X API问题）