Contents
Clean text, highlights and summaries for up to 50 URLs in one call.
Request
curl -X POST https://api.hushsearch.io/v1/contents/ \
-H "X-API-Key: hs_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://example.com/"
],
"text": true,
"summary": true
}'Fetch many pages at once. Each URL returns its text, and optionally query-ranked highlights and a short extractive summary. Pages are also added to your private index unless you turn ingest off.
Parameters
| Field | Type | Default | Notes |
|---|---|---|---|
urls | string[] | — | Required. 1–50 URLs. |
text | boolean | true | Return page text. |
max_chars | integer | 16000 | Per page, 500–80,000. |
highlights | boolean | false | Return the most relevant sentences. |
query | string | — | Ranks highlights. |
highlight_sentences | integer | 3 | 1–8. |
summary | boolean | false | Short extractive summary per page. |
ingest | boolean | true | Add pages to your private index. |
max_age_hours | integer | — | Accept cached copies up to this age. |
Response
{
"results": [
{
"id": "…",
"url": "https://example.com/",
"title": "Example Domain",
"text": "This domain is for use in illustrative examples…",
"status_code": 200,
"error": null,
"highlights": null,
"summary": null
}
],
"credits_used": 2,
"credits_remaining": 498,
"response_time_ms": 900
}Costs 2 credits per URL.