Search Extract
Search the web, rerank results, and extract structured data in one call — 6 credits per call.
Scrape & extractLong-running: consider /v1/jobs
POST/v1/search-extract/6 credits
Request
curl -X POST https://api.hushsearch.io/v1/search-extract/ \
-H "X-API-Key: hs_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "open-source vector databases",
"schema_fields": [
"name",
"license",
"language"
]
}'POST /v1/search-extract/ — 6 credits per call
Runs a Web Search pipeline, reranks hits, then performs parallel Structured Extraction across the top URLs and merges fields into a single JSON object with source citations.
Request
{
"query": "best vector databases 2026",
"schema_fields": ["name", "vendor", "pricing_model"],
"prompt": "Extract product comparison fields",
"num_results": 5,
"max_urls": 3
}| Field | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query |
schema_fields | list or JSON schema | No | Fields to extract from each page |
prompt | string | No | Custom extraction instruction |
num_results | int | No | SearXNG results to fetch (default 5) |
max_urls | int | No | Max URLs to extract (default 3) |
Response
{
"query": "best vector databases 2026",
"data": {
"name": "pgvector",
"vendor": "PostgreSQL community",
"pricing_model": "open source"
},
"sources": [
{ "url": "https://example.com/pgvector", "title": "pgvector overview" }
],
"credits_used": 6,
"credits_remaining": 94,
"response_time_ms": 4200
}Notes
- Requires
GROQ_API_KEYfor LLM extraction; missing fields returnnull. - Citation coverage is enforced when sources are available.
- Async variant: submit a
multi_extractjob via Async Jobs withground_query.