# Contents

> Clean text, highlights and summaries for up to 50 URLs in one call.

Source: http://localhost:3000/docs/endpoints/contents

## Contents: `POST /v1/contents/`

Text, highlights and summaries for a list of URLs. Cost: 2 credits / URL.

```bash
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

```json
{
  "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.
