LogoAIDIR文档

用户推文

获取Twitter用户推文列表的API

用户推文

获取指定Twitter用户的推文列表。

请求

URL: /api/twitter/user-tweets

方法: GETPOST

请求参数:

参数名类型必需描述
restIdstring用户的唯一ID标识符

响应

成功响应会返回包含用户推文的列表,以时间倒序排列,包括推文内容、创建时间、点赞数、转发数等详细信息。

示例

请求示例

# GET 请求
curl --request GET \
  --url 'https://www.aidir.fun/api/twitter/user-tweets?restId=44196397' \
  --header 'X-API-Key: <api-key>'
 
# POST 请求
curl --request POST \
  --url 'https://www.aidir.fun/api/twitter/user-tweets' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
    "restId": "44196397"
  }'

响应示例

{
  "data": {
    "user": {
      "result": {
        "id": "44196397",
        "rest_id": "44196397",
        "name": "Elon Musk",
        "screen_name": "elonmusk"
      }
    },
    "timeline": {
      "instructions": [
        {
          "entries": [
            {
              "content": {
                "tweet": {
                  "id": "1512345678901234567",
                  "text": "This is a tweet example",
                  "created_at": "2023-04-15T14:34:12.000Z",
                  "favorite_count": 12345,
                  "retweet_count": 6789,
                  "reply_count": 1234,
                  "quote_count": 567,
                  "has_media": true,
                  "media": [
                    {
                      "type": "photo",
                      "url": "https://pbs.twimg.com/media/sample.jpg"
                    }
                  ]
                }
              }
            }
          ]
        }
      ]
    }
  }
}

错误响应

状态码描述
400请求参数错误,例如缺少必需的 restId 参数
401认证失败,API密钥无效或缺失
404用户不存在或没有推文
500服务器内部错误

获取用户restId

要使用此API,您需要知道用户的restId。您可以通过以下方法获取:

  1. 使用用户资料API查询用户的基本信息,其中包含restId
  2. 在Twitter网页版上,用户的个人资料URL通常包含其数字ID,如https://twitter.com/i/user/44196397

目录