> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seltz.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurable content and snippet limits

> fields.content and fields.snippets now accept a config object, not just true or false.

*Released: September 11, 2026*

[`fields.content`](/search/guides/control-content-length) and
[`fields.snippets`](/search/guides/get-snippets) each now accept an object of
ceilings, alongside the existing `true`/`false`. `content` is capped at
20,000 characters by default; pass `{"max_characters_per_result": 500}` to
change it, or `{"max_snippets_per_result": 5}` to bound `snippets`.

## Highlights

* **Content ceiling, configurable** — `max_characters_per_result`, 100 to 1,000,000 characters.
* **Snippet ceilings, configurable** — `max_snippets`, `max_snippets_per_result`, `max_tokens`, and `max_tokens_per_result` all take explicit values now, not just their built-in bounds.
* **Same shape either way** — Each `fields` member still accepts a plain boolean; only callers who want a non-default ceiling need the object form.
* **Rejected outside range** — An out-of-range value returns a `400` with the `INVALID_REQUEST` code before anything is billed.

## Quick Start

<CodeGroup>
  ```python Python theme={null}
  from seltz import Seltz

  client = Seltz()

  response = client.search(
      "climate change",
      fields={"content": {"max_characters_per_result": 500}},
  )

  for document in response.documents:
      print(document.url)
      print(document.content)
  ```

  ```typescript TypeScript theme={null}
  import { Seltz } from "seltz";

  const client = new Seltz();

  const result = await client.search({
    query: "climate change",
    fields: { content: { maxCharactersPerResult: 500 } },
  });

  for (const doc of result.documents) {
    console.log(doc.url);
    console.log(doc.content);
  }
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.seltz.ai/v1/search \
    -H "x-api-key: $SELTZ_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"query": "climate change", "fields": {"content": {"max_characters_per_result": 500}}}'
  ```
</CodeGroup>

<CardGroup cols={2}>
  <Card title="Control content length" icon="scissors" href="/search/guides/control-content-length?utm_source=changelog&utm_medium=changelog&utm_campaign=configure-fields">
    Setting a ceiling on content per result
  </Card>

  <Card title="Get snippets" icon="book" href="/search/guides/get-snippets?utm_source=changelog&utm_medium=changelog&utm_campaign=configure-fields">
    Tuning how many snippets you get
  </Card>
</CardGroup>
