X Public Data API
Собирайте публичные профили, списки подписчиков и подписок, посты, ответы, цитаты, пользователей, сделавших ретвит, результаты поиска и текущие тренды. Используйте единообразные результаты для исследований и мониторинга.
Доступные API X
Выберите API по исходным данным: имя пользователя, URL поста, список аккаунтов, поисковый запрос или известный числовой WOEID.

x/profiles
Профили0,6 кредита за результат

x/followers-list
Профили0,5 кредита за результат

x/posts
Публикации0,5 кредита за результат

x/post-retweeters
Профили0,5 кредита за результат

x/user-posts
Публикации0,5 кредита за результат

x/search
Поиск0,7 кредита за результат

x/following-list
Профили0,5 кредита за результат

x/post-quotes
Публикации0,5 кредита за результат

x/post-replies
Комментарии0,5 кредита за результат

x/trends
Поиск0,5 кредита за результат

x/mentions
Публикации0,7 кредита за результат

x/search-users
Поиск0,6 кредита за результат

x/community
Профили0,5 кредита за результат

x/community-posts
Публикации0,7 кредита за результат

x/thread-context
Публикации0,5 кредита за результат

x/user-about
Профили0,7 кредита за результат

x/verified-followers
Профили0,7 кредита за результат

x/list-posts
Публикации0,7 кредита за результат

x/list-members
Профили0,7 кредита за результат

x/list-followers
Профили0,7 кредита за результат

x/community-members
Профили0,7 кредита за результат

x/community-moderators
Профили0,7 кредита за результат

x/search-communities
Поиск0,7 кредита за результат

x/article
Публикации0,7 кредита за результат

x/space
Публикации0,7 кредита за результат

x/user-media
Публикации0,7 кредита за результат

x/user-replies
Комментарии0,7 кредита за результат

x/check-follow
Профили0,7 кредита за результат

x/post-transcript
Публикации0,7 кредита за результат
Какие данные X можно получить?
Собирайте датасет вокруг идентификации аккаунтов, известного контента, недавней активности публикаций, поиска постов или текущих тем, привязанных к местоположению.
Публичные профили аккаунтов
Превращайте имена пользователей в идентификационные данные профиля, описание, визуальные материалы, статус аккаунта, метрики аудитории, списки подписчиков и подписок и время сбора.
Данные известных постов
Превращайте публичные URL статусов в данные поста, ответы, цитаты, профили пользователей, сделавших ретвит, медиа, связи и видимую вовлеченность.
Недавние посты аккаунта
Собирайте недавние публичные посты выбранных пользователей без ответов и сравнивайте активность в списке аккаунтов.
Поиск постов
Ищите публичные посты по одному запросу, выбирайте сортировку latest или top и сохраняйте связь запроса с каждым совпадением.
Текущие тренды по WOEID
Собирайте привязанный к местоположению снимок названий трендов, позиций в источнике, запросов, описаний и времени наблюдения.
SocQ vs продукты X для разработчиков
SocQ создан для единообразных сценариев исследования публичных данных. Продукты X для разработчиков поддерживают интеграции, которыми управляет X, по правилам собственных продуктов и требований к авторизации.
| Сценарий | Эндпоинты X в SocQ | Продукты X для разработчиков |
|---|---|---|
| Кому подходит | Обогащение профилей, исследование постов, мониторинг и поиск публичных тем | Интеграции приложений и аккаунтов под управлением X |
| Входные данные | Имена пользователей, URL статусов, списки аккаунтов, поисковое выражение или известные WOEID | Запросы конкретного продукта и контекст авторизованного аккаунта |
| Аутентификация | API-ключ SocQ | Учетные данные разработчика X и соответствующая авторизация |
| Формат данных | Нормализованные записи профилей, постов и трендов | Нативные ответы X конкретного продукта |
| Модель обработки | Асинхронная задача с последующей пагинацией результатов | Жизненный цикл запросов и ответов конкретного продукта |
Как работает API X
Все API X используют одну и ту же схему: отправка, отслеживание и получение результатов.
1. Отправьте входные данные
Отправьте имена пользователей, URL статусов, список аккаунтов, поисковый запрос или числовые WOEID в нужный API.
2. Отслеживайте задачу
Используйте task_id с /v1/tasks/{task_id}, пока обработка не завершится.
3. Получите результаты
Читайте data.results.items и используйте next_cursor, пока has_more равно true.
Пройдите аутентификацию с API-ключом SocQ и отправьте одно или несколько имен пользователей X. Посты, посты пользователей, поиск и тренды работают по той же схеме задач.
curl -X POST "https://api.socq.ai/v1/x/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa","@OpenAI"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueТипичные сценарии использования API X
Исследование авторов и партнеров
Обогащайте известные имена пользователей, сравнивайте публичные сигналы аккаунтов и формируйте единообразные профили авторов.
Мониторинг брендов и рынка
Следите за выбранными аккаунтами, повторяйте стабильные поисковые запросы или фиксируйте тренды для известных WOEID, чтобы собирать датасеты с временными метками о брендах, конкурентах и темах.
Отчеты по контенту кампаний
Получайте данные по URL постов кампании и систематизируйте контент, авторов, медиа, связи и вовлеченность на момент сбора.
Исследования и продукты на основе данных
Используйте единообразные записи профилей и постов в хранилищах данных, классификаторах, поисковых индексах, инструментах проверки и дашбордах.
Ограничения и политика публичных данных
SocQ возвращает общедоступные данные X в том виде, в каком они видны во время выполнения задачи.
- Счетчики профилей и вовлеченность постов — это снимки с привязкой к collected_at.
- Результаты поиска следуют выбранной сортировке latest или top на момент сбора.
- Позиции и описания трендов берутся из источника и относятся к запрошенному WOEID на момент сбора.
- results_limit задает максимум, но фактическое число результатов зависит от подходящих публичных записей, доступных во время выполнения задачи.
- API только читают публичные данные: они не публикуют посты и не управляют аккаунтами X.
Частые вопросы об API X
Что можно собрать с помощью API X?
Можно получать публичные профили, списки подписчиков и подписок, известные посты, недавние посты, ответы, цитаты, профили пользователей, сделавших ретвит, результаты поиска и текущие тренды для известных числовых WOEID.
Какой API X выбрать?
Используйте Profiles, Followers List или Following List для аккаунтов; Posts, Post Replies, Post Quotes или Post Retweeters для URL статусов; User Posts для недавней активности аккаунта; Search для поиска по запросу; Trends для известных числовых WOEID.
Как обрабатываются задачи?
Отправьте POST-запрос, опрашивайте /v1/tasks/{task_id}, затем читайте data.results.items и продолжайте с next_cursor, пока has_more равно true.
Что входит в каждый результат?
Результаты содержат поля, доступные для конкретного API: например, идентификационные данные профиля, контент и медиа поста или название тренда, позицию в источнике, WOEID, запрос, описание и время сбора.
Обновляются ли метрики X в реальном времени?
Нет. Счетчики аккаунтов, вовлеченность постов и позиции трендов — это снимки. При сравнении результатов используйте collected_at как время наблюдения.
Сколько стоит сбор данных X?
Profiles стоит 0,6 кредита за результат, прямые посты, посты пользователей и тренды — 0,5, а результаты поиска — 0,7.
Объединяйте данные разных платформ для более полной бизнес-аналитики
Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.
LinkedIn API
Получайте публичные данные профилей, компаний, публикаций и вакансий LinkedIn по известным URL с нормализованными полями идентичности, карьеры, компании, контента, вовлеченности и вакансии.
Reddit API
Получайте публичные публикации и комментарии Reddit по известным URL, просматривайте новые, лучшие или горячие публикации сабреддитов либо ищите обсуждения по ключевому слову и периоду публикации.
Pinterest API
Получайте публичные данные профилей Pinterest, разбирайте известные пины, собирайте пины выбранных профилей или ищите по ключевым словам, чтобы исследовать авторов, контент и визуальные тренды.
Threads API
Получайте публичные профили Threads, разбирайте известные публикации или собирайте публикации выбранных профилей с нормализованными полями идентификации, контента, медиа, вовлеченности и временных меток.
Bluesky API
Получайте публичные профили Bluesky, данные по известным URL публикаций или одну страницу публикаций аккаунта с нормализованными полями идентичности, контента, медиа, меток времени и видимой вовлеченности.
Snapchat API
Получайте известный публичный ролик Snapchat Spotlight в виде нормализованной записи с доступными полями автора, подписи, медиа, аудио, временных меток, длительности и вовлеченности.