MkSaaS文档API 文档API 端点
用户推文与回复
获取Twitter用户的推文和回复的API
用户推文与回复
获取指定Twitter用户发布的推文和回复，包括对其他用户推文的回复。
请求
URL: /api/twitter/user-tweets-replies
方法: GET 或 POST
请求参数:
| 参数名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| restId | string | 是 | 用户的唯一ID标识符 |
响应
成功响应会返回用户的推文和回复列表，按时间倒序排列，包括推文内容、创建时间、回复关系等详细信息。
示例
请求示例
# GET 请求
curl --request GET \
--url 'https://www.aidir.fun/api/twitter/user-tweets-replies?restId=44196397' \
--header 'X-API-Key: <api-key>'
# POST 请求
curl --request POST \
--url 'https://www.aidir.fun/api/twitter/user-tweets-replies' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '{
"restId": "44196397"
}'响应示例
{
"data": {
"user": {
"id": "44196397",
"rest_id": "44196397",
"name": "Elon Musk",
"screen_name": "elonmusk"
},
"timeline": {
"instructions": [
{
"entries": [
{
"content": {
"tweet": {
"id": "1512345678901234567",
"text": "这是一条原创推文",
"created_at": "2023-04-15T14:34:12.000Z",
"favorite_count": 12345,
"retweet_count": 6789,
"reply_count": 1234,
"quote_count": 567
}
}
},
{
"content": {
"tweet": {
"id": "1512345678901234568",
"text": "这是对其他人推文的回复",
"created_at": "2023-04-15T13:45:23.000Z",
"favorite_count": 5432,
"retweet_count": 987,
"reply_count": 654,
"quote_count": 321,
"in_reply_to_status_id": "1512345678901234000",
"in_reply_to_user_id": "9876543210",
"in_reply_to_screen_name": "someuser"
}
}
}
]
}
]
}
}
}错误响应
| 状态码 | 描述 |
|---|---|
| 400 | 请求参数错误，例如缺少必需的 restId 参数 |
| 401 | 认证失败，API密钥无效或缺失 |
| 404 | 用户不存在或没有推文 |
| 500 | 服务器内部错误 |
与用户推文API的区别
- 用户推文API (
/api/twitter/user-tweets) 只返回用户发布的原创推文 - 用户推文与回复API (
/api/twitter/user-tweets-replies) 返回用户发布的所有内容，包括原创推文和对其他推文的回复
注意事项
- 对于非常活跃的用户，此API可能会返回大量数据
- 回复类推文会包含额外的元数据，指示其回复的对象