Twitter API

API Twitter: поиск пользователей, ленты и пагинация

Интегрируйте эндпоинты Twitter / X API Hop с Bearer-аутентификацией, выбором полей пользователей и твитов, курсорной пагинацией и обработкой ошибок валидации.

Преобразуйте имя в ID пользователя, получите его ленту и передайте следующий токен для новой страницы. Успешные вызовы сразу возвращают JSON; опрос Jobs для этих эндпоинтов не нужен.

Получить API-ключ Посмотреть каталог API

Для конкретной задачи

Реализуйте три поддерживаемые операции GET и обработку результатов.

Найдите аккаунт по имени и выберите возвращаемые поля профиля.

Обновите известный аккаунт по ID без повторного поиска имени.

Получайте страницы ленты с ограничением размера и токеном пагинации.

Единица тарификации

Как измеряется использование

USD за запрос.

Рабочие ограничения

Возвращаемые поля зависят от документированных параметров и ответа источника.
max_results должен быть целым от 1 до 100. На странице может быть меньше результатов.
Храните ID пользователей и твитов строками, чтобы избежать потери числовой точности.

Руководства по интеграции

Выберите следующий шаг

Спланируйте обновления и хранение Ограничьте число запросов, удаляйте дубликаты и фиксируйте время получения в приложении. Каталог API данных Изучите текущие продукты данных, операции и цены за запрос.

Текущий охват каталога

Доступные API и единицы тарификации

Сравните ID API, операции, поставщиков и цены. Перед оценкой расходов проверьте дату каталога и единицу тарификации каждой операции.

API данных

Twitter User Data

twitter-user-data Документация

Доступно

Получайте общедоступные профили пользователей Twitter / X и ленты их публикаций.

Поставщик: Twitter / X Data
Единица тарификации: запрос
Форматы API и эндпоинты: Эндпоинты запросов указаны в операциях ниже.
Опубликованные возможности: Поиск пользователя, Лента пользователя

Опубликованные операции

GET /v1/twitter/users Получить пользователя по имени пользователя
GET /v1/twitter/users/{id} Получить пользователя по ID
GET /v1/twitter/users/{id}/tweets Получить твиты пользователя

Цена API Hop

Запрос: $0.0020 /запрос

Получить пользователя по имени пользователя

GET /v1/twitter/users

Цена API Hop

Запрос: $0.0020 /запрос

Получить пользователя по ID

GET /v1/twitter/users/{id}

Цена API Hop

Запрос: $0.0020 /запрос

Получить твиты пользователя

GET /v1/twitter/users/{id}/tweets

Цена API Hop

Запрос: $0.0020 /запрос

Открыть полный каталог API

Пример запроса

Начните с документированной операции

curl "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics" \
  -H "Authorization: Bearer <API_KEY>"

const response = await fetch("https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics", {
  headers: { Authorization: "Bearer <API_KEY>" }
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics"
headers = {"Authorization": "Bearer <API_KEY>"}
response = requests.get(url, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

Используйте базовый URL API из документации аккаунта и замените заглушки. Передавайте API-ключ в заголовке Authorization, а не в URL или коммитируемом файле.

Эндпоинты

Три операции для аккаунтов и лент

Поиск по имени пользователя GET /v1/twitter/users?username=<USERNAME>

Читайте возвращённый data.id как строку для последующих запросов.

Поиск по ID пользователя GET /v1/twitter/users/<USER_ID>

Получите известный аккаунт и при необходимости выберите поля профиля.

Лента пользователя GET /v1/twitter/users/<USER_ID>/tweets

Задайте max_results и передавайте pagination_token для следующих страниц.

Параметры запроса

Выбор полей и пагинация ленты

Поиск аккаунта: username обязателен для /v1/twitter/users. Оба эндпоинта поиска принимают список user.fields через запятую, например description,public_metrics.
Размер страницы: max_results принимает целые от 1 до 100. Это верхний предел размера страницы, а не гарантия числа публикаций.
Поля ленты: Используйте tweet.fields=created_at,public_metrics для времени и метрик. Для доступных сведений об авторе запросите expansions=author_id вместе с user.fields. Чтобы исключить эти типы публикаций, задайте exclude=replies,retweets.
Следующая страница: Передайте meta.next_token ответа как pagination_token следующего запроса. Не интерпретируйте токен и кодируйте его для URL. Остановитесь при отсутствии следующего токена, достижении бюджета страниц или повторе токена.

Обработка ответов

Читайте результаты JSON напрямую

Поиск возвращает аккаунт в data. Ответы ленты содержат массив data и meta.result_count, а при наличии следующего курсора — meta.next_token. Расширенные сведения об авторах могут быть в includes.users.

{
  "data": [],
  "meta": {
    "result_count": 0
  }
}

Пример пустой ленты, а не результат реального аккаунта. Необязательные поля и курсоры могут отсутствовать. Пустая страница не доказывает, что аккаунт никогда не публиковал.

Ошибки валидации

Исправьте неверные параметры перед повтором

Отсутствие username или max_results вне диапазона возвращает HTTP 400 с success: false, error.code: 10001, error.message и requestId. Изучите сообщение и исправьте запрос, а не повторяйте его без изменений.

Отслеживание запросов

Сохраняйте ID запроса, а не учётные данные

Сохраните заголовок ответа X-Request-Id для поддержки и отслеживания. Проверяйте HTTP-статус перед чтением успешного ответа и не записывайте API-ключи и ненужные данные профилей в журналы приложения.