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
Отправьте целевое имя пользователя и необязательный диапазон дат как асинхронную задачу, затем опрашивайте ее, чтобы получить записи упоминаний.
- Укажите одно или несколько имен в usernames и задайте results_limit кратным 20 (до 2 000).
- При необходимости укажите start_date и end_date, чтобы ограничить период сбора упоминаний.
- Отправьте POST-запрос на /v1/x/mentions со своим API-ключом SocQ.
- Опрашивайте /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, чтобы детально отслеживать ветки обсуждений, выросшие из значимых постов с упоминаниями.
Связанные API
Помимо 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 связей.
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API