You can now perform token efficient search by pulling a document's highest-scoring passages instead of, or alongside, its full text.
The new snippets field on Seltz Search returns the parts of a document that scored best against your query, so your agent can work with a few focused excerpts instead of an entire article.
Snippets sit next to content on every Search response. content gives you the full text of a document; snippets give you the passages that matched your query best, in the order in which these passages appear in the document. Request either field on its own, or both together in the same call.
Snippets are available on the news and wikipedia scopes today.
How it works
Set fields.snippets to true on a search request, and each result comes back with a snippets array holding its highest-scoring passages.
from seltz import Seltz
client = Seltz()
response = client.search(
"climate change",
fields={"snippets": True},
)
for document in response.documents:
print(document.url)
for snippet in document.snippets:
print(f" {snippet.text}")from seltz import Seltz
client = Seltz()
response = client.search(
"climate change",
fields={"snippets": True},
)
for document in response.documents:
print(document.url)
for snippet in document.snippets:
print(f" {snippet.text}")from seltz import Seltz
client = Seltz()
response = client.search(
"climate change",
fields={"snippets": True},
)
for document in response.documents:
print(document.url)
for snippet in document.snippets:
print(f" {snippet.text}")That's a complete request. Each document in response.documents now carries a snippets array alongside its url and published_date:
{
"documents": [
{
"url": "https://www.newswire.ca/news-releases/government-of-canada-releases-new-climate-report-supporting-climate-resilience-planning-861430564.html",
"published_date": "2026-09-03T20:26:00Z",
"snippets": [
{
"text": "The Government of Canada is releasing its five-year scientific report today to inform planning, resilience-building, and emergency preparedness in a changing climate."
},
{
"text": "Underscoring the importance of integrating climate change considerations into existing planning and decision-making processes across all sectors, Canada's Changing Climate Report 2026 contributes to the implementation of the National Adaptation Strategy."
},
{
"text": "The federal government is committed to fighting climate change and reaching net-zero by 2050 by taking a pragmatic and durable approach."
}
]
}
]
}{
"documents": [
{
"url": "https://www.newswire.ca/news-releases/government-of-canada-releases-new-climate-report-supporting-climate-resilience-planning-861430564.html",
"published_date": "2026-09-03T20:26:00Z",
"snippets": [
{
"text": "The Government of Canada is releasing its five-year scientific report today to inform planning, resilience-building, and emergency preparedness in a changing climate."
},
{
"text": "Underscoring the importance of integrating climate change considerations into existing planning and decision-making processes across all sectors, Canada's Changing Climate Report 2026 contributes to the implementation of the National Adaptation Strategy."
},
{
"text": "The federal government is committed to fighting climate change and reaching net-zero by 2050 by taking a pragmatic and durable approach."
}
]
}
]
}{
"documents": [
{
"url": "https://www.newswire.ca/news-releases/government-of-canada-releases-new-climate-report-supporting-climate-resilience-planning-861430564.html",
"published_date": "2026-09-03T20:26:00Z",
"snippets": [
{
"text": "The Government of Canada is releasing its five-year scientific report today to inform planning, resilience-building, and emergency preparedness in a changing climate."
},
{
"text": "Underscoring the importance of integrating climate change considerations into existing planning and decision-making processes across all sectors, Canada's Changing Climate Report 2026 contributes to the implementation of the National Adaptation Strategy."
},
{
"text": "The federal government is committed to fighting climate change and reaching net-zero by 2050 by taking a pragmatic and durable approach."
}
]
}
]
}For comparison, the result with full page content looks like the following:
{
"url": "https://www.newswire.ca/news-releases/government-of-canada-releases-new-climate-report-supporting-climate-resilience-planning-861430564.html",
"content": "# Government of Canada releases new climate report supporting climate resilience planning\n\n, /CNW/ -- The Government of Canada is releasing its five-year scientific report today to inform planning, resilience-building, and emergency preparedness in a changing climate\\.\n\nUnderscoring the importance of integrating climate change considerations into existing planning and decision-making processes across all sectors, *Canada's** Changing Climate Report 2026* contributes to the implementation of the National Adaptation Strategy\\. The Government of Canada is conducting rigorous science and presenting it in accessible ways so everyone can benefit from this knowledge\\.\n\n (full article text)...",
"published_date": "2026-09-03T20:26:00Z"
}{
"url": "https://www.newswire.ca/news-releases/government-of-canada-releases-new-climate-report-supporting-climate-resilience-planning-861430564.html",
"content": "# Government of Canada releases new climate report supporting climate resilience planning\n\n, /CNW/ -- The Government of Canada is releasing its five-year scientific report today to inform planning, resilience-building, and emergency preparedness in a changing climate\\.\n\nUnderscoring the importance of integrating climate change considerations into existing planning and decision-making processes across all sectors, *Canada's** Changing Climate Report 2026* contributes to the implementation of the National Adaptation Strategy\\. The Government of Canada is conducting rigorous science and presenting it in accessible ways so everyone can benefit from this knowledge\\.\n\n (full article text)...",
"published_date": "2026-09-03T20:26:00Z"
}{
"url": "https://www.newswire.ca/news-releases/government-of-canada-releases-new-climate-report-supporting-climate-resilience-planning-861430564.html",
"content": "# Government of Canada releases new climate report supporting climate resilience planning\n\n, /CNW/ -- The Government of Canada is releasing its five-year scientific report today to inform planning, resilience-building, and emergency preparedness in a changing climate\\.\n\nUnderscoring the importance of integrating climate change considerations into existing planning and decision-making processes across all sectors, *Canada's** Changing Climate Report 2026* contributes to the implementation of the National Adaptation Strategy\\. The Government of Canada is conducting rigorous science and presenting it in accessible ways so everyone can benefit from this knowledge\\.\n\n (full article text)...",
"published_date": "2026-09-03T20:26:00Z"
}Snippets are not supported with the companies and people scopes.
Use cases for Snippets
Token-efficient retrieval. A long article can run to tens of thousands of characters, most of which a model never touches to answer a given question. Pull just the highest-scoring passages instead of the full document, and cut the tokens you pass into a prompt or pipeline accordingly.
Grounding an LLM answer. Give your agent the passages most relevant to a user's question instead of a full article, so it can cite a precise excerpt rather than searching through pages of text on its own.
Building on top of Search. Use snippets as pre-ranked building blocks for your own summarization, highlighting, or reranking logic, without writing your own passage extraction from scratch.
Try Seltz Snippets today
Seltz Snippets are live now. Grab an API key at console.seltz.ai/api-keys and read the Get snippets guide and Search API reference to get started.
Ciao, The Seltz Team
