HushSearchDocs

Web Search

Real-time web search returning LLM-ready JSON results.

SearchFree demo, no key

POST/v1/search/1 credit

curl -X POST https://api.hushsearch.io/v1/search/ \
  -H "X-API-Key: hs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "best open-source vector databases",
  "num_results": 5
}'

Real-time web search through private SearXNG metasearch, which queries engines such as Google, Bing and DuckDuckGo and fuses their results. Returns clean, structured results ready for LLM context injection.

Request

curl -X POST https://api.hushsearch.io/v1/search/ \
  -H "X-API-Key: hs_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best RAG frameworks 2026",
    "num_results": 5,
    "categories": ["general"],
    "time_range": "month"
  }'

Parameters

ParameterTypeRequiredDefaultDescription
querystring✅—The search query
num_resultsinteger10Max results to return (1–50)
categoriesstring[]allFilter: general, news, science, it
enginesstring[]allOverride engines: google, bing, duckduckgo
time_rangestringnoneday, week, month, year
safe_searchinteger00 = off, 1 = moderate, 2 = strict

Response

{
  "results": [
    {
      "title": "LlamaIndex vs LangChain for RAG in 2026",
      "url": "https://example.com/rag-comparison",
      "snippet": "A comprehensive comparison of the two leading RAG frameworks..."
    }
  ],
  "credits_used": 1,
  "credits_remaining": 499,
  "response_time_ms": 412
}

Python Example

import requests

response = requests.post(
    "https://api.hushsearch.io/v1/search/",
    headers={"X-API-Key": "hs_live_..."},
    json={
        "query": "Apple Intelligence API integration guide",
        "num_results": 5,
        "categories": ["general", "it"]
    }
)

data = response.json()
for result in data["results"]:
    print(result["title"], result["url"])

Error Codes

CodeMeaning
401Invalid or missing API key
402Insufficient credits
429Rate limit exceeded (100 req/min)
503Search engine temporarily unavailable