正在关注
获取Twitter用户关注列表的API
正在关注
获取指定Twitter用户正在关注的用户列表。
请求
URL: /api/twitter/following
方法: GET 或 POST
请求参数:
| 参数名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| restId | string | 是 | 用户的唯一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可能需要多次请求才能获取完整列表
- 某些账户的关注列表可能因隐私设置而无法完全访问
AIDIR文档