查询关注关系

查询 source_user_name 是否关注了 target_user_name（following），以及 target_user_name 是否关注了 source_user_name（followed_by）。一次请求返回两个方向的关系，同时返回双方的用户名和用户 ID。单价 $0.05 / 1,000 次调用。

返回 API 接口列表

/Followers & Following Endpoints

TwexAPI REST

GET/twitter/user/check_follow_relationship

API 鉴权

AuthorizationBearer token · header必填

TwexAPI 平台的全局身份凭据 (Bearer Token)。所有接口调用均需在 Header 中携带：Authorization: Bearer <YOUR_TWEXAPI_KEY>。可在 TwexAPI 用户控制台获取。

查询参数

source_user_namestring必填

源用户的推特用户名（可带或不带 @）。

matches ^\s*@?[A-Za-z0-9_]{1,15}\s*$

target_user_namestring必填

目标用户的推特用户名（可带或不带 @）。

matches ^\s*@?[A-Za-z0-9_]{1,15}\s*$

响应结果

200双向关注关系

codeinteger必填

msgstring必填

dataCheckFollowRelationshipData必填

展开属性

source_user_namestring必填

源用户的用户名（以 X 返回为准）。

source_user_idstring | any必填

源用户的用户 ID。

展开属性

Any of:

string

string

any

any

target_user_namestring必填

目标用户的用户名（以 X 返回为准）。

target_user_idstring | any必填

目标用户的用户 ID。

展开属性

Any of:

string

string

any

any

followingboolean必填

源用户是否关注了目标用户。

followed_byboolean必填

目标用户是否关注了源用户。

400用户名缺失或格式无效

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

401身份认证失败

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

403用户已被封禁，或认证、额度不足

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

404其中一个用户不存在

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

429达到速率限制

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

500服务器错误

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

502上游服务错误

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

503服务暂时不可用

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

504上游请求超时

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

⚡交互式测试 / Try APIGET/twitter/user/check_follow_relationship

Live Console

🌐目标服务器:https://api.twexapi.io

● 生产环境就绪

🔍

公开数据读取（仅需 TwexAPI 平台密钥，无需 Twitter Cookie）

本接口为公开推特数据检索/查询，无需任何推特账号或 Cookie！仅需在下方「API 鉴权」中输入您的 TwexAPI 平台密钥 (Bearer Token) 即可直接发起测试。

🔑API 鉴权

记住密钥同步到代码示例

TwexAPI 平台密钥 Bearer Token必填

用于调用 TwexAPI 平台全部接口的全局 API 密钥，在控制台获取。

⚙️请求参数 (2)

source_user_namequery

必填源用户的推特用户名（可带或不带 @）。

target_user_namequery

必填目标用户的推特用户名（可带或不带 @）。

💡 快捷发送:⌘ / Ctrl+Enter

📡

暂无响应数据

请在「请求配置」中确认参数后，点击底部的「发送请求」按钮。

请求示例

curl -X GET "https://api.twexapi.io/twitter/user/check_follow_relationship?source_user_name=elonmusk&target_user_name=X" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.twexapi.io/twitter/user/check_follow_relationship?source_user_name=elonmusk&target_user_name=X", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.twexapi.io/twitter/user/check_follow_relationship?source_user_name=elonmusk&target_user_name=X",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "source_user_name": "elonmusk",
    "source_user_id": "44196397",
    "target_user_name": "X",
    "target_user_id": "783214",
    "following": true,
    "followed_by": false
  }
}

{
  "code": 400,
  "msg": "Validation error: querystring.target_user_name: Field required",
  "data": null
}

{
  "code": 0,
  "msg": "string",
  "data": [
    null
  ]
}

{
  "code": 0,
  "msg": "string",
  "data": [
    null
  ]
}

{
  "code": 404,
  "msg": "X user was not found. (50)",
  "data": null
}

{
  "code": 0,
  "msg": "string",
  "data": [
    null
  ]
}

{
  "code": 0,
  "msg": "string",
  "data": [
    null
  ]
}

{
  "code": 0,
  "msg": "string",
  "data": [
    null
  ]
}

{
  "code": 0,
  "msg": "string",
  "data": [
    null
  ]
}

{
  "code": 0,
  "msg": "string",
  "data": [
    null
  ]
}