MarkUDown

API de Deep Research — documentação da pesquisa com IA MarkUDown

POST/api/deep-research

Deep Research

Coleta as URLs que você enviar e um LLM sintetiza tudo numa resposta de pesquisa, com as fontes.

ParâmetroTipoObrigatórioPadrãoDescrição
querystringobrigatório—Pergunta ou tema da pesquisa.
urlsarray<string>obrigatório—Páginas-fonte a coletar e analisar. Cada URL custa 1 crédito.
max_tokensintegeropcional4096Tamanho máximo da resposta gerada, em tokens.
timeoutintegeropcional180Tempo limite, em segundos.
callback_urlstringopcionalnullURL 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
}