x/
community-posts

Получайте публичные посты по ссылкам на сообщества X: текст постов, авторы и счетчики вовлеченности в одном ответе, с отдельным лимитом результатов для каждого сообщества.

X Community Posts API

Обсуждения в сообществах
Текст постов и авторы
Лимит на каждое сообщество
0,7 кредита за результат
Готово
Готово

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

README

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

X Community Posts

Посты сообществ X — это сообщения внутри тематического сообщества, у каждого из которых есть автор, время публикации, текст и прикрепленные медиафайлы, если они есть. Чтение этих постов вместе со счетчиками взаимодействий помогает упорядочить материалы обсуждения и сравнить отдельные посты, из которых складывается публичная беседа сообщества.

Возможности X Community Posts API

  • Посты из указанного вами сообществаНачинайте со ссылки на сообщество, чтобы собрать публичные обсуждения в нем, а не набор постов, опубликованных в профиле одного человека.
  • Отдельный лимит для каждого сообществаЕсли вы передаете несколько ссылок на сообщества, results_limit применяется к каждой из них, а посты собираются в порядке времени создания, поэтому входные данные задают объем сбора для каждого пространства обсуждений.
  • Сообщение и сопутствующие сведения вместеКаждая запись поста содержит текст, данные об авторе, время публикации, медиафайлы и доступные счетчики взаимодействий, поэтому сообщение можно изучать, не теряя информации о том, кто и когда его опубликовал.

Параметры X Community Posts API

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный список ссылок на публичные сообщества X с числовым ID сообщества, например https://x.com/i/communities/1493446837214187523; в песочнице указывайте по одной ссылке на строку, а в коде используйте JSON-массив urls, но не ссылки на профиль, поиск или отдельный пост.
results_limitНеобязательныйНеобязательное максимальное число постов на сообщество; по умолчанию 100, допускаются значения, кратные 20, от 20 до 2000, например 20, 40 или 100; при двух ссылках на сообщества и лимите 20 каждое сообщество может дать до 20 постов.

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

Запрос запускает фоновую задачу сбора, поэтому первый ответ содержит ID задачи, а не готовые данные; по этому ID проверяйте ход выполнения и получайте результаты.

  1. Скопируйте ссылки на сообщества, которые хотите читать, и выберите лимит на сообщество, например 20 или 100; используйте ссылку на сообщество, а не URL отдельного поста.
  2. Перед запуском примера замените $SOCQ_API_KEY своим API-ключом или задайте эту переменную окружения. Отправьте входной JSON на POST /v1/x/community-posts с заголовком Authorization, как показано ниже, и сохраните task_id из ответа.
  3. Проверяйте ход выполнения через GET /v1/tasks/{task_id} с сохраненным ID. queued означает ожидание, running — идет сбор, retrying — выполняется повторная попытка. Читайте результаты только после succeeded; если задача в статусе failed, причину смотрите в error_message.
  4. После успешного завершения читайте data.results.items: каждый элемент этого списка описывает один пост сообщества. Пустой список означает, что задача завершилась, не вернув ни одной записи.
  5. Если data.results.has_more равно true, значение next_cursor указывает на следующую страницу сохраненных результатов. Скопируйте его без изменений в параметр cursor запроса GET /v1/tasks/{task_id}?cursor=... и продолжайте, пока has_more не станет false.
curl -X POST "https://api.socq.ai/v1/x/community-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/communities/1493446837214187523"],"results_limit":20}'

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

  • Материал для дайджеста обсуждений: Соберите полученный текст постов, имена авторов, ссылки и время в список для чтения, по которому человек или отдельный инструмент суммаризации сможет написать дайджест этих постов.
  • Сравнение счетчиков поста между снимками: Сохраняйте ID постов и возвращенные счетчики вместе со временем сбора, а затем сопоставляйте те же посты в последующих сборах, чтобы самостоятельно вычислять изменения доступных счетчиков.
  • Контекст беседы вокруг выбранного поста: Выберите пост из результатов сообщества и передайте его URL в X Thread Context, чтобы прочитать доступные более ранние посты и ответы вокруг этого сообщения.

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

  • Планируя пакет, умножьте число ссылок на сообщества на results_limit, чтобы оценить запрашиваемое число записей, а затем применяйте ставку за пост, не считая, что лимит общий для всех сообществ.
  • При повторном сборе сопоставляйте посты по ID, прежде чем добавлять их в сохраненную таблицу, потому что пост может снова появиться в более поздней задаче.
  • Храня результаты из нескольких сообществ, сохраняйте переданные ссылки на сообщества вместе с входными данными задачи: стандартная запись поста не гарантирует наличия ID сообщества, который мог бы заменить этот контекст.

Помимо X Community Posts API, используйте эти API, когда нужен другой тип публичных данных X.

  • Twitter Tweet Scraper API — Получайте по URL статусов x.com или twitter.com текст публичных постов, авторов, вовлеченность, медиа, хештеги, упоминания и связи в обсуждении.
  • Twitter User Tweets Scraper API — Собирайте свежие публичные посты, авторов, медиа, хештеги, упоминания и вовлеченность по имени пользователя без ответов.
  • X Post Quotes API — Собирайте публичные цитаты известных URL статусов: комментарий, авторы, вовлеченность, медиа, метки времени и контекст исходного поста.
  • Twitter Mentions API — Собирайте публичные посты с упоминанием заданного аккаунта.
  • X Thread Context API — Получайте пост вместе с предыдущими сообщениями в цепочке ответов, публичными ответами и ID связей.
  • X List Tweets API — Читайте ленту списка от новых постов к старым: репосты помечены, а их оригинальные авторы указаны.

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

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

X Community Posts API — FAQ

X Community Posts API — это программный интерфейс для чтения публичных постов по списку ссылок на сообщества X. Он возвращает текст постов, авторов, медиафайлы, метки времени и счетчики взаимодействий в порядке времени создания, с лимитом результатов для каждого сообщества.

Сообщество объединяет посты, опубликованные в этом пространстве обсуждений, а лента профиля — посты одного аккаунта. Здесь передавайте ссылки на сообщества; если отправная точка — имя пользователя аккаунта, используйте X User Posts.

Нет. Это до 100 постов для каждой ссылки на сообщество. Например, для трех сообществ можно запросить до 300 постов в сумме, хотя публичная доступность и удаление дублей могут уменьшить итоговое число записей.

Лимит должен меняться с шагом 20, поэтому используйте значения вроде 20, 40, 60 или 100. Допустимый диапазон — от 20 до 2000, значение по умолчанию — 100.

Нет. Курсор задачи позволяет прочитать следующую страницу результатов, которые эта задача уже сохранила. Он не увеличивает исходный лимит на сообщество и не запускает новый сбор.

Нет. Он возвращает записи постов, которые можно читать, упорядочивать или передавать в отдельный процесс суммаризации. Готовое резюме или анализ в ответ не входят.

Каждый возвращенный пост стоит 0,7 кредита без базовой платы. Для двух ссылок на сообщества с лимитом 100 оценка составит 140 кредитов; если задача вернет всего 30 постов, итоговое списание составит 21 кредит.