Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Batch Get User Info By UserIds

Server:https://openapi.felo.ai
Client Libraries

Twitter / X

​

Query public users, posts, communities and trends.

Batch Get User Info By UserIds

​

Resolve many X users at once from their numeric user IDs, passed as a comma-separated userIds string. Use this when a previous call (timeline, retweeters, followers) gave you IDs and you need to turn them into full profiles in one request instead of looping. Returns an array of user objects under users. Note this endpoint takes numeric IDs, not @handles — to look up by handle use get_twitter_user_info.

Query Parameters
  • userIds
    Type: string
    required

    Comma-separated user IDs

Responses
  • 200
    Type: object · BatchUserInfoResponse

    Batch user information

    • msg
      Type: string
    • status
      Type: string enum
      values
      • success
      • error
    • users
      Type: array object[]
      • automatedBy
        Type: string
      • canDm
        Type: boolean
      • coverPicture
        Type: string
      • createdAt
        Type: string
      • description
        Type: string
      • favouritesCount
        Type: integer

        Integer numbers.

      • followers
        Type: integer

        Integer numbers.

      • following
        Type: integer

        Integer numbers.

      • hasCustomTimelines
        Type: boolean
      • id
        Type: string
      • isAutomated
        Type: boolean
      • isBlueVerified
        Type: boolean
      • isTranslator
        Type: boolean
      • location
        Type: string
      • mediaCount
        Type: integer

        Integer numbers.

      • message
        Type: string
      • name
        Type: string
      • pinnedTweetIds
        Type: array string[]
      • possiblySensitive
        Type: boolean
      • profilePicture
        Type: string
      • statusesCount
        Type: integer

        Integer numbers.

      • type
        Type: string
      • unavailable
        Type: boolean
      • unavailableReason
        Type: string
      • url
        Type: string
      • userName
        Type: string
      • verifiedType
        Type: string
      • withheldInCountries
        Type: array string[]
    application/json
  • 400

    The request could not be processed. Check the request parameters.

  • 401

    A valid Felo API key is required.

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    A request or spending limit has been reached.

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for get/v1/beta/twitter/user/batch_info_by_ids
curl 'https://openapi.felo.ai/v1/beta/twitter/user/batch_info_by_ids?userIds=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "users": [
    {
      "type": "string",
      "userName": "string",
      "url": "string",
      "id": "string",
      "name": "string",
      "isBlueVerified": true,
      "verifiedType": "string",
      "profilePicture": "string",
      "coverPicture": "string",
      "description": "string",
      "location": "string",
      "followers": 1,
      "following": 1,
      "canDm": true,
      "createdAt": "string",
      "favouritesCount": 1,
      "hasCustomTimelines": true,
      "isTranslator": true,
      "mediaCount": 1,
      "statusesCount": 1,
      "withheldInCountries": [
        "string"
      ],
      "possiblySensitive": true,
      "pinnedTweetIds": [
        "string"
      ],
      "isAutomated": true,
      "automatedBy": "string",
      "unavailable": true,
      "message": "string",
      "unavailableReason": "string"
    }
  ],
  "status": "success",
  "msg": "string"
}
Batch Get User Info By UserIds