> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrape.st/llms.txt
> Use this file to discover all available pages before exploring further.

# Follow Relationship

> Check whether one X account follows another

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.

<Note>
  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.
</Note>

## Query Parameters

<ParamField query="source" type="string" required>
  The account whose following is being checked — `@handle`, `handle`, or numeric
  user id.
</ParamField>

<ParamField query="target" type="string" required>
  The account being checked against — `@handle`, `handle`, or numeric user id.
</ParamField>

## Response

<ResponseField name="source" type="object">
  The resolved source account (`screen_name`, `id`).
</ResponseField>

<ResponseField name="target" type="object">
  The resolved target account (`screen_name`, `id`).
</ResponseField>

<ResponseField name="following" type="boolean">
  Whether **source follows target**.
</ResponseField>

<ResponseField name="followed_by" type="boolean">
  Whether **target follows source**.
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -X GET "https://scrape.st/x/follow-relationship?source=jack&target=elonmusk" \
    -H "x-api-key: YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "source": { "screen_name": "jack", "id": "12" },
    "target": { "screen_name": "elonmusk", "id": "44196397" },
    "following": true,
    "followed_by": true
  }
  ```
</ResponseExample>