Get Mutual Followers API

Get mutual followers between two Twitter accounts via API. $0.001 per call, ~20 users per call. GetXAPI followers you know endpoint.

POST/twitter/user/followers_you_know

This endpoint costs $0.001 per API call and returns ~20 users per page.

Request Body

Field	Type	Required	Description
`auth_token`	string	Yes	User's auth token
`ct0`	string	No	Optional current CSRF token cookie. When provided with `twid`, skips server-side credential resolution.
`twid`	string	No	Optional current user ID cookie, for example `u=1234567890`. Must be provided with `ct0`.
`user_id`	string	No	Target user id
`user_name`	string	No	Target username (without @)
`cursor`	string	No	Pagination cursor
`proxy`	string	No	Proxy URL (`http://`, `https://`, `socks5://`, or `socks4://`)

Notes

If you already have current ct0 and twid, send both to skip the extra server-side credential bootstrap from auth_token. If either one is omitted, the server resolves them from auth_token as before. Stale or invalid supplied values are not validated upfront and may fail on the actual Twitter action instead of returning an early 401.
Provide either user_id or user_name.
If user_name is provided, the API resolves it to user_id.
Pagination uses next_cursor until has_more is false.

Response (200)

{
  "userId": "1858475867762270208",
  "targetUserId": "44196397",
  "user_count": 20,
  "has_more": true,
  "next_cursor": "DAABCgABG...",
  "followers_you_know": [
    {
      "type": "user",
      "id": "1335924847940079620",
      "userName": "0xumarkhatab",
      "name": "Umar"
    }
  ]
}

Error Responses

400 - Missing fields

{
  "error": "Missing required field: user_id or user_name"
}

401 - Invalid auth_token

{
  "error": "Invalid auth_token - could not extract userId"
}

Example

curl -X POST "https://api.getxapi.com/twitter/user/followers_you_know" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_token": "your_auth_token",
    "user_name": "elonmusk"
  }'

# With pagination
curl -X POST "https://api.getxapi.com/twitter/user/followers_you_know" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_token": "your_auth_token",
    "user_name": "elonmusk",
    "cursor": "DAABCgABG..."
  }'

Followers You Know