LogoAIDIR文档

用户推文与回复

获取Twitter用户的推文和回复的API

用户推文与回复

获取指定Twitter用户发布的推文和回复,包括对其他用户推文的回复。

请求

URL: /api/twitter/user-tweets-replies

方法: GETPOST

请求参数:

参数名类型必需描述
restIdstring用户的唯一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可能会返回大量数据
  • 回复类推文会包含额外的元数据,指示其回复的对象

目录