v6

latestOpenAPI 3.0.0raw.githubusercontent.com2025-03-123918105.6 KB
Social Actions API

Verify User Following Relationship

This endpoint provides a convenient way to check if a user (identified by source_user_id) is following another user (identified by target_user_id). The endpoint achieves this without scraping the entire followers list which allows us to deliver a fully accurate result with minimal latency.

get/twitter/user/{source_user_id}/following/{target_user_id}

Path parameters

source_user_idstring required

The numeric ID of the follower user. When using languages where the user_id value exceeds the default Integer type limit (e.g., JavaScript), you should store user_id as a String. Use the id_str property returned by the API for these values.

target_user_idstring required

The numeric ID of the user being followed. When using languages where the user_id value exceeds the default Integer type limit (e.g., JavaScript), you should store user_id as a String. Use the id_str property returned by the API for these values.

Response

Request succeeded

statusstring required
source_user_idstring required

The string representation of the unique identifier for follower User.

target_user_idstring required

The string representation of the unique identifier for the User being followed.

is_followingboolean required

Indicates whether user identified by source_user_id is following user identified by target_user_id.

followers_checked_countinteger required

Deprecated. Currently returns 'null'

Example response

{
  "source_user_id": "44196397",
  "target_user_id": "1319287761048723458"
}