MarkUDown
API de Search — documentación de búsqueda web MarkUDown
POST
/api/searchSearch
Realiza una búsqueda en Google via un navegador stealth y devuelve los mejores resultados. Opcionalmente extrae el contenido completo de cada página resultado.
| Parámetro | Tipo | Requerido | Por defecto | Descripción |
|---|---|---|---|---|
| query | string | requerido | — | Consulta de búsqueda. |
| limit | integer | opcional | 5 | Número de resultados a devolver (1–50). |
| lang | string | opcional | "en" | Código de idioma, por ejemplo "en", "pt", "es". |
| country | string | opcional | "us" | Código de país para resultados locales, por ejemplo "us", "br", "de". |
| scrape_results | boolean | opcional | true | También extrae el contenido completo de cada página de resultado. |
| engine | string | opcional | "google" | "google", "bing", "duckduckgo" o "all". |
| timeout | integer | opcional | 60 | Tiempo límite, en segundos. |
| callback_url | string | opcional | null | URL de webhook que recibe el resultado (POST) cuando el job termina. |
Solicitud
{
"query": "best web scraping libraries 2025",
"limit": 5,
"lang": "en",
"country": "us",
"scrape_results": true
}Respuesta
// 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..."
}
]
}