Search
Operators, products and limits.
GET /v1/tweets/search?q=... runs X advanced search. q accepts the operators from the x.com search box.
Operators that work
| Operator | Example | Meaning |
|---|---|---|
from: | from:x | tweets by an account |
to: | to:x | replies to an account |
@ | @x | mentions |
since: until: | since:2026-09-01 until:2026-09-17 | date range, UTC |
min_faves: min_retweets: min_replies: | min_faves:100 | engagement floor |
-filter:replies | no replies | |
filter:links filter:media filter:images filter:videos | only tweets with that content | |
lang: | lang:de | language |
"..." | "exact phrase" | phrase |
OR - () | (cat OR dog) -filter:retweets | boolean |
url: | url:github.com | link domain |
Products
product | Returns | Credits |
|---|---|---|
Latest (default) | tweets, newest first | 1 per tweet |
People | profiles | 1 per profile |
Top | tweets by relevance | 1 per tweet |
Photos, Videos | tweets with that media | 1 per tweet |
Top is not served to every reading session at X. When it is not available the API answers 403 product_unavailable
and charges nothing. Latest is always available.
Limits
- Up to 50 tweets per page. Use
cursorfor more. - Search results are cached for 60 seconds. A repeated query within that window costs half.
- Deleted, protected and age-restricted tweets do not appear.