Twitter Search API
The GetXAPI Twitter/X search API queries the live firehose with full advanced-search operators and returns structured JSON at $0.05 per 1,000 tweets. Search by author, keyword, date range, language, or engagement floor, in real time, with no developer account and no rate limits.
Why use a Twitter search API
You can search X by hand in the web app, but the moment you need search inside a product, a dashboard, an alert, or an AI agent, you need it as an endpoint. The official X API does offer search, and it is the supported channel, but the economics and the gates put it out of reach for a lot of teams:
- Cost and a monthly floor. Official search reads start near $5 per 1,000 behind a paid tier, so even a modest monitoring job carries a recurring monthly minimum before you read a single tweet.
- Approval and tier caps. You apply for a developer account, wait on review, then run into hard read caps and a short lookback window on the lower tiers. The throttle, not your code, sets the ceiling.
- Or you build your own and it breaks. Free libraries that read X internals get IP-banned and break on the next site change, so you trade the monthly bill for proxy rotation and constant patching instead.
GetXAPI is the managed middle path. One Bearer key, one documented search endpoint, structured JSON back, and $0.05 per 1,000 tweets with no monthly floor and no rate-limit caps. You write a query, you get matching tweets, and you do not maintain any of the infrastructure underneath.
How the search endpoint works
Search lives at one endpoint, GET /twitter/tweet/advanced_search. You send a query in the q parameter, pick a product ranking, and page through results with cursor. Each call is $0.001 and returns about 20 tweets.
| Parameter | Required | What it does |
|---|---|---|
| q | Required | The search query. Accepts the same operators you type into X advanced search, for example from:elonmusk min_faves:500 since:2026-01-01. |
| product | Optional | Latest for a reverse-chronological real-time feed, or Top for the most-engaged tweets that match. Defaults to Latest. |
| cursor | Optional | Pagination token returned with each response. Pass it back to fetch the next page of results until the cursor is empty. |
Search tweets in one request
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.getxapi.com/twitter/tweet/advanced_search?q=from:elonmusk&product=Latest"The response is structured JSON with a cursor for the next page, so there is no HTML to parse and no proxy to rotate. Read the advanced search endpoint docs.
Search operators you can pass to q
| Operator | Matches | Example |
|---|---|---|
| from:username | Tweets sent by one account | from:elonmusk |
| to:username | Replies directed at one account | to:nasa |
| filter:verified | Only tweets from verified accounts | ai agents filter:verified |
| min_faves:N | Tweets with at least N likes | solana min_faves:1000 |
| min_retweets:N | Tweets with at least N reposts | launch min_retweets:50 |
| since: / until: | A date window (YYYY-MM-DD) | nvda since:2026-01-01 until:2026-03-01 |
| lang:xx | Tweets in one language | mundial lang:es |
| geocode:lat,long,r | Tweets near a point and radius | protest geocode:40.7,-74,10km |
Operators combine in a single query, for example from:elonmusk min_faves:500 since:2026-01-01. For the full operator list, combination recipes, and edge cases, read the Twitter advanced search operators guide.
Latest vs Top: the product parameter
| product | Returns | Best for | Freshness |
|---|---|---|---|
| Latest | Reverse-chronological, newest first | Live monitoring, alerting, firehose ingestion | Real-time, tweets seconds old |
| Top | Ranked by engagement, highest first | Sentiment summaries, highlight reels, digests | Recent, weighted by likes and reposts |
Omit the parameter and the endpoint defaults to Latest. Switch to Top when you care about the highest-engagement tweets for a query rather than the newest ones.
GetXAPI search vs the official X API and other options
| Option | Price | Auth | Rate limits | Real-time |
|---|---|---|---|---|
| GetXAPI | $0.05 / 1,000 tweets | Bearer token, 30s signup | No rate limits | Latest and Top, seconds-fresh |
| Official X API search | $5+ / 1,000 reads, $200/mo floor | X developer account, app approval | Hard monthly read caps per tier | Recent search, 7-day window on lower tiers |
| RapidAPI Twitter search wrappers | $0.20 to $0.50 / 1,000 | RapidAPI key per provider | Plan quota, throttled | Varies by provider |
| Free libraries (twscrape, twikit) | $0 plus your proxy and compute | Session cookies or tokens | IP bans within hours | Breaks on every X change |
Pricing, plain and flat
$0.05
per 1,000 tweets searched
$0.10
free credits at signup, no card
$0
subscription, you pay per call only
Every search call is $0.001 and returns about 20 tweets, so 1,000 tweets lands near $0.05. See the full breakdown on the Twitter API pricing page or estimate your monthly spend with the Twitter API cost calculator.
If you need more than search
Search is one endpoint. If you also need full timelines, followers, and profiles, the broader Twitter scraper covers the wider surface on the same key. To wire search into an AI agent, use the MCP server.
Twitter search API FAQ
GetXAPI charges $0.001 per call to the advanced_search endpoint, and each call returns about 20 tweets, so searching 1,000 tweets costs roughly $0.05. There is no subscription and no minimum. The official X API search starts at $5 per 1,000 reads behind a $200 per month floor, so GetXAPI is the cheapest managed path to search tweets at volume. You start with $0.10 in free credits, no card required.
You do not need an X developer account or the official OAuth flow. You do need a GetXAPI key, which is a single Bearer token you copy after a 30-second signup. That key authenticates every search request. There is no app review, no per-endpoint approval, and no waiting period, so you can run your first query in under a minute.
No fixed per-minute or per-day rate limit caps the search endpoint. You pay per call at $0.001, so cost scales with usage rather than a tier ceiling. That makes it practical to run scheduled firehose pulls or backfill a date range without hitting the throttles that gate the official X API search tiers.
Each response includes a cursor token. Pass that token back in the cursor parameter on your next request to fetch the following page, and repeat until the cursor comes back empty. This lets you walk a full result set for a query or a date window without holding state on the server side.
Yes. Set product to Latest and the advanced_search endpoint returns a reverse-chronological feed with tweets that are seconds old, which is what you want for live monitoring and alerting. Set product to Top and you get the most-engaged tweets that match your query instead. Both run against the live X index, not a stale cache.
Yes. The q parameter accepts the same operators you type into X advanced search: from:, to:, filter:verified, min_faves:, min_retweets:, since:, until:, lang:, and geocode:. You can combine them in a single query, for example from:elonmusk min_faves:500 since:2026-01-01. For the full operator reference and combination recipes, read the Twitter advanced search operators guide.
The product parameter controls ranking. Latest returns matching tweets in reverse-chronological order, newest first, which suits real-time monitoring. Top returns the same matches ranked by engagement, highest first, which suits sentiment digests and highlight feeds. Latest is the default if you omit the parameter.
The search API is the query endpoint: you hand it operators and it returns matching tweets. A broad Twitter scraper pulls whole timelines, followers, profiles, and media on top of search. Both run on the same Bearer key and the same flat $0.001 per call. If you only need to search by query, this endpoint is the focused path; if you need full account data, the Twitter scraper covers the wider surface.
Search X without an X account
$0.05 per 1,000 tweets. $0.10 free credits. Real-time and Top results, no developer account, no rate limits.
Next read
Continue exploring related pages:
Twitter scraper API
Scrape tweets, profiles, and followers via a managed API at $0.05 per 1,000, no developer account.
Twitter API use cases
14 use cases from sentiment analysis to lead generation.
Twitter API pricing and X API pricing comparison
Compare monthly economics and derived request-level cost.
Twitter followers API
Export any account's followers and following with cursor pagination, $0.05 per 1,000.