MarkUDown
API de Deep Research — documentação da pesquisa com IA MarkUDown
POST
/api/deep-researchDeep Research
Coleta as URLs que você enviar e um LLM sintetiza tudo numa resposta de pesquisa, com as fontes.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| query | string | obrigatório | — | Pergunta ou tema da pesquisa. |
| urls | array<string> | obrigatório | — | Páginas-fonte a coletar e analisar. Cada URL custa 1 crédito. |
| max_tokens | integer | opcional | 4096 | Tamanho máximo da resposta gerada, em tokens. |
| timeout | integer | opcional | 180 | Tempo limite, em segundos. |
| callback_url | string | opcional | null | URL de webhook que recebe o resultado (POST) quando o job termina. |
Requisição
{
"query": "Which books in the catalogue cost less than £20?",
"urls": [
"https://books.toscrape.com/",
"https://books.toscrape.com/catalogue/page-2.html"
]
}Resposta
// 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
}