Obtener contenidos

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

Devuelve, de cada URL, su título, la descripción que le da su medio, su fecha de publicación, su fuente y un fragmento textual muy breve (hasta 25 palabras, nunca del primer párrafo); nunca el texto completo. Con una query, el modelo elige el fragmento que trata de ella y puntúa la relevance de cada página. Las notas que no se pueden citar (breves, de pago o de un medio que pidió que no mostremos fragmentos) vuelven sin fragmento.

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 el fragmento sobre esta consulta y puntúa la relevance de cada página.
highlightsbooleanPor defecto: true
Devuelve un fragmento textual breve: hasta 25 palabras, nunca del primer párrafo. 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, como source_unavailable si la fuente no está disponible ahora (no decimos por qué, y puede ser temporal).
  Ver los campos
  - codestring
    Un código estable.
  - messagestring
    Una explicación para personas.
- titlestring | null
  El titular, de hasta 240 caracteres.
- descriptionstring | null
  La descripción que declara la página, de hasta 300 caracteres.
- published_atstring | null
  La hora de publicación, ISO 8601 en UTC.
- sourcestring | null
  El medio.
- excerptstring | null
  Un fragmento textual muy breve (hasta 25 palabras), nunca del primer párrafo: el que trata de query si se envió. null cuando la nota no se puede citar: es breve, es de pago o su medio pidió que no mostremos fragmentos.
- highlightsstring[]
  Un fragmento textual breve, sobre query si se envió: hasta 25 palabras, nunca del primer párrafo. Ninguno en las notas breves.
- 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://reddiaria.example/economia/…', 'https://diarioejemplo.example/politica/…'],
  { query: 'el Presupuesto 2027' },
);

200 OK

{
  "id": "req_Hc4tB8mZw1Ke",
  "object": "contents",
  "results": [
    {
      "url": "https://reddiaria.example/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": "Red Diaria",
      "excerpt": "El proyecto prevé un superávit primario…",
      "highlights": ["El proyecto prevé un superávit primario…"],
      "relevance": 0.97
    },
    {
      "url": "https://diarioejemplo.example/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.0004, "duration_ms": 1840 }
}