Zum Hauptinhalt springen

SearXNG — Metasearch

Category: Research
Node id: searxng

Standards: web-research, metasearch

Run a free-text query against a SearXNG metasearch instance. SearXNG aggregates Google/Bing/DuckDuckGo/Brave/Qwant/etc. behind one JSON API. Each result includes the underlying engine that produced it.

What it does​

  • Free-text web search via a SearXNG instance
  • Category, language, time-range, and safesearch filters
  • Per-result engine attribution (which underlying engine produced this hit)
  • Optional bearer-auth for protected/commercial SearXNG deployments

Use cases​

  • Diverse web search without single-engine bias
  • Privacy-respecting search (self-hosted SearXNG)
  • Compare ranking across engines

Runtime​

  • Performance tier: fast

Input ports​

NameTypeRequiredDescription
querytextNoFree-text search query

Output ports​

NameTypeRequiredDescription
resultsjsonNoSearch hits with title/url/snippet/engine/category
suggestionsjsonNoSearXNG's spell-correction or related-query hints
statustextNook | not_found | unreachable | rate_limited | query_error
total_resultsnumberNoTotal hits before pagination

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
QueryquerystringNo

Filters​

SettingNameTypeRequiredDefaultAllowed valuesDescription
CategoriescategoriesstringNoCSV: general, news, images, videos, files, social_media, science, music, map, it
LanguagelanguagestringNoISO code: en, es, es-ES, pt-BR …
Time rangetime_rangeenumNo"", day, week, month, year
SafesearchsafesearchenumNo00, 1, 2

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Page (1-indexed)pagenumberNo1

Errors​

CodeDescription
SEARXNG_BASE_URL_REQUIREDSEARXNG_BASE_URL env var is not set
SEARXNG_USER_AGENT_REQUIREDSEARXNG_USER_AGENT env var is not set
QUERY_REQUIREDquery input or config is empty

Runtime notes​

  • results output is empty when status is not ok — downstream nodes must check status
  • SEARXNG_BASE_URL and SEARXNG_USER_AGENT env vars are required or the node fails on first Execute
  • SEARXNG_API_KEY (optional) is sent as Authorization: Bearer for protected instances
  • Cache TTL is 30 minutes; pass bypass via your service config if you need fresh results

See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.

Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..