LogoAIDIR文档

正在关注

获取Twitter用户关注列表的API

正在关注

获取指定Twitter用户正在关注的用户列表。

请求

URL: /api/twitter/following

方法: GETPOST

请求参数:

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

响应

成功响应会返回用户关注的用户列表,包括每个用户的基本信息,如用户名、昵称、头像等。

示例

请求示例

# GET 请求
curl --request GET \
  --url 'https://www.aidir.fun/api/twitter/following?restId=44196397' \
  --header 'X-API-Key: <api-key>'
 
# POST 请求
curl --request POST \
  --url 'https://www.aidir.fun/api/twitter/following' \
  --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"
    },
    "following": {
      "timeline": {
        "instructions": [
          {
            "entries": [
              {
                "content": {
                  "user": {
                    "id": "12345678",
                    "rest_id": "12345678",
                    "name": "Twitter User",
                    "screen_name": "twitteruser",
                    "profile_image_url": "https://pbs.twimg.com/profile_images/1234567890/avatar.jpg",
                    "description": "This is a Twitter user",
                    "followers_count": 1000,
                    "following_count": 500,
                    "verified": true
                  }
                }
              }
            ],
            "cursor": {
              "value": "HBaAgICw4OOTExPDI5MTY4OTY5MDY4NzAyMjk3MQoSAAA=",
              "cursorType": "Bottom"
            }
          }
        ]
      }
    }
  }
}

错误响应

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

缓存

此API请求支持缓存。当相同的 restId 参数在缓存有效期内多次请求时,将返回缓存的结果,而不会重新调用Twitter API。

注意事项

  • 对于拥有大量关注者的账户,此API可能需要多次请求才能获取完整列表
  • 某些账户的关注列表可能因隐私设置而无法完全访问

目录