GetXAPI
Users

Check Relationship

Check if one Twitter user follows another via API. $0.001 per call. GetXAPI follow relationship check endpoint documentation.

GET/twitter/user/check_follow_relationship

This endpoint costs $0.001 per API call.

Query Parameters

ParameterTypeRequiredDescription
source_user_namestringYesSource user screen name (without @)
target_user_namestringYesTarget user screen name (without @)

Notes

  • Check if the source user is following/followed by the target user.
  • Returns relationship details including blocking and muting status.

Response

{
  "status": "success",
  "msg": "success",
  "data": {
    "sourceUserName": "example_user",
    "targetUserName": "target_user",
    "sourceFollowsTarget": true,
    "targetFollowsSource": false,
    "canDm": false,
    "blocking": false,
    "blockedBy": false,
    "muting": false
  }
}

Response Fields

FieldTypeDescription
sourceUserNamestring@handle of source user
targetUserNamestring@handle of target user
sourceFollowsTargetbooleanTrue if source follows target
targetFollowsSourcebooleanTrue if target follows source
canDmbooleanTrue if source can DM target
blockingbooleanTrue if source is blocking target
blockedBybooleanTrue if source is blocked by target
mutingbooleanTrue if source is muting target

Example

curl -H "Authorization: Bearer API_KEY" "https://api.getxapi.com/twitter/user/check_follow_relationship?source_user_name=example_user&target_user_name=target_user"

On this page