Search & Trends
/v1/search/advanced accepts the same operators the X web UI does: from:elonmusk, to:binance, since:2026-01-01, min_faves:100, $SOL, #bitcoin, lang:en, -filter:replies. Results are live, not cached, which is what makes it usable for event detection and sentiment work.
The product parameter changes what you get: Latest is chronological (the default), Top ranks by engagement, Media returns only posts with images or video.
Two endpoints are search under the hood but exposed separately because they answer distinct questions: /v1/user/mentions (who is talking to an account) and /v1/tweet/quotes (who quoted a post). Use those rather than hand-writing the query syntax.
For trends, /v1/trends gives you what's trending globally. /v1/trends/place narrows it to a specific country or city — call /v1/trends/locations once to get the 467 region IDs, then cache that list since it's effectively static.
On billing: a completed lookup is billable even when the answer is empty — confirming that a handle doesn't exist is still a lookup we performed for you. Requests we reject outright (a missing or malformed parameter, HTTP 400) are free, and you are never billed for an error on our side.
Advanced Search
Full X search syntax: from:, since:, min_faves, hashtags.
{ "status": "success", "data": [
{ "text": "bitcoin breaking out...",
"author": { "username": "..." } }
], "meta": { "count": 20 } }Search Users
Find users by keyword.
{ "status": "success", "data": [ ...users ] }Trends
Current trending topics.
{ "status": "success", "data": [
{ "name": "Bitcoin", "domain": "Trending in Finance" }
] }Today's News
Trending topics with news headlines + hot tweets.
{ "status": "success", "data": {
"trends": [ { "name": "..." } ],
"tweets": [ { "text": "..." } ] } }Regional Trends
Trends for a specific region across 467 locations — neither competitor offers this.
{ "status": "success", "data": {
"trends": [ { "name": "#Bitcoin", "tweet_volume": 125000 } ] },
"meta": { "count": 50, "woeid": 1 } }Trend Regions
The 467 WOEIDs accepted by /v1/trends/place. Static data — cache it.
{ "status": "success", "data": [
{ "name": "Worldwide", "woeid": 1 } ], "meta": { "count": 467 } }