Sign in
latestOpenAPI 3.1.02026-08-21127127514.8 KB

18302a60cfee

Communities

Search tweets within an X Community by keyword

Returns tweets, not community records. Requires a Community ID.

get/api/v1/x/communities/search

Query parameters

communityIdstring required

Numeric ID of the community whose posts to search

qstring required

Search query

queryType'Latest' | 'Top'

Sort order (Latest or Top)

cursorstring

Pagination cursor for community search

pageSizeinteger

Maximum page items (1-100, default 20). Source, filters, or credits can reduce results. Continue while has_next_page is true. Deprecated limit and count aliases remain accepted.

languagestring

Language code filter, e.g. en or tr.

sinceDatestring date

Start date in YYYY-MM-DD format.

untilDatestring date

End date in YYYY-MM-DD format.

mediaType'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none'

Filter by media type.

minLikesinteger

Minimum likes threshold. minFaves is also accepted.

minRetweetsinteger

Minimum retweets threshold.

minRepliesinteger

Minimum replies threshold.

minViewsinteger

Minimum view count threshold.

verifiedOnlyboolean

Only return tweets from verified authors.

Response

Tweet search results from the selected X Community

filtered_countinteger
has_next_pageboolean required
next_cursorstring required

Example response

{
  "tweets": [],
  "has_next_page": false,
  "next_cursor": ""
}