Get Users by IDs (Batch) API

Look up to 100 Twitter user profiles by numeric ID in one API call. $0.001 per request. GetXAPI batch user lookup endpoint with response examples.

GET/twitter/user/batch_info_by_ids

This endpoint costs $0.001 per request, for up to 100 user ids.

Query Parameters

Parameter	Type	Required	Description
`user_ids`	string	Yes	Comma-separated numeric user ids, up to 100. `userIds` and `ids` are accepted as aliases, and repeated params (`ids=1&ids=2`) work too.

Notes

Returns up to 100 user profiles in one call. Each user has the same fields as User Info by ID.
Users come back in the order you requested them. Duplicate ids are counted once.
Suspended or otherwise unavailable accounts are listed in unavailable with a reason (for example suspended).
Ids that don't belong to any account are listed in not_found, so every id you sent is accounted for.
The price is per request, whether you send 1 id or 100.

Response (200)

{
  "status": "success",
  "msg": "success",
  "data": {
    "users": [
      {
        "id": "44196397",
        "name": "Elon Musk",
        "userName": "elonmusk",
        "location": "",
        "url": null,
        "description": "http://Terafab.AI",
        "protected": false,
        "isVerified": false,
        "isBlueVerified": true,
        "followers": 241429105,
        "following": 1420,
        "favouritesCount": 257501,
        "statusesCount": 111760,
        "mediaCount": 4763,
        "createdAt": "2009-06-02T20:12:29.000000Z",
        "coverPicture": "https://pbs.twimg.com/profile_banners/44196397/...",
        "profilePicture": "https://pbs.twimg.com/profile_images/.../aR-Kjpp4_400x400.jpg",
        "canDm": false,
        "pinnedTweetIds": ["2118732082843435305"]
      }
    ],
    "unavailable": [
      { "id": "1234567890", "reason": "suspended", "message": "User is suspended" }
    ],
    "not_found": ["1"]
  }
}

Error Responses

400 - Missing user_ids

{
  "error": "Missing required query param: user_ids (comma-separated ids, up to 100)"
}

400 - More than 100 ids

{
  "error": "Too many ids: 101 (max 100 per request)"
}

400 - Invalid id

{
  "error": "Invalid id(s) in user_ids: @elonmusk (numeric ids only)"
}

Example

curl -H "Authorization: Bearer API_KEY" "https://api.getxapi.com/twitter/user/batch_info_by_ids?user_ids=44196397,783214"

Batch User Info by IDs