Sign in
Communities

Search tweets within an X Community by keyword

Returns one tweet page, not community records.

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. Follow next_cursor while the response reports more pages. Deprecated limit and count aliases remain accepted.

languagestring

Filter by language. Alias lang is accepted.

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 media. Aliases: has_video, has_media.

minLikesinteger

Minimum likes. Aliases: minFaves, min_likes, min_faves.

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": ""
}

Changes