Free · no signup

Twitter advanced search.Query builder, no syntax.

Describe what you want, get a ready-to-run X search query. Run it through our search API.

Use in Claude or ChatGPTSame lookup, live, from your AI.

Start from a template

One click fills the form. Nothing is saved.

KeywordsWhat should the posts say? Fill what matters, skip the rest.
AND

Posts must contain all of these words.

"…"

Matches this phrase word for word.

OR

Matches when at least one word appears.

−word

Hides posts containing any of these.

TagsTags join with OR automatically.
#tag

Up to 12, comma or space separated. The # is optional.

$TICKER

Up to 12 tickers. The $ is optional.

PeopleFilter by who posted, who they reply to, or who they mention.
from:

Only posts from these accounts.

−from:

Hides posts from these accounts.

to:

Replies directed at this account.

@handle

Posts that mention these accounts.

Date and languageBound the search in time, or filter by language.
since:

Oldest posts to include.

until:

Stops before this date.

lang:

Filters by detected post language.

EngagementOnly posts above the bar. Leave blank for no minimum.
min_faves:

Likes floor.

min_retweets:

Reposts floor.

min_replies:

Replies floor.

Content filtersToggles add filter operators to your query.

Use the API's default post-type behavior. No retweet operator is added in the default mode.

Media

Any mediafilter:mediaPhotos, video, or links
Photosfilter:imagesPosts carrying photos
Videosfilter:videosPosts carrying video
Linksfilter:linksPosts with a URL

Post type

Verified authorsfilter:verifiedLegacy verified accounts
Premium authorsfilter:blue_verifiedX Premium subscribers
Replies onlyfilter:repliesHide top-level posts

Manual building is free and unlimited · API pages accept up to 20 posts · AI fill is 5/min · 25/day · Queries run in the playground or API, never here

99.8% uptime#3 Product of the Day3,200+ developers

Teams running monitoring, research, and enrichment pipelines

How it works

From idea to query in under a minute

Three steps. No operator cheat-sheet required.

  1. Step 1

    Fill in plain fields

    Start from a template, or fill only the fields you care about. You can also describe the search in plain English and let AI fill the form.

  2. Step 2

    Watch the query build itself

    Every keystroke updates the live preview, with a length meter that keeps you inside the 512-character API limit.

  3. Step 3

    Copy it or run it

    Copy the query for your own code, or open it in the playground and run it with an API key.

Under the hood

What the builder writes for you

Every field maps to a supported search operator for this API.

One query string, fully assembled

Words, tags, accounts, dates, language, and engagement floors are joined into a single query — quoted, grouped, and ordered correctly.

Result type stays separate

Top, Latest, People, Photos, and Videos travel as the section parameter, exactly as GET /v1/twitter/search expects.

Supported operators for the API

from:, lang:, min_faves:, filter:, retweet modes, and the rest. What you copy here is what the API runs.

Good to know

What this page doesn't do

Honest boundaries, so there are no surprises.

It builds queries, it doesn't search

Live results need an API key. Open the playground — the query is filled in for you — or paste it into your own code.

The 512-character limit is enforced

Copy and playground actions unlock only when your query is non-empty and fits the API limit.

AI fill is metered, building isn't

Manual building is unlimited. Describe with AI gets 5 fills a minute and 25 a day, guarded by an invisible bot check.

Pages return up to 20 posts

The API accepts up to 20 posts per request, and a page may contain fewer. When data.page.hasMore is true, pass data.page.nextCursor as cursor for the next page.

Ideas

Three searches worth building

Starting points you can adapt in seconds.

Watch your brand

Your exact brand phrase, minus posts from your own handle. Mentions only, no noise.

Research a moment in time

A few topic words bounded by a from and to date. Made for launches, events, and news cycles.

Find posts that already worked

A topic plus a like floor surfaces proven angles before you write a word.

From code

Run the same search from code

The builder hands you the query — the API hands you the posts. Same operators, same query string, live results.

  • GET /v1/twitter/search — paste your compiled query
  • Pick Top, Latest, People, Photos, or Videos via section
  • Pay per completed search page — building here is free
Request

FAQ

Twitter advanced search builder FAQ

Do I need an account to use the builder?

No. Building, previewing, and copying are free without signup. You only need an API key when you want to run the query and get live results.

Does this page show live posts from X?

No — it's a builder, not a search engine. It assembles your query in the browser. Paste the result into the playground or API to fetch posts.

Why is there a 512-character limit?

That's the maximum query length the search API accepts. The live counter keeps you inside it, and copy unlocks only when the query fits.

Is the copied query the same one the API uses?

Exactly. The query string plus the result type you pick (Top, Latest, People, Photos, Videos) plug straight into GET /v1/twitter/search.

How do the date fields work?

From date is inclusive, to date is exclusive — both plain UTC calendar dates, written as since: and until:.

What does Describe with AI do?

It turns a plain-English description into filled-in form fields. You review everything, and the query still compiles in your browser. It never searches X for you.

Is there a limit on AI descriptions?

Manual building is unlimited. AI fill allows 5 per minute and 25 per day.

How do I run my query?

Copy it, then call GET /v1/twitter/search with your API key — or open the playground, where the endpoint and query are already filled in.

What about hashtag-only discovery?

That's a different endpoint: GET /v1/twitter/hashtags. This builder targets operator-rich search queries.

100 free credits

Need more than a spot check?

Get 100 free API credits and run your first compiled query in the playground today.