Skip to main content
POST
X Communities Search API

X Communities Search

Find X communities by keyword. Each result is a community with its name, member count, banner image and whether it is marked as sensitive, along with the community URL you can pass straight to X Community Members, X Community Moderators or X Community Posts. It is the starting point for mapping where a topic is discussed on X and which groups are big enough to matter.
Provide a keyword in query. results_limit defaults to 20 and must be a multiple of 10 between 10 and 500. A keyword with no matching communities returns an empty result. Search results carry each community’s name, member count, banner and sensitive-content flag; the description, rules and join policies come from X Community.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide a keyword in query. results_limit defaults to 20 and must be a multiple of 10 between 10 and 500.

query
string
required

Search query.

Minimum string length: 1
callback_url
string<uri>
results_limit
integer
default:20
Required range: 10 <= x <= 500Must be a multiple of 10

Response

Task accepted

code
integer
data
object