Social Fetch
Get API key

Free · No signup

Twitter advanced search query builder

Fill in plain fields — or describe what you're looking for — and get a precise, ready-to-run query for the X search API.

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.

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
Include repostsinclude:nativeretweetsKeep native reposts in results
Replies onlyfilter:repliesHide top-level posts

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

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 real X search operator.

01

One query string, fully assembled

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

02

Result type stays separate

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

03

Same operators as the API

from:, lang:, min_faves:, filter:, 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.

01

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.

02

The 512-character limit is enforced

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

03

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.

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
Read the API docs
Request

More free tools

Try another free tool

Try another free tool. Or browse all free tools.

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.

Get 100 free creditsPricing