Felo API PlatformFelo API Platform
Все эндпоинты X
v0.2.0-beta
OpenAPI 3.1.0

Получить участников списка

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клиентские библиотеки
Shell Curl

Twitter / X

​

Query public users, posts, communities and trends.

Twitter / X Операции

Получить участников списка

​

Перечисляет аккаунты, включённые в список X, по 20 на страницу с постраничной навигацией по курсору. Используйте, чтобы извлечь готовую, отобранную человеком когорту — фильтрацию уже кто-то сделал. Возвращает полные объекты пользователей в members. Чтобы читать публикации этих аккаунтов как одну ленту, используйте get_twitter_list_tweets_timeline. Для подписчиков списка используйте get_twitter_list_followers.

Справочная информация о ценах

  • Тарификация: фиксированная базовая стоимость успешного запроса.
  • Справочная оценка запроса: USD 0.0015.
  • Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.

Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Query-параметры
  • cursor
    Тип: string

    Курсор страницы

  • list_id
    Тип: string
    обязательно

    ID списка

Ответы
  • 200
    Тип: object · ResponseA06878E34984_TwitterListMembersResponse

    Ответ со списком участников

    • has_next_page
      Тип: boolean

      Указывает, доступны ли дополнительные результаты

    • members
      Тип: array object[] · ResponseA06878E34984_TwitterUser[]
      • automatedBy
        Тип: string

        Указывает, кто автоматизировал аккаунт

      • canDm
        Тип: boolean

        Указывает, можно ли отправлять пользователю личные сообщения

      • coverPicture
        Тип: string

        URL обложки

      • createdAt
        Тип: string

        Дата создания аккаунта

      • description
        Тип: string

        Описание пользователя

      • favouritesCount
        Тип: integer

        Число избранного

      • followers
        Тип: integer

        Число подписчиков

      • following
        Тип: integer

        Число подписок

      • hasCustomTimelines
        Тип: boolean

        Указывает, есть ли у пользователя пользовательские таймлайны

      • id
        Тип: string

        ID пользователя

      • isAutomated
        Тип: boolean

        Указывает, автоматизирован ли аккаунт

      • isBlueVerified
        Тип: boolean

        Указывает, есть ли у пользователя синяя верификация

      • isTranslator
        Тип: boolean

        Указывает, является ли пользователь переводчиком

      • location
        Тип: string

        Местоположение пользователя

      • mediaCount
        Тип: integer

        Число медиаэлементов

      • message
        Тип: string

        Сообщение об аккаунте

      • name
        Тип: string

        Имя пользователя

      • pinnedTweetIds
        Тип: array string[]

        Список ID закреплённых твитов

      • possiblySensitive
        Тип: boolean

        Указывает, есть ли у пользователя чувствительный контент

      • profile_bio
        Тип: object
        • description
          Тип: string

          Описание профиля

        • entities
          Тип: object
          • description
            Тип: object
            • urls
              Тип: array object[] · ResponseA06878E34984_TwitterUrl[]
              • display_url
                Тип: string

                URL для отображения

              • expanded_url
                Тип: string

                Развёрнутый URL

              • indices
                Тип: array integer[]

                Индексы URL

              • url
                Тип: string

                URL

          • url
            Тип: object
            • urls
              Тип: array object[] · ResponseA06878E34984_TwitterUrl[]
              • display_url
                Тип: string

                URL для отображения

              • expanded_url
                Тип: string

                Развёрнутый URL

              • indices
                Тип: array integer[]

                Индексы URL

              • url
                Тип: string

                URL

      • profilePicture
        Тип: string

        URL фото профиля

      • statusesCount
        Тип: integer

        Количество статусов

      • type
        Тип: string

        Тип пользователя

      • unavailable
        Тип: boolean

        Указывает, недоступен ли аккаунт.

      • unavailableReason
        Тип: string

        Причина недоступности

      • url
        Тип: string

        URL профиля пользователя

      • userName
        Тип: string

        Имя пользователя

      • verifiedType
        Тип: string

        Тип верификации

      • withheldInCountries
        Тип: array string[]

        Список стран, в которых пользователь ограничен

    • msg
      Тип: string

      Сообщение запроса, сообщение об ошибке, если status равен error

    • next_cursor
      Тип: string

      Курсор для получения следующей страницы результатов

    • status
      Тип: string enum

      Статус запроса

      значения
      • success
      • error
    application/json
  • 400

    Запрос не удалось обработать. Проверьте параметры запроса.

  • 401

    Требуется действительный API-ключ Felo.

  • 402

    Запрос не может быть выполнен: не выполнено требование биллинга.

  • 403

    Аккаунту не разрешено выполнять эту операцию.

  • 429

    Достигнут лимит запросов или расходов.

  • 502

    Сервис не смог выполнить запрос.

  • 503

    API или сервис биллинга временно недоступны.

  • 504

    Истекло время ожидания обработки запроса.

  • default

    Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

    application/json
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

Нужна помощь?