关注者
获取Twitter用户粉丝列表的API
关注者
获取关注指定Twitter用户的粉丝列表。
请求
URL: /api/twitter/followers
方法: GET 或 POST
请求参数:
| 参数名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| restId | string | 是 | 用户的唯一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的限制,对于粉丝数量极大的账户(如名人、公众人物),可能无法获取完整的粉丝列表
- 某些账户的粉丝列表可能因隐私设置而无法完全访问
AIDIR文档