HushSearchDocs

Find Similar

Find pages similar to a URL or a passage of text.

SearchFree demo, no key

POST/v1/search/similar1 credit

Request
curl -X POST https://api.hushsearch.io/v1/search/similar \
  -H "X-API-Key: hs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://fastapi.tiangolo.com/",
  "num_results": 5
}'

Give a URL or a block of text and get back pages that cover the same ground, ranked by semantic similarity.

Parameters

FieldTypeDefaultNotes
urlstring—Page to find neighbours for. Provide url or text.
textstring—Passage to find neighbours for.
num_resultsinteger10Number of results.
modestring—neural, hybrid or personal_first (prefers your private index).
include_domains / exclude_domainsstring[]—Restrict or exclude domains.
exclude_source_domainboolean—Drop results from the source URL's own domain.
start_published_date / end_published_datedatetime—Publication date window (ISO 8601).
categorystring—Soft category hint.

Response

The same shape as Web Search: results[] with title, url and snippet, plus credits_used, credits_remaining and response_time_ms.

On this page