Free · no signup
Boolean Query Translator.Check a query before you run it.
Paste a Boolean query and see what it finds and how each platform would search it.
Use in Claude or ChatGPTSame lookup, live, from your AI.Free · 60 checks a minute · Nothing is searched
Teams running monitoring, research, and enrichment pipelines
How it works
From pasted query to a plan you can trust
Three steps, no account needed.
- Step 1
Paste a query, or describe it
Paste a query from Talkwalker, Brandwatch, Meltwater, Onclusive or X advanced search as you'd run it there, and it works out which. Or describe what you want to monitor, and AI writes the query for you to review.
- Step 2
Read it back
See the query in Social Fetch syntax with every operator written out, and in plain words, so you can tell it finds what you meant.
- Step 3
Check each platform
See what X, Reddit, TikTok and the rest can search, what they'd miss, and the most a search would cost.
Reading queries
How Boolean queries read
The operators that trip people up most.
AND and OR need brackets when mixed
Tools read nike adidas OR puma differently, so it's an error here. Write (nike adidas) OR puma, or nike (adidas OR puma).
Quotes make a phrase
"agua potable" matches the two words together, in that order. Without quotes, each word can be anywhere in the post.
NEAR finds words close together
battery NEAR/5 fire matches posts where the two words are at most 5 words apart, in either order.
Filters narrow by who and where
author:, lang:, site: and type: narrow the posts a search finds. Most platforms also need a word or phrase to search for.
Good to know
Limits of the translator
What this page does and doesn't do.
Platforms search differently
Each platform's own search supports different operators. A search would cover what each can, then check every post against your full query.
Some clauses don't carry over
A tool's own filters, such as its sentiment scores, have no equivalent. A search would mark the posts that depend on them uncertain, not drop them.
Nothing is searched
Checking a query is free and runs no search. The credits shown are the most a search would cost. To run it, use Listening in the Social Fetch app.
AI writes, the query is checked
Describe it uses AI to write a query, labelled as such. What it finds, the plan and how it reads your example posts come from the query itself, never from the AI. Review it before you use it.
Six syntaxes today
Social Fetch syntax, Talkwalker, Brandwatch (and Cision Social Listening, which runs on it), Meltwater, Onclusive and X advanced search. A pasted query's tool is detected; if it guesses wrong, choose the tool yourself.
From code
Check queries from code
Check queries from your own code: the same translation, explanation and per-platform plan, as JSON.
- POST /v1/query/validate reads, explains and plans a query
- POST /v1/query/suggest writes one with AI from a description
- Imports Talkwalker, Brandwatch, Meltwater, Onclusive and X queries
- Free with an API key
More free tools
Try another free tool
Try another free tool. Or browse all free tools.
- Twitter / X
Twitter advanced search query builder
Plain fields in, precise X search query out.
Open tool - Reddit
Brand mention checker
Brand or competitor → recent Reddit mentions.
Open tool - Reddit
Reddit research tool
Topic → ranked Reddit posts and threads.
Open tool - X / Twitter
Twitter follower tracker
Understand who arrives, leaves and matters to you
Open tool
FAQ
Boolean query translator FAQ
What is a Boolean query?
A search written with AND, OR and NOT, quotes for exact phrases and brackets for grouping, such as ("acme" OR "acme corp") AND (recall OR lawsuit) NOT jobs. Social listening tools use them to say exactly which posts count.
Which queries can I paste?
Social Fetch syntax, and queries from Talkwalker, Brandwatch (and Cision Social Listening), Meltwater, Onclusive and X advanced search (from:, filter:, since: and the rest). The tool is detected from the query; you can pick it above the box instead. Imported queries are translated clause by clause, and anything with no equivalent is kept and marked, never dropped.
Can AI write the query for me?
Yes. Choose Describe it, say what you want to monitor in any language, and add example posts if you have them. AI writes a query in Social Fetch syntax, labelled as written by AI, and it's checked like any other: what it finds, how each platform would search it and how it reads your examples. Ask it to refine the query, such as also exclude job ads, or edit it yourself.
What does "No equivalent" mean?
That clause has no match in Social Fetch, such as a tool's own sentiment filter. A search would keep the posts that depend on it and mark them uncertain, rather than drop them silently.
Why does a platform say "Some parts"?
Each platform's own search can't do everything. TikTok can't search for an account's posts, for example, and most platforms ignore wildcards. A search would cover what the platform can, then check every post it finds against your full query.
Why does a platform say "Nothing"?
It can't search any part of the query, so it would return nothing. A query made only of filters, such as site: or lang:, needs at least one word or phrase for most platforms to search.
Does checking a query cost anything?
No. Checking is free and nothing is searched. The credits shown are the most a search with this query would cost.
Is my query stored?
A query you check isn't searched or shared. Like every request to Social Fetch, it's kept in our operational logs for about 30 days, then deleted. A description you give Describe it, and its example posts, are sent to an AI model to write the query, after email addresses, phone numbers and keys are removed; Social Fetch logs only their length, not what you wrote.
Can I check queries from code?
Yes. POST /v1/query/validate does the same check with your API key, also free, and returns the same result as JSON.
Need more than a spot check?
Get 100 free API credits and pull public posts from X, Reddit, TikTok and more.