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/scan | Puntaje 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/dns | Registros 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/rdap | Registro del dominio vía RDAP: registrador, fechas, estado y nameservers. Parámetro domain. Domain registration via RDAP. Param domain. |
GET /api/subdomains | Subdominios vistos en certificados públicos (crt.sh). Parámetro domain. Subdomains seen in public certificates (crt.sh). Param domain. |
GET /api/email | Seguridad 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/headers | HTTPS, redirección HTTP→HTTPS y cabeceras de seguridad. Parámetro domain. HTTPS, HTTP→HTTPS redirect and security headers. Param domain. |
GET /api/certs | Certificados TLS vigentes en Certificate Transparency. Parámetro domain. Valid TLS certificates from Certificate Transparency. Param domain. |
GET /api/ip | IP 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/url | Cadena 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/reputation | Riesgo 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/wayback | Primera 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/me | Lo 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/health | Estado del servicio. / Service status. |
GET /api/openapi.json | Especificació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) oen.
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.