Search Tiers: Base and Pro

​

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

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)

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);
}

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"
  }'