Skip to main content
GET
/
x
/
follow-relationship
curl -X GET "https://scrape.st/x/follow-relationship?source=jack&target=elonmusk" \
  -H "x-api-key: YOUR_API_KEY"

{
  "source": { "screen_name": "jack", "id": "12" },
  "target": { "screen_name": "elonmusk", "id": "44196397" },
  "following": true,
  "followed_by": true
}
Check the follow relationship between two X accounts. Returns whether the source follows the target and whether the target follows the source back. Either account may be given as a username (with or without @) or a numeric user id.
Notification settings (whether the source has post notifications enabled for the target) are not returned — that value is private to the account owner and cannot be read for arbitrary accounts.

​
Query Parameters

​
source
string
required
The account whose following is being checked — @handle, handle, or numeric user id.
​
target
string
required
The account being checked against — @handle, handle, or numeric user id.

​
Response

​
source
object
The resolved source account (screen_name, id).
​
target
object
The resolved target account (screen_name, id).
​
following
boolean
Whether source follows target.
​
followed_by
boolean
Whether target follows source.
curl -X GET "https://scrape.st/x/follow-relationship?source=jack&target=elonmusk" \
  -H "x-api-key: YOUR_API_KEY"

{
  "source": { "screen_name": "jack", "id": "12" },
  "target": { "screen_name": "elonmusk", "id": "44196397" },
  "following": true,
  "followed_by": true
}