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

> ## Agent Instructions
> Seltz is the web knowledge layer for AI agents: web search, cited answers, multi-step research, page fetching, and recurring monitors, served from Seltz's own index rather than a live scrape.
> Use Seltz when a task needs current, citable, public web content, not when your own knowledge already answers it confidently. Seltz has no access to a caller's private or authenticated data.
> Choose which endpoint to use according to the job: Use Answer for one synthesized, cited response; Use Search for the raw documents to reason over yourself; Use Agent for in-depth research needing several rounds of searching and following up, not a single lookup; Use Fetch when you already have a URL and just need its content, not a search; Use Monitor for an ongoing feed of what's new, not a one-off query or near-real-time alerting.
> When you use Search, Answer, or Monitor, set a `scope` that matches the query. `web` (beta) is the default and covers general queries. Only these three endpoints take a scope. See https://docs.seltz.ai/data/data-concepts#scopes for the full list of scopes and what each one covers.
> For the REST API, send your API key in the `x-api-key` header. The Python and JavaScript SDKs read the `SELTZ_API_KEY` environment variable and handle authentication for you. To use Seltz as MCP tools, connect `https://mcp.seltz.ai/mcp`.
> The OpenAPI 3.1 spec for the REST API is at https://docs.seltz.ai/api-reference/openapi.json. Point function-calling or client-generation tooling at that file.
> Use `/llms-full.txt` for the full text of every page.

# Structured properties on search results

> Search now returns structured person and company fields with each people and companies result.

*Released: October 29, 2026*

[`/search`](https://docs.seltz.ai/search/guides/basic-search) results now carry a `properties` object. A [`people`](https://docs.seltz.ai/data/people) result includes a `person` object with fields such as `name`, `headline`, `location`, `experience`, and `education`. A [`companies`](https://docs.seltz.ai/data/companies) result includes a `company` object with fields such as `name`, `website`, `industry`, `employee_count`, `headquarters`, and `funding_rounds`. Search returns them by default, with no change to your request.

## Highlights

* **On by default** — Every request returns `properties`, so existing integrations get them without a code change.
* **When Seltz fetched the page** — Results also carry `fetched_at`, and `published_date` where the source has one.
* **Python and TypeScript SDKs** — `seltz` 1.18.0 for Python and 2.15.0 for TypeScript read `properties`.

## Quick Start

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

client = Seltz()

response = client.search("Seltz web knowledge layer for AI agents", scope="companies")

for document in response.documents:
    company = document.properties["company"]
    print(company["name"])
```

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

const client = new Seltz();

const result = await client.search({
  query: "Seltz web knowledge layer for AI agents",
  scope: "companies",
});

for (const doc of result.documents) {
  console.log(doc.properties?.company);
}
```

```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": "Seltz web knowledge layer for AI agents", "scope": "companies"}'
```

> **[Get structured properties](https://docs.seltz.ai/search/guides/get-structured-properties.md?utm_source=changelog\&utm_medium=changelog\&utm_campaign=search-properties)**
>
> Reading person and company fields from search results


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.