x/
search-communities

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

X Communities Search API

Ключевое слово на входе
Число участников сообщества
Признак деликатного контента
0,7 кредита за результат
Готово
Готово

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

README

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

X Communities Search

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

Возможности X Communities Search API

  • Одно ключевое слово — все подходящие сообществаУкажите слово или фразу в query, например bitcoin, и сообщества, которые X показывает по этому запросу, вернутся по одной строке на каждое.
  • Название и баннерname и cover_url дают название и баннер каждого сообщества — этого достаточно, чтобы узнать его в списке или показать в вашем собственном интерфейсе.
  • Число участников для оценки размераmetrics.members_count показывает, сколько людей вступило в сообщество, поэтому крошечную группу и сообщество из десятков тысяч участников можно различить прямо по результатам поиска.
  • Метка деликатного контентаis_nsfw равно true, когда сообщество отмечено в X как деликатное, что позволяет обработать пространства для взрослых до того, как они попадут в отчет или к пользователю.
  • Стабильный ID и ссылкаКаждая строка содержит числовой id сообщества и его url вида https://x.com/i/communities/<id>; они не меняются между поисками и служат ключом в ваших данных.

Параметры X Communities Search API

ПараметрыОбязательныйОписание
queryОбязательныйКлючевое слово для поиска сообществ X, например bitcoin.
results_limitНеобязательныйСколько сообществ вернуть: значение, кратное 10, от 10 до 500. По умолчанию 20.

Как использовать X Communities Search API

Выполните поиск по ключевому слову и постранично читайте найденные сообщества.

  1. Отправьте {"query": "bitcoin", "results_limit": 20} методом POST на /v1/x/search-communities.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте найденные сообщества из results.items; пока has_more равно true, запрашивайте следующую страницу с results.next_cursor.
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}'

# Each result's url can go straight into X Community Members, X Community Moderators or X Community Posts.

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

  • Карта того, где тема живет в X: Ищите по основным терминам рынка или хобби и собирайте названия сообществ, ссылки и число участников, которые показывают, где сосредоточено обсуждение.
  • Шорт-лист крупнейших сообществ ниши: Сортируйте найденные сообщества по metrics.members_count, чтобы выбрать несколько достаточно крупных, ради которых стоит спонсорство, пост или более пристальное изучение.
  • Безопасные для бренда списки сообществ: Удаляйте все строки, где is_nsfw равно true, прежде чем передавать список сообществ клиенту или показывать его в продукте.
  • Источник для выгрузки участников и модераторов: Передавайте url каждого отобранного сообщества в X Community Members или X Community Moderators, чтобы перейти от списка групп к людям, которые в них состоят.

Практические советы по X Communities Search API

  • Запускайте близкие варианты термина, например bitcoin и btc, и объединяйте результаты по id: одно сообщество может соответствовать нескольким ключевым словам.
  • Чтобы следить за ростом сообществ, повторяйте тот же query по расписанию и сохраняйте metrics.members_count вместе с collected_at для каждого id.

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

  • Twitter Search API — Находите публичные посты по поисковому выражению с сортировкой по новизне или популярности и настраиваемым лимитом результатов.
  • X Trends API — Собирайте текущие снимки публичных трендов X по известным числовым WOEID: позиция в источнике, запрос, описание и контекст местоположения.
  • Twitter User Search API — Находите публичные аккаунты X по ключевому слову.
  • X Community API — Получайте по ссылкам на сообщества описания, число участников, правила и порядок вступления.
  • X Community Posts API — Получайте публичные посты сообщества: текст, авторы и счетчики взаимодействий.
  • X Community Members API — Выгружайте участников сообщества в виде полных профилей с описанием и числом подписчиков.

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

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

X Communities Search API — FAQ

X Communities Search API — это программный интерфейс для поиска сообществ X, соответствующих ключевому слову. Для каждого сообщества он возвращает id, url, название, баннер, число участников и признак деликатного контента.

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

Да, в вашем собственном коде. Каждый результат содержит metrics.members_count, поэтому сначала соберите найденные сообщества, а затем отсортируйте их или задайте минимальный размер.

До 500. results_limit принимает значения, кратные 10, от 10 до 500, по умолчанию 20; читайте результаты постранично с next_cursor.

Значение true, когда X отмечает сообщество как содержащее деликатный контент, и false в остальных случаях.

Нет. Результаты поиска содержат название, баннер, число участников и признак деликатного контента. Передайте url в X Community API, чтобы получить описание, правила и условия вступления.

Ни одно сообщество ему не соответствует. Задача все равно завершается успешно с пустым результатом, и ничего не списывается.