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
| Parameters | Required | Description |
|---|---|---|
username | Required | The X account to check, compared with every account in usernames. |
usernames | Required | Up 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.
- POST {"username": "elonmusk", "usernames": ["SpaceX", "NASA"]} to /v1/x/check-follow.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- 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.
Related APIs
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.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Video Transcript API