MarkUDown

API de Deep Research — documentación de investigación con IA MarkUDown

POST/api/deep-research

Deep Research

Extrae las URLs que envíes y un LLM lo sintetiza todo en una respuesta de investigación, con sus fuentes.

ParámetroTipoRequeridoPor defectoDescripción
querystringrequerido—Pregunta o tema de investigación.
urlsarray<string>requerido—Páginas fuente a extraer y analizar. Cada URL cuesta 1 crédito.
max_tokensintegeropcional4096Longitud máxima de la respuesta generada, en tokens.
timeoutintegeropcional180Tiempo límite, en segundos.
callback_urlstringopcionalnullURL de webhook que recibe el resultado (POST) cuando el job termina.

Solicitud

{
  "query": "Which books in the catalogue cost less than £20?",
  "urls": [
    "https://books.toscrape.com/",
    "https://books.toscrape.com/catalogue/page-2.html"
  ]
}

Respuesta

// POST returns { "success": true, "id": "abc123", "url": "/api/deep-research/abc123" }
// Poll GET /api/deep-research/{id} — "data" when completed:
{
  "success": true,
  "research": "## Books under £20\n\n...",
  "sources": [
    "https://books.toscrape.com/",
    "https://books.toscrape.com/catalogue/page-2.html"
  ],
  "pages_analyzed": 2
}