Skip to content
cheapxapi
All endpoints

Check follow relationship

GET/twitter/user/check_follow_relationship

Whether two users follow each other.

Price: $0.0006 per request.

Parameters

  • source_user_namestringrequired

    Screen name of the first user.

    Example: NASA

  • target_user_namestringrequired

    Screen name of the second user.

    Example: SpaceX

Example request

curl "https://api.cheapxapi.com/twitter/user/check_follow_relationship?source_user_name=NASA&target_user_name=SpaceX" \
  -H "x-api-key: YOUR_KEY"

Response

Charged. Check status: success means data was returned; error (e.g. user not found) is also HTTP 200.

FieldType
dataobject
followingboolean
followed_byboolean
status"success" | "error"
messagestring

Status codes

200
Charged. Check status: success means data was returned; error (e.g. user not found) is also HTTP 200.
400
Invalid parameters (charged), or API key placed in the URL (not charged).
401
Missing or invalid API key (not charged).
402
Insufficient balance (not charged).
403
Account disabled (not charged).
404
Unknown endpoint (charged), or the requested item could not be found (not charged). Note: many endpoints report a missing user/tweet as HTTP 200 with "status":"error" instead; those are charged.
405
Only GET is supported (not charged).
429
Rate limit exceeded (not charged). Retry after the time in the Retry-After header.
503
Temporary service problem, or the endpoint is temporarily unavailable (not charged). Retry with exponential backoff.