Sign in
OpenAPI 3.1.02026-08-20127121510.9 KB

352bea67aca5

Communities

Search tweets within an X Community

Requires a Community ID and keyword query.

get/api/v1/x/communities/tweets

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.

minFavesinteger

Minimum likes threshold. minLikes 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": [
    {
      "id": "1234567890",
      "text": "Just launched our new feature!",
      "retweetCount": 5,
      "replyCount": 3,
      "likeCount": 42,
      "quoteCount": 1,
      "viewCount": 1500,
      "bookmarkCount": 2
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}