cURL

Authentication

All requests require an API key in the x-api-key header:

curl -X POST https://api.seltz.ai/v1/search \
  -H "x-api-key: $SELTZ_API_KEY" \
  -H "Content-Type: application/json"

Search Endpoint

POST /v1/search

Search the web and return matching documents.

curl -X POST https://api.seltz.ai/v1/search \
  -H "x-api-key: $SELTZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "best ai search engines", "max_results": 10}'

Request Body

Field	Type	Required	Description
`query`	string	Yes	The search query.
`max_results`	integer	No	Maximum number of documents to return. Default: 10.
`scope`	string	No	Restrict results to a specific scope (e.g., `"news"`).
`tier`	string	No	Which tier serves the request, `"base"` or `"pro"`. Default: `"pro"`. See Search tiers.
`include_domains`	string[]	No	Include only results from these domains.
`exclude_domains`	string[]	No	Exclude results from these domains.
`from_date`	string	No	Only include results published on or after this point. An ISO 8601 date or datetime, or an offset from now such as `now-7d`. See Filter by date.
`to_date`	string	No	Only include results published on or before this point. Same forms as `from_date`.
`fields`	object	No	Which `Document` members to populate: `content` and `snippets`. Each takes `true`, `false`, or an object of ceilings (e.g. `{"max_characters_per_result": 500}`). See Control content length and Get snippets.

Filter examples:

# Filter by date
curl -X POST https://api.seltz.ai/v1/search \
  -H "x-api-key: $SELTZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "AI news",
    "from_date": "2026-05-01"
  }'

# Filter by domain
curl -X POST https://api.seltz.ai/v1/search \
  -H "x-api-key: $SELTZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "tech news",
    "include_domains": ["techcrunch.com", "wired.com"]
  }'

# Combine filters
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",
    "max_results": 5,
    "from_date": "2026-01-01",
    "exclude_domains": ["wikipedia.org"]
  }'

Response

{
  "documents": [
    {
      "url": "https://example.com/article",
      "content": "Article content...",
      "published_date": "2026-05-01T12:00:00Z"
    }
  ]
}

Answer Endpoint

POST /v1/answer

Generate a direct, natural-language answer to a question, grounded in live web search results, with citations to the sources used.

curl -X POST https://api.seltz.ai/v1/answer \
  -H "x-api-key: $SELTZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "What is machine learning?"}'

Request Body

Field	Type	Required	Description
`query`	string	Yes	The question to answer.
`scope`	string	No	Ground the answer in a specific scope (e.g., `"companies"`).
`include_content`	boolean	No	Include the full text content of each cited source. Default: false.
`model`	string	No	Answer tier: `"seltz-base"` (default) or `"seltz-pro"`, which runs agentic RAG over a single grounding search. Omitted or unrecognized values fall back to `seltz-base`.
`response_format`	object	No	OpenAI-style `response_format` object. `answer` comes back as a JSON string matching your schema instead of Markdown.
`system_prompt`	string	No	Steers how the answer is presented — tone, voice, format. Empty or whitespace-only behaves as omitted; over 8 KiB of UTF-8 is rejected with a `400`.

With the pro tier:

curl -X POST https://api.seltz.ai/v1/answer \
  -H "x-api-key: $SELTZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What did Apple announce at WWDC 2026? Provide a table.",
    "model": "seltz-pro"
  }'

With cited content:

curl -X POST https://api.seltz.ai/v1/answer \
  -H "x-api-key: $SELTZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What is machine learning?",
    "include_content": true
  }'

With structured output:

curl -X POST https://api.seltz.ai/v1/answer \
  -H "x-api-key: $SELTZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Who will be the next CEO of Apple?",
    "response_format": {
      "type": "json_schema",
      "json_schema": {
        "name": "leadership_change",
        "strict": true,
        "schema": {
          "type": "object",
          "properties": {
            "successor": {"type": "string"},
            "effective_date": {"type": "string"}
          },
          "required": ["successor", "effective_date"],
          "additionalProperties": false
        }
      }
    }
  }'

{
  "answer": "{\"successor\": \"John Ternus\", \"effective_date\": \"2026-09-01\"}",
  "citations": [
    { "url": "https://www.macrumors.com/2026/07/30/tim-cook-thanks-apple-shareholders/" }
  ]
}

With a system prompt:

curl -X POST https://api.seltz.ai/v1/answer \
  -H "x-api-key: $SELTZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Who will be the next CEO of Apple?",
    "system_prompt": "Write as an analyst briefing an executive. Open with a one-line bottom line, then at most three supporting bullets. Avoid hedging language."
  }'

Response

The answer field is markdown-formatted text, unless response_format requested structured output — then it is a JSON string matching your schema. Each citation’s content is populated only when include_content is true.

{
  "answer": "Machine learning is a branch of artificial intelligence...",
  "citations": [
    {
      "url": "https://example.com/article",
      "content": "Article content..."
    }
  ]
}

Error Responses

Errors return an HTTP status code and a JSON body carrying a stable error.code to branch on:

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "Invalid, expired, or revoked API key"
  }
}

See Errors for the full status code reference, the 8 KiB limit on /answer’s query and system_prompt, and how streaming errors differ.

Environment Variables

Store your API key securely:

export SELTZ_API_KEY="your-api-key"

curl -X POST https://api.seltz.ai/v1/search \
  -H "x-api-key: $SELTZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "best ai search engines", "max_results": 10}'

Getting Started

Web Tools

Data

Tutorials

Chat

Integrations

SDKs

Authentication

Search Endpoint

POST /v1/search

Request Body

Response

Answer Endpoint

POST /v1/answer

Request Body

Response

Error Responses

Environment Variables

​Authentication

​Search Endpoint

​POST /v1/search

​Request Body

​Response

​Answer Endpoint

​POST /v1/answer

​Request Body

​Response

​Error Responses

​Environment Variables

Authentication

Search Endpoint

POST /v1/search

Request Body

Response

Answer Endpoint

POST /v1/answer

Request Body

Response

Error Responses

Environment Variables