v6

latestOpenAPI 3.0.0raw.githubusercontent.com2025-03-123918105.6 KB

Data API

Get User Followers

Returns an array of user profiles that are following the target profile identified by user_id. The profiles are returned in reverse chronological order, with the most recent followers appearing on the first page.

get/twitter/user/{user_id}/followers

Path parameters

user_idstring required

The numeric ID of the desired 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.

Query parameters

cursorstring

Cursor value obtained from next_cursor response property. Use this value to retrieve additional pages. Omit this value to retrieve the first page.

Response

Request succeeded

next_cursorstring required

Cursor value used to obtain the subsequent page. To be passed to the same endpoint as 'cursor' query parameter. Value may contain spaces and other special characters and therefore must be url-encoded to avoid any errors

Example response

{
  "users": [
    {
      "id_str": "6253282",
      "name": "Twitter API",
      "screen_name": "twitterapi",
      "location": "San Francisco, CA",
      "url": "https://developer.twitter.com",
      "description": "The Real Twitter API.",
      "protected": true,
      "followers_count": 21,
      "friends_count": 32,
      "listed_count": 9274,
      "favourites_count": 13,
      "statuses_count": 42,
      "created_at": "2009-06-02T20:12:29.000000Z",
      "profile_banner_url": "https://si0.twimg.com/profile_banners/819797/1348102824",
      "profile_image_url_https": "https://abs.twimg.com/sticky/default_profile_images/default_profile_normal.png"
    }
  ]
}