v1

latestOpenAPI 3.0.32026-07-213841124.9 KB
Verification

Follow Status Check

Checks whether one Twitter/X user follows another account. You provide the required user identifiers in the request, and the endpoint returns afollow value (true or false)

Use cases:

SaaS products verifying follow conditions for gated access; marketing tools checking if influencers follow a brand account; automation systems validating follow relationships before triggering actions; CRM platforms enriching relationship data between accounts; growth tools measuring campaign-based follow conversions.

post/check-follow

Request body

project_handlestring
project_idstring
user_idstring
user_linkstring
usernamestring

Example request

{
  "project_handle": "tweetscout_io",
  "project_id": "940691529697554432",
  "user_id": "44196397",
  "user_link": "https://twitter.com/elonmusk",
  "username": "elonmusk"
}

Response

OK

followboolean
user_protectedboolean

Example response

{
  "follow": true
}