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

Get List Members

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

Twitter / X

​

Query public users, posts, communities and trends.

Twitter / X Operations

Get List Members

​

List the accounts included in an X List, 20 per page, cursor-paginated. Use this to extract a ready-made, human-curated cohort — someone else has already done the filtering. Returns full user objects under members. To read what those accounts are posting as one feed, use get_twitter_list_tweets_timeline. For the List's subscribers use get_twitter_list_followers.

Query Parameters
  • list_id
    Type: string
    required

    ID of the list

  • cursor
    Type: string

    Cursor of the page

Responses
  • 200
    Type: object · TwitterListMembersResponse

    List members response

    • has_next_page
      Type: boolean

      Indicates if there are more results available

    • members
      Type: array object[] · TwitterUser[]
      • automatedBy
        Type: string

        Indicates who automated the account

      • canDm
        Type: boolean

        Indicates if the user can be direct messaged

      • coverPicture
        Type: string

        URL of the cover picture

      • createdAt
        Type: string

        Account creation date

      • description
        Type: string

        Description of the user

      • favouritesCount
        Type: integer

        Number of favorites

      • followers
        Type: integer

        Number of followers

      • following
        Type: integer

        Number of followings

      • hasCustomTimelines
        Type: boolean

        Indicates if the user has custom timelines

      • id
        Type: string

        ID of the user

      • isAutomated
        Type: boolean

        Indicates if the account is automated

      • isBlueVerified
        Type: boolean

        Indicates if the user is blue verified

      • isTranslator
        Type: boolean

        Indicates if the user is a translator

      • location
        Type: string

        Location of the user

      • mediaCount
        Type: integer

        Number of media items

      • message
        Type: string

        Message about the account

      • name
        Type: string

        Name of the user

      • pinnedTweetIds
        Type: array string[]

        List of pinned tweet IDs

      • possiblySensitive
        Type: boolean

        Indicates if the user has sensitive content

      • profile_bio
        Type: object
        • description
          Type: string

          Bio description

        • entities
          Type: object
          • description
            Type: object
            • urls
              Type: array object[] · TwitterUrl[]
              • display_url
                Type: string

                Display URL

              • expanded_url
                Type: string

                Expanded URL

              • indices
                Type: array integer[]

                Indices of the URL

              • url
                Type: string

                URL

          • url
            Type: object
            • urls
              Type: array object[] · TwitterUrl[]
              • display_url
                Type: string

                Display URL

              • expanded_url
                Type: string

                Expanded URL

              • indices
                Type: array integer[]

                Indices of the URL

              • url
                Type: string

                URL

      • profilePicture
        Type: string

        URL of the profile picture

      • statusesCount
        Type: integer

        Number of statuses

      • type
        Type: string

        Type of the user

      • unavailable
        Type: boolean

        Indicates if the account is unavailable

      • unavailableReason
        Type: string

        Reason for unavailability

      • url
        Type: string

        URL of the user's profile

      • userName
        Type: string

        Username of the user

      • verifiedType
        Type: string

        Type of verification

      • withheldInCountries
        Type: array string[]

        List of countries where the user is withheld

    • msg
      Type: string

      Message of the request, error message if status is error

    • next_cursor
      Type: string

      Cursor for fetching the next page of results

    • status
      Type: string enum

      Status of the request

      values
      • success
      • error
    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/list/members
curl 'https://openapi.felo.ai/v1/beta/twitter/list/members?list_id=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "members": [
    {
      "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",
      "profile_bio": {
        "description": "string",
        "entities": {
          "description": {
            "urls": [
              {
                "display_url": "string",
                "expanded_url": "string",
                "indices": [
                  1
                ],
                "url": "string"
              }
            ]
          },
          "url": {
            "urls": [
              {
                "display_url": "string",
                "expanded_url": "string",
                "indices": [
                  1
                ],
                "url": "string"
              }
            ]
          }
        }
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "string",
  "status": "success",
  "msg": "string"
}
Get List Members