Communities
X community tweets route for keyword search
Search the tweets inside one X (Twitter) Community by keyword on the communities/tweets path, with the same inputs, pages and results as Community search.
- 200
- 400
- 401
- 402
- 424
- 429
- 502
- 503
GET
X community tweets route for keyword search
1 credit per result returned · All plans from $0.00012/credit · Supports guest paid reads
The same search on another path
GET /x/communities/tweets searches the tweets inside one Community, exactly as
Community search does on GET /x/communities/search. Both take the same
communityId, q, queryType, cursor, and pageSize, and answer the same page of tweets.
Keep this path when your integration already uses it. New integrations can use either.
Query parameters
string
required
Numeric ID of the Community whose tweets you want to search.
string
required
Search query for the Community’s tweets.
string
Sort order.
Top returns the most relevant tweets, Latest the most recent. Defaults to Latest.string
Pagination cursor from a previous response. Omit for the first page.
number
Upper bound for tweets per page. Range: 1-100. Default:
20.Tweet filters
These filters narrow the search and the rows it returns, as on Community search.string
Filter to posts from this username. The
@ prefix is optional.string
Filter to replies directed to this username.
string
Filter to posts that mention this username.
string
Only include posts with this language code.
string
Include posts created on or after this date or timestamp.
string
Include posts up to this date or timestamp. A date is a UTC day, inclusive, so its own posts count.
string
Use
images, videos, gifs, media, links, or none.integer
Require this minimum like count.
integer
Require this minimum repost count.
integer
Require this minimum reply count.
integer
Require this minimum quote count.
integer
Require this minimum view count.
integer
Require this minimum bookmark count.
integer
Allow this maximum like count. Missing counts pass.
integer
Allow this maximum repost count. Missing counts pass.
integer
Allow this maximum reply count. Missing counts pass.
integer
Allow this maximum quote count. Missing counts pass.
boolean
When
true, only return posts from Blue-verified authors.boolean
When
true, only return posts from verified authors.string
Use
include, exclude, or only for replies.
This setting overrides includeReplies when the endpoint supports both.string
Use
include, exclude, or only for reposts.string
Match this literal phrase, including any hyphens.
string
Exclude comma-separated or whitespace-separated terms.
string
Require at least 1 comma-separated or whitespace-separated term.
string
Match these hashtags. Separate values with commas or spaces.
string
Match these cashtags. Separate values with commas or spaces.
string
Use
include, exclude, or only for quote posts.string
URL substring or domain that must appear in tweet URL entities.
string
Filter to tweets in this conversation thread.
string
Only include replies to this tweet ID.
string
Filter to quote tweets of this tweet ID.
string
Filter to retweets of this tweet ID.
string
Return Tweets whose IDs exceed this ID.
string
Return Tweets at or below this ID.
boolean
When
true, only return native reposts.string
Match Tweets from this recent window, such as
90m or 7d. Use a whole number & s, m, h or d.Headers
string
Full account key. Sessions and OAuth also work.
string
Bearer xq_your_guest_key_here for paid_reads.Response
200 OK
The same page as Community search:tweets, has_next_page, and
next_cursor.
Related. Community search · Community tweets · Community details