x/
check-follow

The Twitter Follow Checker API tells you whether one X account follows up to 100 others and whether each one follows it back, returning is_following, is_followed_by and is_mutual for every pair of usernames.

Twitter Follow Checker API

Both follow directions
Up to 100 pairs per task
Mutual flag
0.7 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Twitter Follow Checker

A follow on X, formerly Twitter, is a one-way link from one account to another, so any two accounts sit in one of four states: neither follows, the first follows the second, the second follows the first, or both follow each other. Knowing which state a pair is in answers everyday questions such as whether contest entrants follow a brand, whether a partner followed back and how tightly a group of creators is connected.

Twitter Follow Checker API Features

  • One account against up to 100 othersPut the account to check in username and up to 100 accounts in usernames, and the Twitter Follow Checker API returns each pairing as its own row with source_username and target_username.
  • Both directions and the mutual result in one rowis_following says whether username follows the other account, is_followed_by says whether that account follows back, and is_mutual is true when both hold.
  • Pair key and profile linkid reads source_username:target_username and url points to the target's profile, so rows join cleanly to your own lists and open in one click.

Twitter Follow Checker API Parameters

ParametersRequiredDescription
usernameRequiredThe X account to check, compared with every account in usernames.
usernamesRequiredUp to 100 X usernames to compare with username. Each one returns a row for its pair.

How to Use the Twitter Follow Checker API

Give the Twitter Follow Checker API one account and the accounts to compare it with, then read one row per pair.

  1. POST {"username": "elonmusk", "usernames": ["SpaceX", "NASA"]} to /v1/x/check-follow.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read each pair from results.items and pass results.next_cursor back while has_more is true.
curl -X POST "https://api.socq.ai/v1/x/check-follow" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"elonmusk","usernames":["SpaceX","NASA"]}'

# is_following: elonmusk follows the target; is_followed_by: the target follows elonmusk back.

Twitter Follow Checker API Use Cases

  • Verifying a follow requirement for giveaway entrants: Put the brand account in username and up to 100 entrants in usernames, then keep the entrants whose is_followed_by is true.
  • Finding partners who have yet to follow you back: Check your account against the creators or brands you follow and list the pairs where is_following is true and is_followed_by is false.
  • Mapping connections inside a creator group: Run each member as username against the rest of the group and use is_mutual to draw who is connected to whom.
  • Watching which rival brands a key account follows: Check an executive's or journalist's account against a list of competitors with the Twitter Follow Checker API and repeat the check later to see when is_following changes.

Twitter Follow Checker API Pro Tips

  • For lists longer than 100, drop duplicates, split them into batches of 100 and merge the results on id.
  • Record a target with no returned row as unchecked and keep it apart from pairs reported as false; only accounts that were found produce a row.
  • Store collected_at with each pair and rerun the same Twitter Follow Checker API check later; comparing runs shows new follows and unfollows.

Beyond the Twitter Follow Checker API, use these APIs when you need a different type of public X data.

  • Twitter Profile Scraper API — Retrieve public account identity, biographies, avatars, cover images, account status, and visible audience statistics by username.
  • X Followers List API — Collect public follower account identities and visible profile metrics for one or more X usernames.
  • X Following List API — Collect profiles followed by public X accounts, including identity, biographies, account signals, visible counters, and source usernames.
  • X Post Retweeters API — Collect a task-level unique set of normalized public profiles for accounts that reposted known X or Twitter status URLs.
  • X Community API — Read community links for descriptions, membership counts, rules and joining policies.
  • X Account Location API — Look up the country an account is based in, how it connects to X, its join date and username changes.

Explore other platforms

Combine X data with public data from other supported social platforms.

Twitter Follow Checker API — FAQ

Twitter Follow Checker API is a programmatic interface for checking follow relationships between one X account and up to 100 others, using usernames only. Each pair returns whether the first account follows the second, whether it is followed back and whether the follow is mutual.

Put the first account in username and the second in usernames. is_following tells you whether the first follows the second, and is_followed_by answers the reverse in the same row.

Put your own handle in username and theirs in usernames. is_followed_by set to true means they follow you, and one task can cover up to 100 accounts.

Read is_mutual. It is true only when each account follows the other.

One account in username against up to 100 in usernames, with one row per pair. Split longer lists across several tasks.

Checks run on public accounts by username. Protected accounts keep their follow lists hidden on X, so pairs involving them cannot be confirmed.

Not with this endpoint, which reports only the pairs you submit. Use the X Following List API or the X Followers List API for full lists.