MarkUDown

API de Search — documentación de búsqueda web MarkUDown

POST/api/search

Search

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ámetroTipoRequeridoPor defectoDescripción
querystringrequerido—Consulta de búsqueda.
limitintegeropcional5Número de resultados a devolver (1–50).
langstringopcional"en"Código de idioma, por ejemplo "en", "pt", "es".
countrystringopcional"us"Código de país para resultados locales, por ejemplo "us", "br", "de".
scrape_resultsbooleanopcionaltrueTambién extrae el contenido completo de cada página de resultado.
enginestringopcional"google""google", "bing", "duckduckgo" o "all".
timeoutintegeropcional60Tiempo límite, en segundos.
callback_urlstringopcionalnullURL 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..."
    }
  ]
}