TweetAPI

Twitter Advanced Search Query Builder

Build a precise Twitter search from structured inputs, understand every operator, and carry the validated query into a ready-to-run TweetAPI request.

Words

Every plain word must appear. Add operators with the structured fields below.

Compiled inside quotation marks.

Plain words compiled as one parenthesized OR group.

Each plain word is safely negated.

Separate multiple hashtags with commas or spaces.

The dollar sign is optional.

Accounts and dates

Multiple accounts are joined with OR.

Useful for brand monitoring without the brand's own posts.

Matches replies directed to one account.

Multiple mentions are joined with OR.

Use a 2–3 letter ISO code. Language detection may be imperfect.

Inclusive UTC date.

Exclusive UTC date.

More filters
TweetAPI result type

Generated query

Result type: Latest

Needs attention
Your compiled search query will appear here.
Character count0 / 512

Add at least one keyword, account, date, or filter.

Already have an account?

Running opens GET /tw-v2/search in the existing playground with this query and result type prefilled. Anonymous visitors never execute a TweetAPI search.

Operator quick reference

from:account
Posts from an account
@account
Posts mentioning an account
since:YYYY-MM-DD
On or after a UTC date
until:YYYY-MM-DD
Before a UTC date
min_faves:number
Minimum likes
filter:images
Posts containing images
filter:replies
Replies only
lang:code
Detected language
View every supported search operator

Try a stateless example

Presets replace the current form only. Nothing is saved to an account or server.

TweetAPI is a third-party API. Not affiliated with X Corp.

Build precise searches without memorizing syntax

The workbench turns explicit choices into the advanced-search syntax supported by TweetAPI. It keeps the form as the source of truth, so raw text can never silently become a hidden operator.

Compose deterministically

Combine words, phrases, accounts, ordinary dates, media, language, engagement, and result type through validated fields.

Inspect before you run

See the exact compiled query, operator explanation, validation state, and backend-aligned 512-character count.

Keep one activation path

Signed-in users hand the same query to GET /tw-v2/search in the existing API playground—never to an anonymous live-results preview.

A focused query workbench, not an autonomous search agent

Manual mode is unlimited and runs in the browser. Optional AI interpretation is narrowly bounded: OpenAI fills a validated form object, then deterministic code compiles the final query. It cannot execute searches, take account actions, or save presets.

  • No API key, X cookie, password, or account connection requested
  • No anonymous TweetAPI search or live result preview
  • No raw description or generated query sent to PostHog analytics
  • No query history, saved presets, autonomous monitoring, or write actions

From query to authenticated API request

Copying is public. Running is intentionally different: the query is kept only in same-tab session storage through signup or signin, then loaded into the existing authenticated playground. Search terms never need to appear in the handoff URL.

Read the search API referenceGenerate Snowflake boundaries
  1. 01Build or interpret a structured form and resolve every validation error.
  2. 02Inspect the compiled query, result type, explanation, and character count.
  3. 03Copy it publicly, or sign up/sign in to preserve it in the same browser tab.
  4. 04Choose an owned API key in the TweetAPI playground and explicitly run the request.

Frequently asked questions

Can I use the Twitter advanced search builder without an account?

Yes. The deterministic manual builder, validation, query explanation, presets, character count, and copy action work anonymously without limits. An account is required only to execute the query in TweetAPI's authenticated playground.

Does this page search Twitter for anonymous visitors?

No. Anonymous visitors never trigger a TweetAPI search or receive live results. The page only builds and inspects a query locally, apart from optional AI interpretation and privacy-safe aggregate analytics.

What does the AI mode do?

AI mode uses OpenAI to translate a natural-language description into the same validated structured form. OpenAI does not compile or execute the final query; deterministic code performs both validation and compilation.

Why is the query limited to 512 characters?

TweetAPI's current GET /tw-v2/search validation accepts queries up to 512 characters. The counter and blocking validation match that backend contract.

How do dates work in advanced search?

since:YYYY-MM-DD is inclusive and until:YYYY-MM-DD is exclusive. Both are interpreted as ordinary UTC date boundaries. Snowflake ID and timestamp conversion remains available in TweetAPI's separate timestamp converter.

Operators and limits last verified against the TweetAPI search documentation and backend contract on August 15, 2026. TweetAPI is not affiliated with X Corp.