> ## 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.

# Search Tiers: Base and Pro

> Trade result quality for lower latency with the new tier parameter — pro is the quality-oriented default, base is the latency-oriented option.

*Released: September 8, 2026*

[`/search`](/search/search-concepts) now takes a **`tier`** parameter that picks between latency and result quality. **`pro`** — the default — is quality-oriented: the most relevant results are ordered to the top. **`base`** is latency-oriented: responses come back faster, with less precise ordering near the top.

## Highlights

* **New `tier` parameter** —  Choose `pro` (default, optimized for quality) or `base` (optimized for latency).
* **Independent of `scope`** — `tier` picks the latency/quality trade-off, [`scope`](/data/data-concepts#scopes) picks which data is searched; every scope accepts either tier.
* **Opt-out, not opt-in** — Omitting `tier` gives you `pro`, so existing calls keep the ordering they already had. Send `base` explicitly when latency matters more.
* **Strict on names** — Matched case-insensitively with whitespace trimmed, but an unrecognized tier is rejected rather than quietly defaulted, so you are only ever served the tier you named.
* **Available everywhere** — This setting is supported in Python SDK `1.13.0`, TypeScript SDK `2.10.0`, and REST `POST /v1/search`.

## Quick Start

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

  client = Seltz(api_key="your-api-key")

  response = client.search("Who is going to be Apple's next CEO?", tier="base")
  for document in response.documents:
      print(document.url)
  ```

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

  const client = new Seltz({ apiKey: "your-api-key" });

  const result = await client.search({
    query: "Who is going to be Apple's next CEO?",
    tier: "base",
  });
  for (const doc of result.documents) {
    console.log(doc.url);
  }
  ```

  ```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": "Who is going to be Apple'\''s next CEO?",
      "tier": "base"
    }'
  ```
</CodeGroup>

<CardGroup cols={2}>
  <Card title="Choose a search tier" icon="book" href="/search/guides/choose-a-tier?utm_source=changelog&utm_medium=changelog&utm_campaign=search-tiers">
    When to reach for `base` over the default `pro`
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/search?utm_source=changelog&utm_medium=changelog&utm_campaign=search-tiers">
    Full `tier` parameter specification
  </Card>
</CardGroup>