Get contents
Metadata and short verbatim excerpts for URLs you already have.
POST /v1/contents takes up to 10 URLs and returns, for each one, its title, description, publication
date, source and a short excerpt from the beginning. With a query, the model also picks the excerpts
about it and scores each page’s relevance.
const res = await ts.contents(
['https://www.infobae.com/economia/…', 'https://www.lanacion.com.ar/politica/…'],
{ query: 'el Presupuesto 2027' },
);
for (const page of res.results) {
if (page.status === 'ok') console.log(page.relevance, page.title, page.highlights);
else console.log(page.url, page.error?.code);
}Per-URL status
Each URL has its own status. A page that fails — unreachable, not an article, blocked — comes back with
status: "error" and a reason, and never fails the rest of the request.
Never the full text
Like a search engine, we return metadata, a link and short verbatim excerpts — never the full article. It keeps publishers’ content where it belongs, and your context window lean.