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.
- Отправьте {"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]} методом POST на /v1/x/space.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте каждый 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 спикеров как ключ, чтобы один и тот же человек учитывался один раз даже после смены имени пользователя.
Связанные API
Помимо 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, дату регистрации и число смен имени пользователя.
- 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 Community Posts API
- X Thread Context 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
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API