LogoAIDIR文档

用户资料

获取Twitter用户个人资料信息的API

用户资料

获取Twitter用户的个人资料信息。

请求

URL: /api/twitter/user-profile

方法: GETPOST

请求参数:

参数名类型必需描述
screenNamestring用户的屏幕名称/用户名

响应

成功响应会返回用户的详细资料信息,包括用户名、简介、关注者数量、头像URL等。

示例

请求示例

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

响应示例

{
  "data": {
    "type": "user",
    "userName": "Elon Musk",
    "url": "https://twitter.com/elonmusk",
    "id": "44196397",
    "name": "Elon Musk",
    "isBlueVerified": true,
    "profilePicture": "https://pbs.twimg.com/profile_images/1234567890/avatar.jpg",
    "coverPicture": "https://pbs.twimg.com/profile_banners/44196397/1234567890/1500x500",
    "description": "CEO of companies",
    "location": "A Shortcut to the Stars",
    "followers": 123456789,
    "following": 123,
    "canDm": true,
    "createdAt": "2009-06-02T20:12:29.000Z",
    "favouritesCount": 12345,
    "hasCustomTimelines": true,
    "isTranslator": false,
    "mediaCount": 1234,
    "statusesCount": 12345
  }
}

错误响应

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

目录