Felo APIs

X Search API

Шукайте користувачів X, твіти, хронології та відповіді й отримуйте метадані пагінації.

POST/v2/x/tweet/search

Автентифікація

Bearer API key

Тип вмісту

application/json

Примітки щодо обмежень

1 request per 10 seconds, 3 per minute, 10 per 10 minutes.

Chat API

X Search API надає доступ до даних X (Twitter), зокрема профілів користувачів, пошуку твітів, твітів користувача та відповідей на твіти.

Автентифікація

Усі запити потребують API-ключа в заголовку Authorization:

Authorization: Bearer YOUR_API_KEY

Використання з агентами ШІ

Установіть повний пакет felo-ai, щоб надати агенту X Search та всі інші доступні Felo Skills. Інсталятор динамічно знаходить кожен каталог пакета, що містить SKILL.md, замість підтримання фіксованого списку Skills. Установіть усі знайдені Skills у Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills або Hermes Agent ~/.hermes/skills. Див. посібник з ручного налаштування агента ШІ, щоб дізнатися про встановлення, API-ключ і перевірку для кожної платформи.

1. Отримати інформацію про користувача

Пакетно отримуйте профілі користувачів X за іменем користувача.

Endpoint

POST https://openapi.felo.ai/v2/x/user/info

Тіло запиту

Параметр	Тип	Обов'язковий	Опис
`usernames`	array of strings	Так	Список імен користувачів X для пошуку

Приклад

curl -X POST 'https://openapi.felo.ai/v2/x/user/info' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "usernames": ["elonmusk", "OpenAI"]
  }'

Успішна відповідь (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "total": 2,
    "users": [
      {
        "user_id": "44196397",
        "username": "elonmusk",
        "display_name": "Elon Musk",
        "description": "...",
        "followers_count": 100000000,
        "following_count": 500,
        "tweet_count": 30000,
        "verified": true,
        "blue_verified": true,
        "profile_image_url": "https://pbs.twimg.com/...",
        "created_at": "2009-06-02T00:00:00Z",
        "location": "Mars"
      }
    ]
  }
}

Поля об'єкта користувача

Поле	Тип	Опис
`user_id`	string	ID користувача X
`username`	string	Ім'я користувача X (без @)
`display_name`	string	Відображуване ім'я
`description`	string	Опис профілю користувача
`followers_count`	integer	Кількість підписників
`following_count`	integer	Кількість підписок
`tweet_count`	integer	Загальна кількість твітів
`verified`	boolean	Чи підтверджено обліковий запис
`blue_verified`	boolean	Чи має обліковий запис верифікацію Blue
`verified_type`	string	Тип верифікації
`profile_image_url`	string	URL-адреса зображення профілю
`cover_image_url`	string	URL-адреса обкладинки
`created_at`	string	Час створення облікового запису
`location`	string	Місцезнаходження користувача
`url`	string	URL-адреса вебсайту користувача
`protected`	boolean	Чи захищено обліковий запис
`favorites_count`	integer	Кількість уподобань
`media_count`	integer	Кількість медіапублікацій
`can_dm`	boolean	Чи відкриті особисті повідомлення
`is_automated`	boolean	Чи є обліковий запис автоматизованим
`pinned_tweet_ids`	array of strings	ID закріплених твітів

2. Пошук користувачів

Шукайте користувачів X за ключовим словом.

Endpoint

POST https://openapi.felo.ai/v2/x/user/search

Тіло запиту

Параметр	Тип	Обов'язковий	Опис
`query`	string	Так	Ключове слово для пошуку
`cursor`	string	Ні	Курсор посторінкового виводу з попередньої відповіді

Приклад

curl -X POST 'https://openapi.felo.ai/v2/x/user/search' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "artificial intelligence"
  }'

Успішна відповідь (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "total": 50,
    "has_next": true,
    "next_cursor": "cursor_abc123",
    "users": [
      {
        "user_id": "...",
        "username": "...",
        "display_name": "..."
      }
    ]
  }
}

Поля відповіді

Поле	Тип	Опис
`total`	integer	Загальна кількість результатів
`has_next`	boolean	Чи доступні подальші результати
`next_cursor`	string	Курсор для наступної сторінки
`users`	array	Список об'єктів користувачів (див. розділ 1)

3. Отримати твіти користувача

Отримайте твіти конкретного користувача X.

Endpoint

POST https://openapi.felo.ai/v2/x/user/tweets

Тіло запиту

Параметр	Тип	Обов'язковий	Опис
`x_user_id`	string	Ні	ID користувача X (надайте `x_user_id` або `username`)
`username`	string	Ні	Ім'я користувача X (надайте `x_user_id` або `username`)
`limit`	integer	Ні	Кількість твітів для повернення
`cursor`	string	Ні	Курсор посторінкового виводу
`include_replies`	boolean	Ні	Чи включати відповіді

Приклад

curl -X POST 'https://openapi.felo.ai/v2/x/user/tweets' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "elonmusk",
    "limit": 20
  }'

Успішна відповідь (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "total": 20,
    "has_next": true,
    "next_cursor": "cursor_def456",
    "tweets": [
      {
        "id": "1234567890",
        "content": "Tweet content here...",
        "author": { "user_id": "...", "username": "elonmusk" },
        "created_at": "2026-03-09T12:00:00Z",
        "metrics": {
          "retweet_count": 1000,
          "favorite_count": 5000,
          "reply_count": 200,
          "quote_count": 100,
          "view_count": 500000,
          "bookmark_count": 50
        },
        "hashtags": ["AI"],
        "mentions": ["OpenAI"],
        "url": "https://x.com/elonmusk/status/1234567890",
        "lang": "en"
      }
    ]
  }
}

Поля об'єкта твіта

Поле	Тип	Опис
`id`	string	ID твіта
`content`	string	Текстовий вміст твіта
`author`	object	Об'єкт користувача-автора (див. розділ 1)
`created_at`	string	Час створення твіта
`metrics`	object	Показники залученості (див. нижче)
`replies`	array	Твіти-відповіді (якщо доступні)
`conversation_id`	string	ID ланцюжка розмови
`media_urls`	array	Прикріплені медіа
`hashtags`	array of strings	Хештеги в твіті
`mentions`	array of strings	Згадані імена користувачів
`urls`	array of strings	URL-адреси в твіті
`url`	string	Постійне посилання на твіт
`source`	string	Джерело твіта (напр. "Twitter Web App")
`lang`	string	Код мови твіта
`is_reply`	boolean	Чи є це відповіддю
`in_reply_to_id`	string	ID твіта, на який відповідають
`in_reply_to_user_id`	string	ID користувача твіта, на який відповідають
`in_reply_to_username`	string	Ім'я користувача твіта, на який відповідають
`quoted_tweet`	object	Об'єкт цитованого твіта (рекурсивно)
`retweeted_tweet`	object	Об'єкт ретвітнутого твіта (рекурсивно)
`is_limited_reply`	boolean	Чи обмежено відповіді

Поля об'єкта метрик

Поле	Тип	Опис
`retweet_count`	integer	Кількість ретвітів
`favorite_count`	integer	Кількість уподобань
`reply_count`	integer	Кількість відповідей
`quote_count`	integer	Кількість цитувань
`view_count`	integer	Кількість переглядів
`bookmark_count`	integer	Кількість збережень

4. Пошук твітів

Шукайте твіти X за ключовим словом із підтримкою розширених запитів.

Endpoint

POST https://openapi.felo.ai/v2/x/tweet/search

Тіло запиту

Параметр	Тип	Обов'язковий	Опис
`query`	string	Так	Пошуковий запит (підтримує синтаксис розширеного пошуку)
`query_type`	string	Ні	Фільтр за типом запиту
`since_time`	integer	Ні	Фільтр часу початку (часова позначка Unix у секундах)
`until_time`	integer	Ні	Фільтр часу завершення (часова позначка Unix у секундах)
`limit`	integer	Ні	Кількість твітів для повернення
`cursor`	string	Ні	Курсор посторінкового виводу

Приклад

curl -X POST 'https://openapi.felo.ai/v2/x/tweet/search' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "artificial intelligence",
    "limit": 20
  }'

Успішна відповідь (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "total": 20,
    "has_next": true,
    "next_cursor": "cursor_ghi789",
    "tweets": [
      {
        "id": "...",
        "content": "...",
        "author": { "user_id": "...", "username": "..." },
        "created_at": "2026-03-09T12:00:00Z",
        "metrics": { "retweet_count": 100, "favorite_count": 500 }
      }
    ]
  }
}

Поля відповіді

Поле	Тип	Опис
`total`	integer	Загальна кількість результатів
`has_next`	boolean	Чи доступні подальші результати
`next_cursor`	string	Курсор для наступної сторінки
`tweets`	array	Список об'єктів твітів (див. розділ 3)

5. Отримати відповіді на твіт

Отримайте відповіді на конкретні твіти.

Endpoint

POST https://openapi.felo.ai/v2/x/tweet/replies

Тіло запиту

Параметр	Тип	Обов'язковий	Опис
`tweet_ids`	array of strings	Так	ID твітів, для яких потрібно отримати відповіді
`cursor`	string	Ні	Курсор посторінкового виводу
`since_time`	integer	Ні	Фільтр часу початку (часова позначка Unix)
`until_time`	integer	Ні	Фільтр часу завершення (часова позначка Unix)

Приклад

curl -X POST 'https://openapi.felo.ai/v2/x/tweet/replies' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "tweet_ids": ["1234567890"]
  }'

Успішна відповідь (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "results": [
      {
        "tweet_id": "1234567890",
        "total": 10,
        "has_next": true,
        "next_cursor": "cursor_jkl012",
        "replies": [
          {
            "id": "...",
            "content": "Great tweet!",
            "author": { "user_id": "...", "username": "..." },
            "created_at": "2026-03-09T12:30:00Z"
          }
        ]
      }
    ]
  }
}

Поля відповіді

Поле	Тип	Опис
`results`	array	Список об'єктів результатів відповідей
`results[].tweet_id`	string	ID оригінального твіта
`results[].total`	integer	Загальна кількість відповідей
`results[].has_next`	boolean	Чи доступні подальші відповіді
`results[].next_cursor`	string	Курсор для наступної сторінки
`results[].replies`	array	Список об'єктів твітів-відповідей (див. розділ 3)

Коди помилок

Код	Статус HTTP	Опис
`UNAUTHORIZED`	401	API-ключ недійсний або відкликаний
`X_SEARCH_FAILED`	400/500	Не вдалося виконати пошуковий запит до X (перевірте параметри або помилку нижчого рівня)
`RATE_LIMIT_EXCEEDED`	429	Забагато запитів; повторіть спробу після короткої затримки
`insufficient_credits`	402	Недостатньо кредитів для виконання запиту

Кредити та обмеження швидкості

Вартість у кредитах

Кожен виклик API списує кредити залежно від кількості повернутих результатів:

Endpoint	Вартість у кредитах
`POST /x/user/info`	1 кредит за кожного повернутого користувача
`POST /x/user/search`	1 кредит за кожного повернутого користувача
`POST /x/user/tweets`	1 кредит за кожен повернутий твіт
`POST /x/tweet/search`	1 кредит за кожен повернутий твіт
`POST /x/tweet/replies`	1 кредит за кожну повернуту відповідь

Кредити списуються після завершення запиту, залежно від фактичної кількості результатів. Якщо запит повертає 0 результатів, кредити не списуються.

Вимога до мінімального балансу: на вашому обліковому записі має бути щонайменше 10 кредитів, щоб виконати будь-який запит до X API. Запити з балансом менше 10 кредитів відхиляються з HTTP 402.

Обмеження швидкості

Обмеження швидкості застосовуються відповідно до чинних політик API-сервісу та облікового запису. У разі перевищення обмеження API повертає HTTP 429. Заголовок Retry-After указує рекомендований час очікування в секундах. Використовуйте найновішу документацію сервісу та фактичні відповіді API, щоб реагувати на обмеження швидкості; для використання платформи підписка не потрібна.