HushSearchDocs

HushSearch documentation

One API for every kind of web data — search, scrape, crawl, browsers, documents and research.

HushSearch turns the web into data your code and agents can use: live search results, clean Markdown from any page, whole-site crawls, real browser sessions, PDF and OCR conversion, and cited research. Every endpoint takes the same X-API-Key header and reports what it cost and how long it took.

Your first request

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

Every response includes credits_used, credits_remaining and response_time_ms.

Call paths exactly as documented, including the trailing slash (for example /v1/search/). The bare path answers with a redirect, which curl -X POST and browsers' CORS preflights do not follow.

For AI agents

Paste the prompt into Claude Code, Cursor or any coding agent, or add HushSearch as an MCP server. The complete reference for language models is at /llms.txt.

Add HushSearch to your agent

Links use a placeholder key; replace hs_live_YOUR_KEY after installing.

Claude Code
claude mcp add --transport http hushsearch https://api.hushsearch.io/v1/mcp/ --header 'X-API-Key: hs_live_YOUR_KEY'
Other MCP hosts (JSON config)
{
  "mcpServers": {
    "hushsearch": {
      "url": "https://api.hushsearch.io/v1/mcp/",
      "headers": {
        "X-API-Key": "hs_live_YOUR_KEY"
      }
    }
  }
}
Prompt for your coding agent
You have access to HushSearch, one API for all web data (search, scrape, crawl, browser, extract, research, documents).
Base URL: https://api.hushsearch.io
Authenticate every request with the header "X-API-Key: $HUSHSEARCH_API_KEY".
Every response includes credits_used, credits_remaining and response_time_ms.
Full endpoint reference for LLMs: http://localhost:3000/llms.txt
Start with POST /v1/search/ {"query": "..."}, POST /v1/scrape/ {"url": "..."} and POST /v1/answer/ {"query": "..."}.
Call paths exactly as documented, including the trailing slash, so no redirect is needed.
Prefer POST /v1/jobs/ for crawls and research that may take longer than 30 seconds.
On HTTP 402 the key is out of credits; on 429 back off and retry after the Retry-After header.
MCP server config
{
  "mcpServers": {
    "hushsearch": {
      "url": "https://api.hushsearch.io/v1/mcp/",
      "headers": {
        "X-API-Key": "hs_live_YOUR_KEY"
      }
    }
  }
}

Endpoints

35 endpoints, one key.

Search

Web SearchPOST /v1/search/1 credit
Streaming SearchPOST /v1/search/stream1 credit
Batch SearchPOST /v1/search/batch1 credit / query
Find SimilarPOST /v1/search/similar1 credit

Answers & research

Cited AnswerPOST /v1/answer/4 credits
Deep ResearchPOST /v1/research/8 credits
Search & SummarizePOST /v1/search-and-summarize/5 credits
Context PackPOST /v1/context/2 credits
AgentPOST /v1/agent/4 credits

Scrape & extract

ScrapePOST /v1/scrape/2 credits
ExtractPOST /v1/extract/3 credits
ReaderGET /v1/reader/2 credits
ContentsPOST /v1/contents/2 credits / URL
Structured ExtractPOST /v1/structured-extract/4 credits
Search + ExtractPOST /v1/search-extract/6 credits
Multi-URL ExtractPOST /v1/multi-extract/4 credits

Crawl & map

MapPOST /v1/map/1 credit
CrawlPOST /v1/crawl/3 credits
Crawl PipelinePOST /v1/crawl/pipeline4 credits
Batch ScrapePOST /v1/batch-scrape/2 credits / URL

Browsers

ScreenshotPOST /v1/screenshot/3 credits
Browser SessionsPOST /v1/browser/sessions3 credits
Browser ExecutePOST /v1/browser-execute/2 credits
Agent ScrapePOST /v1/agent-scrape/5 credits

Documents

Render → DoclingPOST /v1/render-extract/6 credits
Docling MarkdownPOST /v1/docling-markdown/4 credits
Docling OCRPOST /v1/docling-ocr/3 credits
Docling StructuredPOST /v1/docling-structured/6 credits

Platform

EmbeddingsPOST /v1/embeddings/1 credit / input
RerankPOST /v1/rerank/1 credit
Async JobsPOST /v1/jobs/5 credits / job (research 8 · crawl 5 · batch 3 · multi-extract 4)
Change MonitorPOST /v1/change-monitor/2 credits
Knowledge LookupGET /v1/knowledge1 credit
EnrichPOST /v1/enrich4 credits
MCP ServerPOST /v1/mcp/billed per tool call