Эндпоинты 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 | Сообщества, совпадающие с ключевым словом, с числом участников и URL | 0.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