API 文档

Twitter / X 用户资料 API

查询 Twitter / X 公开用户资料和可用账户统计。

测试 API

查询 Twitter / X 公开用户资料和可用账户统计。

打开产品页与 API Tester

接口与鉴权

POST https://api.goanyapi.com/api/v1/twitter/user/profile

同步返回结果,无任务或轮询。使用 Authorization: Bearer YOUR_API_KEY;参数放在 JSON 请求体。没有 Path 或 Query 参数。

输入参数

参数位置类型必填默认值范围与说明
AuthorizationHeaderstring是—Bearer YOUR_API_KEY
Content-TypeHeaderstring是application/jsonapplication/json
screenNameJSON bodystring是—用户名、@用户名或平台完整主页链接;Instagram 主页还支持 /reels/、/tagged/ 后缀。 maxLength=2048

资源输入接受原始标识或相应的完整 URL,使用同一个参数,不需要前置获取 ID。URL 解析不增加请求或独立扣费;不支持短链和其他资源类型。

用户名、@用户名或平台完整主页链接;Instagram 主页还支持 /reels/、/tagged/ 后缀。

请求示例

POST /api/v1/twitter/user/profile
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "screenName": "https://x.com/ChineseWSJ"
}

输出字段

成功返回 HTTP 200。业务结果位于 data.result。null、空字符串、空数组和缺失字段按实际数据保留,零值是有效统计。不会因某个展示字段为空而使整次请求失败。

字段类型说明
codestring成功为 ok;错误为对应错误码
messagestring状态说明
data.resultobject / null实际业务数据,null 原样保留
data.creditsUsedinteger本次扣除积分,来自当前配置
data.remainingCreditsnumber结算后余额
data.result.screenNamestring公开业务字段;按实际结果返回,可为空或缺失
data.result.descriptionstring公开业务字段;按实际结果返回,可为空或缺失
data.result.followinginteger公开业务字段;按实际结果返回,可为空或缺失
data.result.avatarstring公开业务字段;按实际结果返回,可为空或缺失
data.result.verifiedTypestring公开业务字段;按实际结果返回,可为空或缺失
data.result.idstring公开业务字段;按实际结果返回,可为空或缺失
data.result.mediaTweetCountinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.bannerstring公开业务字段;按实际结果返回,可为空或缺失
data.result.locationstring公开业务字段;按实际结果返回,可为空或缺失
data.result.verifiedboolean公开业务字段;按实际结果返回,可为空或缺失
data.result.websitestring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweetCountinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.protectedboolean公开业务字段;按实际结果返回,可为空或缺失
data.result.namestring公开业务字段;按实际结果返回,可为空或缺失
data.result.followersinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.createdAtstring公开业务字段;按实际结果返回,可为空或缺失

此接口无分页参数。

真实响应示例

以下保存自真实成功响应,仅展示公开业务字段。示例省略实时 data.creditsUsed 和 data.remainingCredits;实际请求返回当前配置费用和账户余额。没有删减列表记录。媒体链接可能过期。打开示例不会查询或扣费。

{
  "code": "ok",
  "message": "ok",
  "data": {
    "result": {
      "id": "46574977",
      "screenName": "ChineseWSJ",
      "name": "华尔街日报中文网",
      "avatar": "https://pbs.twimg.com/profile_images/1037219311130234880/KXlUBc9N_normal.jpg",
      "banner": "https://pbs.twimg.com/profile_banners/46574977/1722989773",
      "description": "感谢您关注华尔街日报中文网。我们有上千位专业记者与资深编辑遍布全球,为读者提供24小时最可靠、即时和深入的市场动向,政商时事,科技趋势和前沿思潮。欢迎阅读并分享见解。\n\n尽管全球局势瞬息万变,可靠的信息来源仍能助您洞悉全局,运筹帷幄。前往https://t.co/Ay39I3A0HH成为会员,尽享赢得全球核心决策者信赖的独到见解和深入分析。",
      "location": "China",
      "website": "https://cn.wsj.com/",
      "createdAt": "2009-06-12T03:55:58.000Z",
      "followers": 3341431,
      "following": 493,
      "tweetCount": 99028,
      "mediaTweetCount": 6229,
      "verified": true,
      "verifiedType": "Blue",
      "protected": false
    }
  }
}

计费

当前配置下,每次成功请求消耗 1 积分。

每次成功请求包含空结果,均按当前数据库配置结算;失败不扣费。查询前必须有足够余额,并发结算时余额不足返回 402,不交付未结算结果。URL 解析不单独收费。

状态码与错误

HTTP含义
200成功(含空结果)
400JSON 或参数无效
401鉴权无效
402积分不足
429请求过于频繁,按 Retry-After 等待
502数据请求失败
503接口或价格未配置
{"code":"invalid_params","message":"Invalid parameter"}