LogoAIDIR文档

关注者

获取Twitter用户粉丝列表的API

关注者

获取关注指定Twitter用户的粉丝列表。

请求

URL: /api/twitter/followers

方法: GETPOST

请求参数:

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

响应

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

示例

请求示例

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

错误响应

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

分页

//响应中可能包含 cursor 对象,可用于获取更多结果。要获取下一页结果,可以在请求中添加适当的游标参数(具体参数名取决于Twitter API的实现)。

注意事项

  • 对于拥有大量粉丝的账户,此API可能需要多次请求才能获取完整列表
  • 由于Twitter API的限制,对于粉丝数量极大的账户(如名人、公众人物),可能无法获取完整的粉丝列表
  • 某些账户的粉丝列表可能因隐私设置而无法完全访问

目录