API · v2.0

API OSINT defensiva

API pública, gratuita y de solo lectura para revisar la postura de seguridad pública de un dominio. / Free, public, read-only API to assess a domain's public security posture.

Endpoints

GET /api/scanPuntaje de seguridad (0–100) de un dominio con chequeos y recomendaciones. Parámetro domain.
Domain security score (0–100) with checks and recommendations. Param domain.
GET /api/dnsRegistros A, AAAA, MX, NS, CAA, TXT y SOA vía DNS sobre HTTPS, con bandera DNSSEC. Parámetro domain.
A, AAAA, MX, NS, CAA, TXT and SOA via DNS over HTTPS, with DNSSEC flag. Param domain.
GET /api/rdapRegistro del dominio vía RDAP: registrador, fechas, estado y nameservers. Parámetro domain.
Domain registration via RDAP. Param domain.
GET /api/subdomainsSubdominios vistos en certificados públicos (crt.sh). Parámetro domain.
Subdomains seen in public certificates (crt.sh). Param domain.
GET /api/emailSeguridad del correo: MX, SPF, DMARC, DKIM, MTA-STS, TLS-RPT y si es suplantable. Parámetro domain.
Email security: MX, SPF, DMARC, DKIM, MTA-STS, TLS-RPT and spoofability. Param domain.
GET /api/headersHTTPS, redirección HTTP→HTTPS y cabeceras de seguridad. Parámetro domain.
HTTPS, HTTP→HTTPS redirect and security headers. Param domain.
GET /api/certsCertificados TLS vigentes en Certificate Transparency. Parámetro domain.
Valid TLS certificates from Certificate Transparency. Param domain.
GET /api/ipIP o dominio: ASN y prefijo (RIPEstat), DNS inverso y geolocalización aproximada (ipwho.is). Parámetro q.
IP or domain: ASN and prefix (RIPEstat), reverse DNS and approximate geolocation (ipwho.is). Param q.
GET /api/urlCadena de redirecciones (hasta 10), destino final, cabeceras y metadatos de la página. Parámetro url.
Redirect chain (up to 10), final URL, headers and page metadata. Param url.
GET /api/reputationRiesgo de phishing: listas OpenPhish, Phishing Filter y CERT Polska más heurísticas (antigüedad, marcas, punycode…). Parámetro url.
Phishing risk: OpenPhish, Phishing Filter and CERT Polska lists plus heuristics. Param url.
GET /api/waybackPrimera y última captura en la Wayback Machine y capturas por año. Parámetro url.
First/last Wayback Machine capture and captures by year. Param url.
GET /api/meLo que un sitio ve de tu conexión (IP, país, ASN, navegador). Sin parámetros; no se guarda.
What a site sees about your connection. No params; nothing stored.
GET /api/healthEstado del servicio. / Service status.
GET /api/openapi.jsonEspecificación OpenAPI 3.1.

Parámetros / Parameters

  • domain: dominio público, p. ej. ejemplo.com. url: URL http(s) pública. q: IP o dominio. No se aceptan IP privadas ni puertos no estándar.
  • lang (opcional, solo /api/scan): es (por defecto) o en.

Ejemplo

curl "https://andresvanegasfernandez.com/api/scan?domain=ejemplo.com&lang=es"

{
  "domain": "ejemplo.com", "score": 72, "grade": "C",
  "checks": [{"id":"dmarc","label":"DMARC","status":"warn","points":8,"max":20,"detail":"v=DMARC1; p=none"}, …],
  "recommendations": ["Tu DMARC está en p=none (solo monitoreo): sube a quarantine y luego a reject.", …],
  "raw": { "dns": …, "email": …, "web": …, "certs": …, "rdap": … }
}

Puntaje / Scoring

SPF 15 · DMARC 20 · DKIM 5 · DNSSEC 10 · CAA 5 · HTTPS 10 · HTTP→HTTPS 5 · HSTS 10 · CSP 5 · X-Content-Type-Options 3 · anti-clickjacking 3 · Referrer-Policy 2 · Permissions-Policy 2 · MTA-STS 5 (solo si hay MX). El puntaje es el porcentaje obtenido. A ≥ 90 · B ≥ 80 · C ≥ 65 · D ≥ 50 · F < 50.

Límites / Limits

  • 60 consultas cada 10 minutos por IP (HTTP 429 con retry-after).
  • Resultados en caché 30 minutos ("cached": true).
  • CORS abierto para GET.

Fuentes / Sources

  • DNS sobre HTTPS: Cloudflare 1.1.1.1
  • Certificate Transparency: crt.sh
  • RDAP: rdap.org
  • Cabeceras: una sola petición GET a la página principal, como cualquier navegador.

Uso responsable / Responsible use

Solo consultas pasivas a fuentes públicas. No hay búsqueda de personas, ni datos personales, ni consultas de filtraciones de contraseñas, ni escaneo de puertos. Listas de phishing: OpenPhish, Phishing Filter (malware-filter) y CERT Polska. Red: RIPEstat e ipwho.is. Analiza solo dominios propios o con autorización. / Passive public lookups only: no people search, no personal data, no password-breach lookups, no port scanning.