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.

ParameterRequiredWhat it does
qRequiredThe search query. Accepts the same operators you type into X advanced search, for example from:elonmusk min_faves:500 since:2026-01-01.
productOptionalLatest for a reverse-chronological real-time feed, or Top for the most-engaged tweets that match. Defaults to Latest.
cursorOptionalPagination 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

OperatorMatchesExample
from:usernameTweets sent by one accountfrom:elonmusk
to:usernameReplies directed at one accountto:nasa
filter:verifiedOnly tweets from verified accountsai agents filter:verified
min_faves:NTweets with at least N likessolana min_faves:1000
min_retweets:NTweets with at least N repostslaunch min_retweets:50
since: / until:A date window (YYYY-MM-DD)nvda since:2026-01-01 until:2026-03-01
lang:xxTweets in one languagemundial lang:es
geocode:lat,long,rTweets near a point and radiusprotest 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

productReturnsBest forFreshness
LatestReverse-chronological, newest firstLive monitoring, alerting, firehose ingestionReal-time, tweets seconds old
TopRanked by engagement, highest firstSentiment summaries, highlight reels, digestsRecent, 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

OptionPriceAuthRate limitsReal-time
GetXAPI$0.05 / 1,000 tweetsBearer token, 30s signupNo rate limitsLatest and Top, seconds-fresh
Official X API search$5+ / 1,000 reads, $200/mo floorX developer account, app approvalHard monthly read caps per tierRecent search, 7-day window on lower tiers
RapidAPI Twitter search wrappers$0.20 to $0.50 / 1,000RapidAPI key per providerPlan quota, throttledVaries by provider
Free libraries (twscrape, twikit)$0 plus your proxy and computeSession cookies or tokensIP bans within hoursBreaks 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.