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
| Name | Type | Required | Description |
|---|---|---|---|
query | text | No | Free-text search query |
Output ports
| Name | Type | Required | Description |
|---|---|---|---|
results | json | No | Search hits with title/url/snippet/engine/category |
suggestions | json | No | SearXNG's spell-correction or related-query hints |
status | text | No | ok | not_found | unreachable | rate_limited | query_error |
total_results | number | No | Total hits before pagination |
Settings
Basic
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Query | query | string | No |
Filters
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Categories | categories | string | No | CSV: general, news, images, videos, files, social_media, science, music, map, it | ||
| Language | language | string | No | ISO code: en, es, es-ES, pt-BR … | ||
| Time range | time_range | enum | No | "", day, week, month, year | ||
| Safesearch | safesearch | enum | No | 0 | 0, 1, 2 |
Advanced
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Page (1-indexed) | page | number | No | 1 |
Errors
| Code | Description |
|---|---|
SEARXNG_BASE_URL_REQUIRED | SEARXNG_BASE_URL env var is not set |
SEARXNG_USER_AGENT_REQUIRED | SEARXNG_USER_AGENT env var is not set |
QUERY_REQUIRED | query 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: Bearerfor 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.
¿Algo no está claro? Envíe sus comentarios sobre la documentación por correo electrónico..