Ко всем API
Публичные данные X

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. 1. Отправьте входные данные

    Отправьте имена пользователей, URL статусов, список аккаунтов, поисковый запрос или числовые WOEID в нужный API.

  2. 2. Отслеживайте задачу

    Используйте task_id с /v1/tasks/{task_id}, пока обработка не завершится.

  3. 3. Получите результаты

    Читайте data.results.items и используйте next_cursor, пока has_more равно true.

Начните с одного запроса к API

Пройдите аутентификацию с 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 в виде нормализованной записи с доступными полями автора, подписи, медиа, аудио, временных меток, длительности и вовлеченности.