API Hop

Документация

Документация API Hop

Twitter API

Используйте единый API Twitter для получения профилей и лент в формате ответов X API v2.

Этот сервис предоставляет единый REST API Twitter. Клиенты получают согласованные структуры ответов в стиле X API v2.

text
/v1/twitter

Аутентификация

Все эндпоинты API Twitter требуют аутентификации с токеном Bearer.

http
Authorization: Bearer YOUR_API_KEY

Базовый путь

Вызывайте эти относительные пути в пределах базового URL API.

text
GET https://api.apihop.ai/v1/twitter/users
GET https://api.apihop.ai/v1/twitter/users/{id}
GET https://api.apihop.ai/v1/twitter/users/{id}/tweets

Структура ответа

Успешные ответы Twitter не обёрнуты в success/data, а напрямую возвращают нормализованные поля data, includes и meta.

Поддерживаемые возможности

Информация о пользователеНайдите пользователя Twitter по username или получите ресурс пользователя напрямую по id.Лента пользователяПолучите ленту пользователя по id, включая нормализованные твиты, расширенные данные авторов и метаданные пагинации.
  1. Если у вас есть только username, сначала получите пользователя по имени и прочитайте data.id.
  2. Используйте data.id для получения ленты пользователя.
  3. Если в ответе ленты нужны профили авторов, передайте expansions=author_id.

Правила нормализации

  • Эндпоинты пользователей возвращают один объект пользователя: { "data": { ... } }
  • Эндпоинты ленты возвращают массив твитов: { "data": [ ... ], "meta": { ... } }
  • При запросе expansions=author_id ответы ленты включают includes.users
  • user.fields и tweet.fields управляют выборкой необязательных полей
  • Объекты пользователей всегда сохраняют id, name и username
  • Объекты твитов всегда сохраняют id и text

Необязательные поля

user.fields

Поддерживаемые нормализованные поля пользователя:

  • created_at
  • description
  • entities
  • location
  • pinned_tweet_id
  • profile_banner_url
  • profile_image_url
  • protected
  • public_metrics
  • url
  • verified
  • verified_type

tweet.fields

Поддерживаемые нормализованные поля твита:

  • attachments
  • author_id
  • conversation_id
  • created_at
  • edit_history_tweet_ids
  • entities
  • in_reply_to_user_id
  • lang
  • possibly_sensitive
  • public_metrics
  • referenced_tweets
  • source

Отладка

  • Каждый ответ содержит X-Request-Id
  • Записывайте его при сбое вызова, необычном результате или ограничении частоты
  • Для вопросов по оплате сохраняйте X-Request-Id и время запроса

Эндпоинты

Получение пользователя по имениGET https://api.apihop.ai/v1/twitter/users?username=elonmuskПолучение пользователя по IDGET https://api.apihop.ai/v1/twitter/users/44196397Получение ленты пользователяGET https://api.apihop.ai/v1/twitter/users/44196397/tweets