Cómo usar las APIs

Autenticación

X-Api-Key: st_live_tu_clave

Consíguela en tu panel. Si falta o es inválida devuelve 401; si superas el límite o la cuota, 429.

Descarga una página, descarta menús, footers y anuncios con Mozilla Readability y la convierte en Markdown estable (encabezados ATX, código cercado y tablas GFM). Si envías html en lugar de url, procesa ese HTML directamente (útil si ya lo obtuviste con un navegador headless).

Petición

curl -X POST https://secrettools.duckdns.org/v1/markdown \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: TU_CLAVE" \
  -d '{"url":"https://es.wikipedia.org/wiki/Markdown"}'

Respuesta

{
  "status": "success",
  "metadata": {
    "title": "Markdown",
    "byline": "Colaboradores de los proyectos Wikimedia",
    "excerpt": "De Wikipedia, la enciclopedia libre",
    "word_count": 1221,
    "lang": "es",
    "char_count": 12981,
    "reading_time_minutes": 6
  },
  "markdown": "# Markdown\n\n| Markdown |\n| --- |..."
}

Extrae emails, teléfonos y enlaces a redes sociales (LinkedIn, Instagram, X, Facebook) de cualquier texto o HTML sucio. Deduplica, normaliza teléfonos, quita parámetros de tracking y descarta falsos positivos como logo@marca.png.

Petición

curl -X POST https://secrettools.duckdns.org/v1/leads \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: TU_CLAVE" \
  -d '{"raw_text":"Contacta en ventas@acme.cl o al +56 9 8765 4321"}'

Respuesta

{
  "success": true,
  "data": {
    "emails": ["ventas@acme.cl"],
    "phones": ["+56987654321"],
    "social_links": { "linkedin": [], "instagram": [], "twitter_x": [], "facebook": [] },
    "visible_text_length": 49
  },
  "processing_time_ms": 0.65
}

Descarga el HTML con un Chromium real: rotación de user-agent, anti-fingerprinting y ejecución de JavaScript. Devuelve el HTML final y el título. Es la API más cara porque arranca un navegador.

Petición

curl -X POST https://secrettools.duckdns.org/v1/fetch \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: TU_CLAVE" \
  -d '{"url":"https://sitio-con-javascript.com"}'

Respuesta

{
  "success": true,
  "status_code": 200,
  "final_url": "https://sitio-con-javascript.com/",
  "title": "Ejemplo",
  "html": "<!DOCTYPE html>..."
}