x/
mentions

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

Twitter Mentions API

Упоминания бренда
Входящие обсуждения
Мониторинг упоминаний
0,7 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Twitter Mentions

Отслеживание публичных упоминаний показывает восприятие бренда, вопросы клиентов и входящие обсуждения на платформе X. Нормализованные записи упоминаний содержат текст поста, имена авторов, метки времени, медиавложения и публичные счетчики вовлеченности без авторизации на платформе.

Возможности Twitter Mentions API

  • Отслеживание публичных упоминанийПолучайте публичные посты с упоминанием любого целевого имени пользователя без учетных данных для входа в целевой аккаунт.
  • Ограничение периода по датамОграничивайте ленту упоминаний фильтрами start_date и end_date в формате даты ISO или секунд Unix.
  • Данные об авторе и постеПолучайте нормализованные записи с полным текстом поста, профилями авторов, медиавложениями и постоянными ссылками.
  • Метрики вовлеченностиИзвлекайте число лайков, комментариев, репостов, цитат, закладок и просмотров для каждого найденного упоминания.

Параметры Twitter Mentions API

ПараметрыОбязательныйОписание
usernamesОбязательныйМассив целевых публичных имен пользователей X, для которых нужно получить упоминания, с начальным @ или без него.
results_limitНеобязательныйМаксимальное число упоминаний на одно имя пользователя; значение должно быть кратно 20 и находиться в диапазоне от 20 до 2 000.
start_dateНеобязательныйНеобязательная начальная метка времени в формате ISO (YYYY-MM-DD) или в секундах Unix: возвращаются упоминания, сделанные в этот момент или позже.
end_dateНеобязательныйНеобязательная конечная метка времени в формате ISO (YYYY-MM-DD) или в секундах Unix: возвращаются упоминания, сделанные до этого момента.

Как использовать Twitter Mentions API

Отправьте целевое имя пользователя и необязательный диапазон дат как асинхронную задачу, затем опрашивайте ее, чтобы получить записи упоминаний.

  1. Укажите одно или несколько имен в usernames и задайте results_limit кратным 20 (до 2 000).
  2. При необходимости укажите start_date и end_date, чтобы ограничить период сбора упоминаний.
  3. Отправьте POST-запрос на /v1/x/mentions со своим API-ключом SocQ.
  4. Опрашивайте /v1/tasks/{task_id} и листайте data.results.items с помощью next_cursor.
curl -X POST "https://api.socq.ai/v1/x/mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@OpenAI"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

Сценарии использования Twitter Mentions API

  • Мониторинг репутации бренда: Отслеживайте входящие упоминания, отзывы и тональность вокруг аккаунта вашей компании почти в реальном времени.
  • Сортировка обращений в поддержку: Находите необработанные жалобы клиентов, сообщения об ошибках в продукте или отзывы, адресованные вашим аккаунтам поддержки.
  • Мониторинг упоминаний руководителей: Следите за упоминаниями и ответами, адресованными аккаунтам руководства, чтобы оценивать реакцию отрасли на анонсы.

Практические советы по Twitter Mentions API

  • results_limit должен быть кратен 20 (например, 20, 40, 100), чтобы соответствовать размеру страниц у источника.
  • Строки дат ISO, например 2026-09-01, сервер автоматически преобразует в метки времени Unix в UTC.
  • Этот эндпоинт возвращает посты с упоминанием аккаунта; чтобы получить собственные исходящие посты аккаунта, используйте X User Posts.
  • Используйте вместе с X Post Replies, чтобы детально отслеживать ветки обсуждений, выросшие из значимых постов с упоминаниями.

Помимо Twitter Mentions API, используйте эти API, когда нужен другой тип публичных данных X.

  • Twitter Tweet Scraper API — Получайте по URL статусов x.com или twitter.com текст публичных постов, авторов, вовлеченность, медиа, хештеги, упоминания и связи в обсуждении.
  • Twitter Profile Scraper API — Получайте по имени пользователя публичные данные аккаунта, описание, аватар, обложку, статус аккаунта и видимую статистику аудитории.
  • Twitter User Tweets Scraper API — Собирайте свежие публичные посты, авторов, медиа, хештеги, упоминания и вовлеченность по имени пользователя без ответов.
  • X Post Quotes API — Собирайте публичные цитаты известных URL статусов: комментарий, авторы, вовлеченность, медиа, метки времени и контекст исходного поста.
  • X Community Posts API — Получайте публичные посты сообщества: текст, авторы и счетчики взаимодействий.
  • X Thread Context API — Получайте пост вместе с предыдущими сообщениями в цепочке ответов, публичными ответами и ID связей.

Другие платформы

Объединяйте данные X с публичными данными других поддерживаемых соцсетей.

Twitter Mentions API — FAQ

Twitter Mentions API собирает публичные посты, в которых упоминаются указанные имена пользователей на платформе X. Он возвращает нормализованные данные постов, сведения об авторах, метки времени и метрики вовлеченности в пределах необязательного диапазона дат.

Нет. Эндпоинт запрашивает публично доступные упоминания, используя только публичные имена пользователей; OAuth клиентского аккаунта или токены входа пользователя не требуются.

Поставщик данных выдает упоминания отдельными страницами по 20 элементов, поэтому запросы должны соответствовать этому шагу.