GET/user/check_follow_relationship$0.0008 / call

Check Follow Relationship

Return the directional follow relationship between a source and target user: whether the source follows the target, and whether the target follows back.

Request

curl "https://api.twitterapis.com/user/check_follow_relationship?source_username=naval&target_username=balajis" \
  -H "Authorization: Bearer $TWITTERAPIS_KEY"

Parameters

Parameter Type Required Description

source_username

string

required

The account whose following is checked.

Example: naval

target_username

string

required

The account being checked against.

Example: balajis

Response

Field	Type	Description
`following`	boolean	True if source follows target.
`followed_by`	boolean	True if target follows source back.
`status`	string	"success" on a normal response.

Example response

{
  "following": true,
  "followed_by": false,
  "status": "success"
}

Pricing for this endpoint

user/check_follow_relationship costs $0.0008 per call and returns ~20 tweets, so roughly $0.04 per 1,000 tweets. No subscriptions or minimum spend.

See full pricing Get an API key

Related endpoints

GETUser Info by Username→GETUser Info by ID→GETUser About→GETUser Media→GETUser Tweets→GETUser Tweets and Replies→