HushSearchDocs

Multi-URL Extract

Structured extraction across many URLs with optional SearXNG grounding — 4 credits per URL.

Scrape & extractLong-running: consider /v1/jobs

POST/v1/multi-extract/4 credits

Request
curl -X POST https://api.hushsearch.io/v1/multi-extract/ \
  -H "X-API-Key: hs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "urls": [
    "https://fastapi.tiangolo.com/",
    "https://www.djangoproject.com/"
  ],
  "prompt": "Project name and one-line description"
}'

POST /v1/multi-extract/ — 4 credits per URL (max 50 URLs)

Extract structured data from multiple URLs in parallel. Optionally ground URL discovery with a SearXNG query when urls is empty or sparse.

Request

{
  "urls": [
    "https://example.com",
    "https://openai.com"
  ],
  "schema_fields": ["title", "description"],
  "prompt": "Extract page metadata",
  "ground_query": "OpenAI company homepage",
  "num_results": 5
}
FieldTypeRequiredDescription
urlslist[string]No*Up to 50 URLs to extract
ground_querystringNo*SearXNG query to discover URLs
schema_fieldslist or JSON schemaNoFields to extract per URL
promptstringNoCustom extraction instruction
num_resultsintNoResults when grounding via search

* Provide urls and/or ground_query.

Response

{
  "results": [
    {
      "url": "https://example.com",
      "data": { "title": "Example Domain", "description": "..." },
      "success": true
    }
  ],
  "success_count": 2,
  "url_count": 2,
  "grounded": false,
  "credits_used": 8,
  "credits_remaining": 92,
  "response_time_ms": 3100
}

Notes

  • Credit cost scales with URL count: 4 × min(url_count, 50).
  • For long-running batches, use Async Jobs with type: "multi_extract".