MarkUDown

API de Search — documentação da busca na web MarkUDown

POST/api/search

Search

Realize uma busca no Google via navegador stealth e retorne os melhores resultados. Opcionalmente extrai o conteúdo completo de cada página de resultado.

ParâmetroTipoObrigatórioPadrãoDescrição
querystringobrigatório—Termo de busca.
limitintegeropcional5Número de resultados a devolver (1–50).
langstringopcional"en"Código do idioma, por exemplo "en", "pt", "es".
countrystringopcional"us"Código do país para resultados locais, por exemplo "us", "br", "de".
scrape_resultsbooleanopcionaltrueTambém coleta o conteúdo completo de cada página de resultado.
enginestringopcional"google""google", "bing", "duckduckgo" ou "all".
timeoutintegeropcional60Tempo limite, em segundos.
callback_urlstringopcionalnullURL de webhook que recebe o resultado (POST) quando o job termina.

Requisição

{
  "query": "best web scraping libraries 2025",
  "limit": 5,
  "lang": "en",
  "country": "us",
  "scrape_results": true
}

Resposta

// POST returns { "success": true, "id": "abc123", "url": "/api/search/abc123" }
// Poll GET /api/search/{id} — "data" when completed:
{
  "success": true,
  "query": "best web scraping libraries 2025",
  "total": 5,
  "data": [
    {
      "title": "Top Scraping Libraries",
      "url": "https://example.com/article",
      "snippet": "Discover the best...",
      "markdown": "# Top Scraping Libraries..."
    }
  ]
}