Boolean query builder for social listening

discatch uses one query syntax across every source. Type a query here and see how the planner translates it for Hacker News, Discourse, GitHub, Mastodon, YouTube, and the web index. The prescore inputs are shown beside the parse.

Query

Type a query in the discatch syntax

Parse

Phrases	"your product", "yourdomain.com"
Excluded	competitor
Operators	OR

Per-source translation

Source	Translated query
Web (via the web index)	q="your product" "yourdomain.com" -competitor
Hacker News	query=%22your%20product%22%20%22yourdomain.com%22&tags=(story,comment) (excluded terms re-filtered locally)
Discourse	/search.json?q=%22your%20product%22%20%22yourdomain.com%22
GitHub	q=%22your%20product%22%20%22yourdomain.com%22+in:title,body
Mastodon	q=%22your%20product%22%20%22yourdomain.com%22 (per-instance; hashtags only unless full text enabled)
YouTube	q=%22your%20product%22%20%22yourdomain.com%22 (Data API on videos; comments matched locally)
Bluesky	Local match on Jetstream: "your product" "yourdomain.com" (boolean evaluated in normalizer)

Every source’s results are re-filtered locally against the full boolean query.

Prescore inputs

Signal	Weight	From this query
Exact phrase hit	0.35	Yes: "your product", "yourdomain.com"
Term coverage	0.25	2 terms to match
Title hit	0.15	Depends on the result
Recency	0.10	Decays over 30 days
Engagement	0.10	Log of replies plus score
Source weight	0.05	Per account, learnable

The API call for this query

curl -X POST https://api.discatch.com/v1/search \
  -H "Authorization: Bearer $DISCATCH_KEY" \
  -d '{ "query": "\"your product\" OR \"yourdomain.com\" -competitor", "sources": ["hackernews", "discourse", "web"], "since": "7d" }'

The syntax

Pattern	Meaning	Example
term	A word to match	supabase
"phrase"	An exact phrase	"supabase auth"
A OR B	Either term	supabase OR firebase
A AND B	Both terms (AND is implied)	supabase AND pricing
-term or NOT term	Exclude a term	supabase -firebase
site:domain	Restrict to a domain or path	site:reddit.com/r/webdev
author:@handle	Restrict to an author	author:@pg
lang:code	Language filter	lang:en
(A OR B) C	Grouping	(supabase OR firebase) pricing

Syntax from docs/query-language.md.

Per-source translation

Each source has a native search language. The planner maps the discatch query into it. Every source’s results are re-filtered locally against the full boolean query, so a source with a weaker native language still returns correct results from a larger candidate set.

Source	How the planner maps it
Web (via the web index)	Native operators pass through; site: and quotes map directly
Hacker News	query plus tags and numericFilters for since
Discourse	Per-forum /search.json?q= with after: and category:
GitHub	Search API qualifiers: in:title,body, repo:, is:issue
Mastodon	Per-instance search; hashtags only unless full text is enabled
YouTube	Data API q on videos, local match on comments
Bluesky	Local term match on the Jetstream stream; boolean evaluated in the normalizer

Translation rules from docs/query-language.md.

Prescore

Prescore is a free, non-LLM relevance estimate in [0, 1]. It ranks and filters but does not decide relevance. That is the caller’s model, or the classify flag.

Signal	Weight
Exact phrase hit	0.35
Term coverage	0.25
Title hit	0.15
Recency (decays over 30 days)	0.10
Engagement (log of replies plus score)	0.10
Source weight (per account, learnable)	0.05

Prescore weights from docs/query-language.md.

Use from an agent

Planned. The query syntax is the proposed interface from docs/query-language.md.

curl

curl -X POST https://api.discatch.com/v1/search \
  -H "Authorization: Bearer $DISCATCH_KEY" \
  -d '{ "query": "\"your product\" OR \"yourdomain.com\"", "sources": ["hackernews", "discourse", "web"], "since": "7d" }'

MCP · coming in phase 3

{
  "tool": "search",
  "arguments": {
    "query": "\"your product\" OR \"yourdomain.com\"",
    "sources": [
      "hackernews",
      "discourse",
      "web"
    ],
    "since": "7d"
  }
}

Questions

Does discatch support regex?

No. Regex is not part of v1. The syntax supports quoted phrases, boolean operators, site:, author:, and lang: filters.

Are queries case-sensitive?

No. Terms are case-insensitive. Plurals and simple stems match.

What happens if a source does not support an operator?

The planner translates the query into the source’s native language as closely as it can. Results are then re-filtered locally against the full boolean query, so correctness is preserved.

What is the difference between NOT and a minus sign?

They mean the same thing. supabase -firebase and supabase NOT firebase both exclude results matching firebase.

Can I search Reddit with this syntax?

Reddit is planned. When it ships, the same syntax applies. Today, indexed Reddit posts arrive as web results when you search across the web source.

What are Reddit search operators?

Reddit’s native search has site:, subreddit:, and flair: operators. discatch wraps these in one syntax so you do not need to learn per-source operators. site:reddit.com/r/webdev works.

Does this tool make API calls?

No. The query builder runs entirely in your browser. No data is sent anywhere.

What does prescore mean?

A free relevance estimate between 0 and 1. It is not an LLM call. It weights exact phrase hits, term coverage, title hits, recency, and engagement. The agent can filter on it to skip low-quality results.

Last reviewed 2026-09-10 by Parsa Khazaeepoul, founder, dcouple. Copy from docs/query-language.md.