MarkUDown
API de Deep Research — documentación de investigación con IA MarkUDown
POST
/api/deep-researchDeep Research
Extrae las URLs que envíes y un LLM lo sintetiza todo en una respuesta de investigación, con sus fuentes.
| Parámetro | Tipo | Requerido | Por defecto | Descripción |
|---|---|---|---|---|
| query | string | requerido | — | Pregunta o tema de investigación. |
| urls | array<string> | requerido | — | Páginas fuente a extraer y analizar. Cada URL cuesta 1 crédito. |
| max_tokens | integer | opcional | 4096 | Longitud máxima de la respuesta generada, en tokens. |
| timeout | integer | opcional | 180 | Tiempo límite, en segundos. |
| callback_url | string | opcional | null | URL 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
}