Search X (Twitter) feed
OpenAPI JSON Spec
Full-text search over the tweet corpus via the TweetSearchService
(ESSearch — BM25 ranking on full_text + multilingual analyzers).
Currently only the registry index is searched; pass an optional
handle to restrict the search to a single author.
q is optional: when omitted, the endpoint returns the latest
tweets (sorted by published_at DESC) within the time window.
Anti-scrape rule: when both q and handle are empty, since
must be within the last 30 days (default 30d if omitted). Pass
either q or handle to widen the window back to the 10y default.
Returns HTTP 501 if the upstream search backend is not configured.
Authorizations
API Key authentication. Example: "your-api-key-here"
Query Parameters
Search query (BM25 over full_text; #tag and @user route to filter clauses). Omit for reverse-chronological listing.
Restrict to tweets authored by this Twitter handle (no @, case-insensitive)
Start time (unix seconds)
End time (unix seconds)
Filter by content type
original, retweet, quote, reply Only return tweets with media when true
Max results (default 50, max 200)
Offset

