XTwitterсписки Xсообщества XX Spacesруководство по API

Новые эндпоинты X API: списки, сообщества, Spaces, статьи и местоположение аккаунта

14 новых эндпоинтов SocQ для X (Twitter): местоположение аккаунта, верифицированные подписчики, проверка подписок, списки, сообщества, медиа и ответы, статьи Articles, Spaces и транскрипты видео.

SocQОбновлено 19 ноября 2026 г.8 мин чтения

Эндпоинты SocQ для X уже возвращали публичные профили, публикации, ленты, поиск, ответы, цитаты, подписчиков и тренды; они описаны в руководстве по сбору данных X/Twitter. 2026-11-17 на странице платформы X заработали еще 14. Они дотягиваются до тех частей X, которые были недоступны базовым эндпоинтам: панель «Об этом аккаунте», списки, участники и модераторы сообществ, вкладки «Медиа» и «Ответы» пользователя, длинные статьи Articles, Spaces и речь в видео.

В этом руководстве они сгруппированы по задачам: для каждого приведены один запрос и цена.

Коротко: отправьте JSON-тело на POST https://api.socq.ai/v1/x/<endpoint>. Сохраните возвращенный task_id, опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, затем читайте data.results.items. Все 14 эндпоинтов стоят 0.7 кредита ($0.0035) за результат, за одним исключением для длинных видео в Video Transcript.

Новые эндпоинты X вкратце

1 кредит SocQ = $0.005. Базовой платы нет, поэтому пустой результат ничего не стоит.

ЭндпоинтЧто возвращаетЦена
X Account Location APIСтрана, в которой находится аккаунт, способ подключения к X, дата регистрации, смены имени пользователя0.7 кредита ($0.0035) за аккаунт
X Verified Followers APIВерифицированные аккаунты, подписанные на профиль0.7 кредита ($0.0035) за подписчика
Twitter Follow Checker APIФлаги «подписан», «подписан в ответ» и «взаимная подписка» для до 100 пар0.7 кредита ($0.0035) за пару
X List Tweets APIЛента списка от новых к старым, с отметкой репостов0.7 кредита ($0.0035) за публикацию
Twitter List Members APIАккаунты в списке в виде полных профилей0.7 кредита ($0.0035) за участника
Twitter List Followers APIАккаунты, подписанные на список, в виде полных профилей0.7 кредита ($0.0035) за подписчика
X Communities Search APIСообщества, совпадающие с ключевым словом, с числом участников и URL0.7 кредита ($0.0035) за сообщество
X Community Members APIУчастники сообщества в виде полных профилей0.7 кредита ($0.0035) за участника
X Community Moderators APIАдминистраторы и модераторы сообщества0.7 кредита ($0.0035) за модератора
Twitter Media Scraper APIПубликации с вкладки «Медиа» аккаунта с файлами в полном качестве0.7 кредита ($0.0035) за публикацию
X User Replies APIОтветы, написанные аккаунтом, каждый с публикацией, на которую он отвечает0.7 кредита ($0.0035) за ответ
X Articles APIЗаголовок статьи, строка превью, полный текст, обложка и вовлеченность0.7 кредита ($0.0035) за статью
X Spaces APIСтатус Space, расписание, ведущие, спикеры, слушатели и записи0.7 кредита ($0.0035) за Space
Twitter Video Transcript APIПроизнесенный текст видео из публикации с его длительностью0.7 кредита ($0.0035) за видео длиной до 2 минут

Аутентификация и асинхронные задачи

Все запросы аутентифицируются API-ключом. Один и тот же заголовок используется для отправки задачи, проверки статуса и получения результатов:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Каждый сбор данных выполняется как фоновая задача:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

Вызов отправки сразу возвращает data.task_id и data.status. Опрашивайте задачу по этому ID:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Когда status равен succeeded, ответ содержит result_count, credits_amount и первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500. Если results.has_more равно true, передайте results.next_cursor как cursor, чтобы прочитать следующую страницу. Задача с ошибкой содержит error_message.

Каждый эндпоинт ниже также принимает необязательный callback_url. SocQ отправит один POST со сводкой задачи после ее завершения; записи читайте через эндпоинт задачи. Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же ID задачи, а не отправляйте ее повторно. 402 означает, что у аккаунта закончились кредиты, а 429 — что ключ достиг лимита запросов или кредитов.

Примечание о results_limit: для Verified Followers и эндпоинтов участников списков и сообществ он применяется к каждому входному значению, по умолчанию равен 100 и должен быть кратен 20 в диапазоне от 20 до 2000. Для Communities Search он должен быть кратен 10 в диапазоне от 10 до 500.

Проверка аккаунтов и связей

Account Location читает панель «Об этом аккаунте»: country, connected_via (например, United States App Store или Web), дату регистрации, username_changes_count и affiliate_username. Используйте его для проверки инфлюенсеров и выявления скоординированных аккаунтов. У некоторых аккаунтов, например у многих государственных, страна не указана; для них все равно возвращается строка с country: null. (документация)

curl -X POST "https://api.socq.ai/v1/x/user-about" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["elonmusk", "BBCWorld"]}'

Verified Followers возвращает список, который X показывает на вкладке верифицированных подписчиков. Каждая строка — это верифицированный подписчик (actor), связанный с аккаунтом, о котором вы спросили (related_actor). Используйте его, чтобы оценить влиятельную часть аудитории или составить список для аутрича из подписчиков конкурента. (документация)

curl -X POST "https://api.socq.ai/v1/x/verified-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["NASA"], "results_limit": 20}'

Follow Checker сравнивает один username с до 100 usernames. Каждая пара возвращает is_following, is_followed_by и is_mutual. Используйте его, чтобы убедиться, что участники кампании подписаны на ваш бренд. (документация)

curl -X POST "https://api.socq.ai/v1/x/check-follow" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "usernames": ["SpaceX", "NASA"]}'

Чтение списков X

Все три эндпоинта принимают URL публичных списков в форме /i/lists/{numeric_id}.

List Tweets возвращает ленту списка от новых к старым. Репосты сохраняются и помечаются is_repost, а также reposted_post_id и reposted_author, чтобы их можно было отфильтровать. Один запрос позволяет следить за целой нишей. (документация)

curl -X POST "https://api.socq.ai/v1/x/list-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

List Members выгружает аккаунты из списка в виде полных профилей с био, местоположением, сайтом, верификацией и числом подписчиков, подписок и публикаций. Вручную составленный список — готовая отправная точка для поиска потенциальных клиентов. (документация)

curl -X POST "https://api.socq.ai/v1/x/list-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

List Followers возвращает аккаунты, подписанные на список, в той же структуре профиля. Подписка на список — это заявленный интерес к его теме, поэтому такие аккаунты образуют точный сегмент для исследований. (документация)

curl -X POST "https://api.socq.ai/v1/x/list-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

Карта сообществ X

Communities Search находит сообщества по ключевому слову с названием, числом участников, баннером, is_nsfw и URL сообщества. (документация)

curl -X POST "https://api.socq.ai/v1/x/search-communities" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "bitcoin", "results_limit": 20}'

Передайте URL сообщества (/i/communities/{numeric_id}) в Community Members, чтобы получить его участников в виде полных профилей. (документация)

curl -X POST "https://api.socq.ai/v1/x/community-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 20}'

Community Moderators возвращает всю команду, включая администраторов, за один запрос. Это контакты для спонсорства или AMA. (документация)

curl -X POST "https://api.socq.ai/v1/x/community-moderators" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/communities/1493446837214187523"]}'

Описание и правила сообщества разобраны в руководстве по данным сообществ, а его публикации — в руководстве по публикациям сообществ.

Медиа и ответы аккаунта

Оба эндпоинта принимают один username; по умолчанию results_limit равен 20, допустимы значения от 1 до 1000.

Media Scraper возвращает публикации с вкладки «Медиа» аккаунта, от новых к старым, с текстом, вовлеченностью, просмотрами и медиафайлами. Видео указывают на MP4 в максимальном доступном качестве. (документация)

curl -X POST "https://api.socq.ai/v1/x/user-media" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "NASA", "results_limit": 20}'

User Replies возвращает вкладку «Ответы» аккаунта, от новых к старым. Каждый ответ содержит in_reply_to с текстом, автором, ссылкой и временем публикации, на которую дан ответ, поэтому каждая строка читается как полноценный обмен репликами. (документация)

curl -X POST "https://api.socq.ai/v1/x/user-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "results_limit": 20}'

Целые разговоры разобраны в руководстве по контексту веток.

Статьи, Spaces и речь в видео

Articles принимает URL публикации, в которой опубликована статья (/{username}/status/{post_id}), и возвращает title, строку превью как summary, полный текст в text, обложку, автора, а также лайки, ответы, цитаты и просмотры. Публикация, которая не является статьей, не возвращает строку; если ни один из URL не является статьей, задача завершается ошибкой и не оплачивается. (документация)

curl -X POST "https://api.socq.ai/v1/x/article" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/USDOL/status/2119796255089947070"]}'

Spaces принимает ссылки /i/spaces/{space_id}. Каждый Space возвращает название, status (запланирован, в эфире или завершен), scheduled_start_at, ведущих, спикеров, слушателей в эфире, просмотры записи и is_replay_available. (документация)

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"]}'

Video Transcript превращает речь в видео из публикации в простой текст с duration_seconds. Видео длиной до 2 минут стоит 0.7 кредита. Более длинное видео стоит 4 кредита ($0.02) за каждую начатую минуту его полной длительности, поэтому 3-минутное видео стоит 12 кредитов ($0.06). Публикации без видео не возвращают строку и не оплачиваются. (документация)

curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/NASA/status/2119833829389041896"]}'

Другие руководства по X

Чтобы сравнить SocQ с другими поставщиками данных X и официальным API, прочитайте Цены Twitter API и лучшие альтернативы X API, 7 лучших API для парсинга Twitter/X и Альтернативы TwitterAPI.io.

FAQ

Что возвращает X Account Location API, если X не указывает страну?

Строку, в которой country равен null. Остальные поля, например connected_via и дата регистрации, все равно возвращаются.

Почему results_limit должен быть кратен 20?

Таково правило для Verified Followers, List Tweets, List Members, List Followers и Community Members: от 20 до 2000 с шагом 20, применяется к каждому входному значению. Communities Search использует шаг 10 в диапазоне от 10 до 500.

Списываются ли кредиты за публикации, которые не являются статьями или не содержат видео?

Нет. Такие публикации не возвращают строку, а вы платите только за возвращенные строки. Если ни один из URL, отправленных в Articles API, не является статьей, задача завершается ошибкой и не оплачивается.

Сколько стоит транскрипт длинного видео?

До 2 минут — 0.7 кредита. Дольше — 4 кредита за каждую начатую минуту полной длительности, поэтому 3 минуты стоят 12 кредитов, а 5 минут — 20 кредитов ($0.10).

Можно ли проверить сразу много подписок?

Да. Follow Checker сравнивает один аккаунт с до 100 другими в одном запросе, по 0.7 кредита за пару.

X API

Проверить сценарий на публичном URL X

Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.

API для X