Communities Search

The Communities Search endpoint lets you search for Communities by keyword. Reference for the X API v2 standard tier covering search.

The Communities Search endpoint lets you search for Communities by keyword. Discover Communities around topics of interest.

Overview

Keyword search

Search Communities by name and description

Discover

Find Communities to join

---

Endpoint

Method	Endpoint	Description
GET	/2/communities/search	Search for Communities

---

Parameters

Parameter	Description
query	Search query (required)
max_results	Results per page (max 100)
community.fields	Additional Community fields

---

Example request

curl "https://api.x.com/2/communities/search?\
query=Python&\
max_results=10&\
community.fields=name,description,member_count" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

Getting started

Prerequisites

• An approved developer account
• A Project and App in the Developer Console
• Your App’s keys and tokens

Communities lookup

Look up Communities by ID

API Reference

Full endpoint documentation