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
Выполните поиск по ключевому слову и постранично читайте найденные сообщества.
- Отправьте {"query": "bitcoin", "results_limit": 20} методом POST на /v1/x/search-communities.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте найденные сообщества из 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.
Связанные API
Помимо 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 — Выгружайте участников сообщества в виде полных профилей с описанием и числом подписчиков.
- Twitter Tweet Scraper API
- Twitter Profile Scraper API
- Twitter User Tweets Scraper API
- X Followers List API
- X Following List API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- Twitter Mentions API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Moderators API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API