x/
space

Получайте данные о X Spaces по ссылкам на них: название, статус, время начала, ведущие, спикеры, общее число слушателей в прямом эфире и воспроизведения записи для запланированных, идущих и завершенных Spaces.

X Spaces API

Ссылка на Space на входе
Ведущие и спикеры
Слушатели и воспроизведения записи
0,7 кредита за результат
Готово
Готово

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

README

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

X Spaces

X Spaces (бывшие Twitter Spaces) — это аудиокомнаты для живого общения в X, и у каждой из них есть название, статус, который меняется от запланированного к идущему в эфире и завершенному, главный ведущий с соведущими, приглашенные на сцену спикеры, а также число людей, слушавших эфир, и количество воспроизведений записи. Эти сведения позволяют отчитываться об охвате отдельного Space, следить за регулярным шоу от выпуска к выпуску и видеть, чьи голоса постоянно звучат на сцене в определенной сфере.

Возможности X Spaces API

  • Любая ссылка на Space на любом этапеПередавайте ссылки вида https://x.com/i/spaces/<id> на запланированные, идущие или уже завершенные Spaces, и для каждого вернется одна строка.
  • Статус и времяstatus принимает значения scheduled, live, ended или canceled; scheduled_start_at содержит запланированное время начала, а published_at — время создания Space.
  • Все, кто на сценеauthor — главный ведущий, hosts перечисляет ведущего и соведущих, а speakers — аккаунты, приглашенные выступить, у каждого с id, username, name, аватаром и признаком верификации.
  • Аудитория эфира и записиmetrics.live_listeners_count — общее число людей, слушавших Space в прямом эфире, а metrics.replay_views_count — число воспроизведений записи после эфира.
  • Доступность записиis_replay_available показывает, можно ли еще воспроизвести Space в X после его завершения.

Параметры X Spaces API

ПараметрыОбязательныйОписание
urlsОбязательныйСсылки на X Spaces вида https://x.com/i/spaces/<space_id>, по одной на строку; принимаются запланированные, идущие и завершенные Spaces.

Как использовать X Spaces API

Отправьте ссылки на Spaces и читайте по одной строке на каждый Space.

  1. Отправьте {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]} методом POST на /v1/x/space.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте каждый Space из results.items; для больших пакетов продолжайте передавать results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/x/space" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/spaces/1OdWgBerXWvaQz"]}'

# hosts repeats the main host from author and adds any co-hosts.

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

  • Отчет о Space, который вы провели или спонсировали: Добавьте live_listeners_count, replay_views_count и состав спикеров каждого Space в итоговый отчет о мероприятии для клиента или спонсора.
  • Отслеживание аудиошоу конкурента: Соберите ссылки на регулярные Spaces конкурента и сравнивайте слушателей, воспроизведения записи и гостей от выпуска к выпуску.
  • Список активных спикеров ниши: Соберите спикеров и соведущих Spaces в вашей сфере и посчитайте, как часто каждый аккаунт появляется на сцене.
  • Проверка состава запланированного Space: Прочитайте scheduled_start_at и hosts до мероприятия, а затем снова запросите Space, чтобы узнать, стал ли его статус ended или canceled.

Практические советы по X Spaces API

  • Соберите данные о Space еще раз, когда status станет ended, чтобы зафиксировать итоговое число слушателей эфира, и храните replay_views_count вместе с collected_at: пока is_replay_available равно true, число воспроизведений продолжает расти.
  • Считайте соведущими записи hosts без записи author: главный ведущий присутствует в обоих полях.
  • При объединении нескольких Spaces используйте id спикеров как ключ, чтобы один и тот же человек учитывался один раз даже после смены имени пользователя.

Помимо X Spaces 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 статусов: комментарий, авторы, вовлеченность, медиа, метки времени и контекст исходного поста.
  • Twitter Mentions API — Собирайте публичные посты с упоминанием заданного аккаунта.
  • X Account Location API — Узнавайте страну, в которой находится аккаунт, способ подключения к X, дату регистрации и число смен имени пользователя.

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

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

X Spaces API — FAQ

X Spaces API — это программный интерфейс для получения данных о X Spaces, аудиокомнатах для живого общения в X, по их ссылкам /i/spaces/. Для каждого Space он возвращает название, статус, запланированное время начала, главного ведущего, соведущих, спикеров, общее число слушателей эфира, число воспроизведений записи и доступность записи.

Да. metrics.live_listeners_count — общее число людей, слушавших Space в прямом эфире, а metrics.replay_views_count показывает, сколько раз запись воспроизвели после эфира.

Нет. Слушатели передаются только в виде счетчиков. Аккаунты с именами в результате — это главный ведущий, соведущие и спикеры.

Нет. Результат описывает Space и его аудиторию; is_replay_available показывает, можно ли воспроизвести запись в X.

Если ни один из переданных Spaces не найден, задача завершается ошибкой, а кредиты возвращаются полностью. Если не хватает только некоторых, остальные возвращаются как обычно.