Get structured properties

Search returns structured properties with each result, alongside its content. A people result carries a person object, and a companies result carries a company object. You don’t need to request them: Search returns them by default. Every result also carries fetched_at, the time Seltz last retrieved the page, and published_date where the source has one.

People

from seltz import Seltz

client = Seltz()

response = client.search("Antonio Mallia Seltz", scope="people")

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

import { Seltz } from "seltz";

const client = new Seltz();

const result = await client.search({
  query: "Antonio Mallia Seltz",
  scope: "people",
});

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

curl -X POST https://api.seltz.ai/v1/search \
  -H "x-api-key: $SELTZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Antonio Mallia Seltz", "scope": "people"}'

Sample response

{
  "documents": [
    {
      "url": "https://www.linkedin.com/in/antoniomallia",
      "content": "# Antonio Mallia\n\n**CEO @ Seltz**\n\n📍 San Francisco, California, United States\n\n... (20,002 characters total)",
      "published_date": "2016-08-30T22:10:14Z",
      "properties": {
        "fetched_at": "2026-09-28T18:08:53Z",
        "person": {
          "connections_count": 500,
          "education": [
            {
              "degree": "Doctor of Philosophy - PhD Computer Science",
              "end": "2022",
              "institution": "NYU Tandon School of Engineering",
              "institution_linkedin_url": "https://www.linkedin.com/school/nyutandonschoolofengineering",
              "start": "2018"
            }
          ],
          "experience": [
            {
              "company": "Seltz",
              "company_linkedin_url": "https://www.linkedin.com/company/seltz",
              "is_current": true,
              "start": "October 2025",
              "title": "Member of Technical Staff"
            }
          ],
          "follower_count": 6542,
          "headline": "CEO @ Seltz",
          "image_url": "https://media.licdn.com/dms/image/v2/D4D03AQHxGg862btgKg/profile-displayphoto-scale_200_200/B4DZqWAwoZHsAY-/0/1763453374633?e=2147483647&v=beta&t=azbQYwLN8dtO7PufizQ-oRyrJ84P2Oak1NgzmzvHU5s",
          "location": "San Francisco, California, United States",
          "name": "Antonio Mallia"
        },
        "published_date": "2016-08-30T22:10:14Z"
      }
    }
  ]
}

Companies

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"])

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

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

Sample response

{
  "documents": [
    {
      "url": "https://www.linkedin.com/company/seltz",
      "content": "# Seltz\n\n**Software Development · Privately Held · San Francisco, United States**\n\n## About\n\n... (7,626 characters total)",
      "published_date": "2025-10-15T00:00:00Z",
      "properties": {
        "company": {
          "description": "The Web Knowledge Layer for AI Agents.",
          "employee_count": 21,
          "funding_rounds": [
            {
              "amount": 12500000,
              "currency": "USD",
              "date": "2026-06-01",
              "investors": [
                {
                  "is_lead": true,
                  "name": "B Capital"
                },
                {
                  "is_lead": true,
                  "name": "Speedinvest"
                }
              ],
              "type": "Seed Round"
            }
          ],
          "headquarters": {
            "address": "71 Stevenson St, Suite 400, San Francisco, CA 94195, US",
            "city": "San Francisco",
            "country": "United States",
            "state": "California"
          },
          "image_url": "https://media.licdn.com/dms/image/v2/D4D0BAQG83AsEQSfJxg/company-logo_200_200/B4DZuz3ywbGcAM-/0/1768249306636/seltz_logo?e=2147483647&v=beta&t=lAoCDxbEYHg04PYuTzw3iivT3_3vtkbLixWMkb5UWHM",
          "industry": "Software Development",
          "name": "Seltz",
          "website": "https://www.seltz.ai/"
        },
        "fetched_at": "2026-09-20T00:00:00Z",
        "published_date": "2025-10-15T00:00:00Z"
      }
    }
  ]
}

A result includes only the properties its source records, so the fields can differ from one result to the next. In Python, document.properties reads like a dict. Test a key with in before you index a field that a result might not have, because indexing a missing key raises ValueError.

Choose which properties come back

To return only some properties, set fields.properties to a list of dotted paths, such as ["company.name", "company.website"]. Set it to false to turn properties off. Setting properties alone leaves content on, so add "content": false if you want properties only. See the Search API Reference for the full contract.

Getting Started

Web Tools

Data

Tutorials

Chat

Integrations

SDKs

Get structured properties

People

Sample response

Companies

Sample response

Choose which properties come back

​People

​Sample response

​Companies

​Sample response

​Choose which properties come back

People

Sample response

Companies

Sample response

Choose which properties come back