Get contents

POSThttps://api.typesearch.ai/v1/contents

Returns, for each URL, its title, description, publication date, source and a short excerpt from the beginning — never the full text. With a query, the model picks the excerpts about it and scores each page’s relevance.

Each URL has its own status: one that fails never fails the request.

Body

urlsuri[]required
Up to 10 full URLs.
Items: up to 10
querystring
When set, the model picks the excerpts about this query and scores each page’s relevance.
highlightsbooleanDefault: true
Return verbatim excerpts. Defaults to true.
max_tokensinteger | null
A hard cap on model tokens for this request, minimum 2000. If it is reached, you get everything judged so far with incomplete: true.
Range: 2000–9007199254740991

Response

idstring
The request id.
object"contents"
Always contents.
resultsobject[]
One entry per URL, in the order they were sent.
Show child attributes
- urlstring
  The article’s canonical URL.
- statusenum<string>
  ok or error. A failing URL never fails the whole request.
- errorobject | null
  When status is error: the reason.
  Show child attributes
  - codestring
    A stable code.
  - messagestring
    A human-readable explanation.
- titlestring | null
  The headline.
- descriptionstring | null
  The description the page declares.
- published_atstring | null
  Publication time, ISO 8601 in UTC.
- sourcestring | null
  The publication.
- excerptstring | null
  The beginning of the article, short. Never the full text.
- highlightsstring[]
  Verbatim excerpts; about query when one was sent.
- relevancenumber | null
  With query: the probability that the page is about it.
usageobject
What the request consumed.
Show child attributes
- tokensinteger
  Model tokens. 0 when served from cache.
  Range: -9007199254740991–9007199254740991
- callsinteger
  Model calls.
  Range: -9007199254740991–9007199254740991
- cost_usdnumber | null
  Cost in US dollars, when known.
- duration_msinteger
  Time on the server, in milliseconds.
  Range: -9007199254740991–9007199254740991

const res = await ts.contents(
  ['https://www.infobae.com/economia/…', 'https://www.lanacion.com.ar/politica/…'],
  { query: 'el Presupuesto 2027' },
);

200 OK

{
  "id": "req_Hc4tB8mZw1Ke",
  "object": "contents",
  "results": [
    {
      "url": "https://www.infobae.com/economia/…",
      "status": "ok",
      "error": null,
      "title": "Presupuesto 2027: las claves del proyecto",
      "description": "El Gobierno envió el proyecto al Congreso.",
      "published_at": "2026-09-16T01:12:00.000Z",
      "source": "Infobae",
      "excerpt": "El proyecto prevé…",
      "highlights": ["El proyecto prevé un superávit primario…"],
      "relevance": 0.97
    },
    {
      "url": "https://www.lanacion.com.ar/politica/…",
      "status": "error",
      "error": { "code": "site_unreachable", "message": "…" },
      "title": null,
      "description": null,
      "published_at": null,
      "source": null,
      "excerpt": null,
      "highlights": [],
      "relevance": null
    }
  ],
  "usage": { "tokens": 1320, "calls": 1, "cost_usd": 0.0003, "duration_ms": 1840 }
}