X User Tweets
X User Tweets 用于获取 X 用户时间线帖子数据。
- 按账号名抓取用户发帖列表
- 支持限制抓取页数和推文数量
- 返回账号信息与推文互动数据
- 适合做账号监测和定制化社媒内容跟踪
使用 XCrawl 获取 X 用户帖子
使用方式
curl -s -X POST 'https://run.xcrawl.com/v1/data' \
-H 'Authorization: Bearer $XCRAWL_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"engine": "x_user_tweets",
"screen_name": "elonmusk",
"max_tweets": 10,
"pages": 1,
"delay": 1
}'请求参数说明:
engine固定为x_user_tweetsscreen_name用于指定账号名max_tweets用于限制最多返回的推文数量pages用于指定最多翻页数delay用于控制翻页间隔
响应示例
{
"user": {
"name": "Elon Musk",
"screen_name": "elonmusk",
"followers_count": 237651757
},
"tweets": [
{
"id": "2038394048885805303",
"full_text": "The largest cultural exchange in history just dropped.",
"favorite_count": 13991
}
]
}参数说明
必填参数
| 参数 | 类型 | 说明 |
|---|---|---|
screen_name | string | X 用户账号名。 |
max_tweets | number | 最多返回的推文数量。 |
pages | number | 最多抓取页数。 |
delay | number | 翻页间隔秒数。 |
参数补充说明
max_tweets默认值为10pages默认值为1delay默认值为1
响应字段
响应数据位于顶层对象中。
| 字段 | 类型 | 说明 |
|---|---|---|
user | object | 目标账号基础信息。 |
pages_fetched | number | 实际抓取的页数。 |
next_cursor | string | 下一页游标。 |
tweets | array | 推文列表。 |
用户字段
user 中常用字段包括:
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 用户 ID。 |
name | string | 显示名称。 |
screen_name | string | 账号名。 |
description | string | 个人简介。 |
followers_count | number | 粉丝数量。 |
friends_count | number | 关注数量。 |
statuses_count | number | 发帖总数。 |
verified | boolean | 是否认证。 |
推文字段
tweets[] 中每个元素包含以下字段:
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 推文 ID。 |
created_at | string | 发布时间。 |
full_text | string | 推文全文。 |
lang | string | 语言代码。 |
favorite_count | number | 点赞数。 |
retweet_count | number | 转发数。 |
reply_count | number | 回复数。 |
quote_count | number | 引用数。 |
bookmark_count | number | 收藏数。 |
