whtsky SearXNG Search
Search via SearXNG instance. URL can be overridden with SEARXNG_URL environment variable (default: http://127.0.0.1:8888).
Usage
SEARXNG_URL="${SEARXNG_URL:-http://127.0.0.1:8888}"
curl -s "$SEARXNG_URL/search?q=QUERY&format=json"
Parameters
| Param | Description | Example |
|---|---|---|
q |
Search query (URL encoded) | q=hello%20world |
format |
Output format | format=json |
categories |
Search categories | categories=general,images,news |
engines |
Specific engines | engines=google,duckduckgo |
time_range |
Filter by time | time_range=day / week / month / year |
pageno |
Page number | pageno=2 |
⚠️ Do NOT use language parameter — it often degrades results (many engines ignore it or return worse matches). Let SearXNG use its default language settings. Chinese queries in Chinese characters will naturally return Chinese results.
Example
# Basic search
SEARXNG_URL="${SEARXNG_URL:-http://127.0.0.1:8888}"
curl -s "$SEARXNG_URL/search?q=rust%20programming&format=json" | jq '.results[:5]'
# Chinese search — just use Chinese query text, no language param needed
curl -s "$SEARXNG_URL/search?q=%E6%96%B0%E9%97%BB&format=json&time_range=week"
Response
JSON with results array. Each result has:
title- Page titleurl- Linkcontent- Snippetengine/engines- Source engine(s)score- Relevance score
When to Use
- User explicitly requests SearXNG
- Need results from multiple search engines aggregated
- Privacy-focused search needed