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 проверяйте ход выполнения и получайте результаты.
- Скопируйте ссылки на сообщества, которые хотите читать, и выберите лимит на сообщество, например 20 или 100; используйте ссылку на сообщество, а не URL отдельного поста.
- Перед запуском примера замените $SOCQ_API_KEY своим API-ключом или задайте эту переменную окружения. Отправьте входной JSON на POST /v1/x/community-posts с заголовком Authorization, как показано ниже, и сохраните task_id из ответа.
- Проверяйте ход выполнения через GET /v1/tasks/{task_id} с сохраненным ID. queued означает ожидание, running — идет сбор, retrying — выполняется повторная попытка. Читайте результаты только после succeeded; если задача в статусе failed, причину смотрите в error_message.
- После успешного завершения читайте data.results.items: каждый элемент этого списка описывает один пост сообщества. Пустой список означает, что задача завершилась, не вернув ни одной записи.
- Если 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 сообщества, который мог бы заменить этот контекст.
Связанные API
Помимо 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 — Читайте ленту списка от новых постов к старым: репосты помечены, а их оригинальные авторы указаны.
- Twitter Profile Scraper API
- 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 Account Location API
- X Verified Followers API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API