v6

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

Data API

Get Multiple User Profiles by IDs

Retrieve user information for up to 100 Twitter users in a single request.

post/twitter/users-by-ids

Request body

idsstring[] required

An array of Twitter user IDs. Up to 100 IDs per request. 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

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"
    }
  ]
}