Check Twitter follow relationship
Check whether one X account follows another, by handles or numeric user ids.
Headers
Get your API keyAPI key (`sfk_...`)
Source account (the potential follower). Handle without the leading @, or numeric user id.
Target account (the potential followee). Handle without the leading @, or numeric user id.
Treat source and target as handles or numeric user ids. Defaults to id when a value is all digits.
one of: id, handle
Endpoint-specific response payload.
Whether both accounts resolved and a relationship payload was returned.
one of: found, not_found
Source account when both parties resolved. `null` when `lookupStatus` is `not_found`.
Numeric X user id.
min 1 chars
Screen name without the leading @.
min 1 chars
Target account when both parties resolved. `null` when `lookupStatus` is `not_found`.
Numeric X user id.
min 1 chars
Screen name without the leading @.
min 1 chars
Whether the source account follows the target. `null` when `lookupStatus` is `not_found`.
Whether the target account follows the source. `null` when `lookupStatus` is `not_found`.
Whether the source can send a direct message to the target. `null` when `lookupStatus` is `not_found`.
Whether the source account has blocked the target. `null` when `lookupStatus` is `not_found`.
Whether the source account is blocked by the target. `null` when `lookupStatus` is `not_found`.
Whether the source account has muted the target. `null` when `lookupStatus` is `not_found`.
Whether the source account has notifications enabled for the target. `null` when `lookupStatus` is `not_found`.
Whether the source has a pending follow request to the target. `null` when `lookupStatus` is `not_found`.
Whether the source has a pending follow request from the target. `null` when `lookupStatus` is `not_found`.
Whether the source wants to see retweets from the target. `null` when `lookupStatus` is `not_found`.
Whether the source has marked the target as spam. `null` when `lookupStatus` is `not_found`.
Whether the source is set to see all replies from the target. `null` when `lookupStatus` is `not_found`.
Whether the source can tag the target in photos or videos. `null` when `lookupStatus` is `not_found`.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/twitter/friendships?source=nasa&target=elonmusk" \
-H "x-api-key: YOUR_API_KEY"Responses
Follow relationship.