MarkUDown
API de Search — documentação da busca na web MarkUDown
POST
/api/searchSearch
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âmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| query | string | obrigatório | — | Termo de busca. |
| limit | integer | opcional | 5 | Número de resultados a devolver (1–50). |
| lang | string | opcional | "en" | Código do idioma, por exemplo "en", "pt", "es". |
| country | string | opcional | "us" | Código do país para resultados locais, por exemplo "us", "br", "de". |
| scrape_results | boolean | opcional | true | Também coleta o conteúdo completo de cada página de resultado. |
| engine | string | opcional | "google" | "google", "bing", "duckduckgo" ou "all". |
| timeout | integer | opcional | 60 | Tempo limite, em segundos. |
| callback_url | string | opcional | null | URL 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..."
}
]
}