Obtener contenidos

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

Devuelve, de cada URL, su título, descripción, fecha de publicación, fuente y un extracto breve del comienzo, nunca el texto completo. Con una query, el modelo elige los fragmentos que tratan de ella y puntúa la relevance de cada página.

Cada URL tiene su propio status: una que falla nunca hace fallar el pedido.

Cuerpo

urlsuri[]obligatorio
Hasta 10 URLs completas.
Elementos: hasta 10
querystring
Si se indica, el modelo elige los fragmentos sobre esta consulta y puntúa la relevance de cada página.
highlightsbooleanPor defecto: true
Devuelve fragmentos textuales. Por defecto true.
max_tokensinteger | null
Un tope de tokens del modelo para el pedido, mínimo 2000. Si se alcanza, recibes todo lo juzgado hasta ahí con incomplete: true.
Rango: 2000–9007199254740991

Respuesta

idstring
El id del pedido.
object"contents"
Siempre contents.
resultsobject[]
Una entrada por URL, en el orden en que se enviaron.
Ver los campos
- urlstring
  La URL canónica de la nota.
- statusenum<string>
  ok o error. Una URL que falla nunca hace fallar el pedido entero.
- errorobject | null
  Cuando status es error: el motivo.
  Ver los campos
  - codestring
    Un código estable.
  - messagestring
    Una explicación para personas.
- titlestring | null
  El titular.
- descriptionstring | null
  La descripción que declara la página.
- published_atstring | null
  La hora de publicación, ISO 8601 en UTC.
- sourcestring | null
  El medio.
- excerptstring | null
  El comienzo de la nota, breve. Nunca el texto completo.
- highlightsstring[]
  Fragmentos textuales; sobre query si se envió.
- relevancenumber | null
  Con query: la probabilidad de que la página trate de ella.
usageobject
Lo que consumió el pedido.
Ver los campos
- tokensinteger
  Tokens del modelo. 0 si salió de la caché.
  Rango: -9007199254740991–9007199254740991
- callsinteger
  Llamadas al modelo.
  Rango: -9007199254740991–9007199254740991
- cost_usdnumber | null
  Costo en dólares, cuando se conoce.
- duration_msinteger
  Tiempo en el servidor, en milisegundos.
  Rango: -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 }
}