Skip to main content
POST
Twitter Follow Checker API

Twitter Follow Checker

Check the follow relationship between one X account and a set of others. For every pair you get both directions at once: whether username follows the other account, whether that account follows back, and whether the follow is mutual. Use it to verify that campaign participants follow your brand, confirm that a partner account actually follows you back, or map the connections between a group of creators.
Provide the account to check in username and up to 100 accounts to compare it with in usernames. Each pair returns whether username follows the other account and whether it is followed back.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide the account to check in username and up to 100 accounts to compare it with in usernames. Each pair returns whether username follows the other account and whether it is followed back.

username
string
required

The X account to check, with or without @.

Minimum string length: 1
usernames
string[]
required

X accounts to compare it with, with or without @.

Required array length: 1 - 100 elements
Minimum string length: 1
callback_url
string<uri>

Response

Task accepted

code
integer
data
object