API v1

Documentación API

API REST pública para geolocalización IP, herramientas de red y verificación de seguridad.

RESTJSONSSECORS URL Basehttps://mon-ip.dev
Autenticación

Clave API

La API es accesible públicamente sin autenticación. Para límites más altos, cree una cuenta y genere una clave API desde su panel. Abrir el panel →

Transmita su clave mediante el header Authorization:

Header HTTP
Authorization: Bearer mk_votre_cle_api
Ejemplo · curl
$ curl https://mon-ip.dev/api/v1/json -H "Authorization: Bearer mk_a1b2c3d4e5f6..."
Límites

Rate limiting

Las solicitudes están limitadas según su nivel de acceso. Al superar el límite, la API devuelve un error 429 Too Many Requests.

NivelPor horaPor díaClaves máx
Public100 / IP500 / IP—
Free1 00010 0005
Propróximamente10 000100 00020
Headers de respuesta

Cada respuesta incluye headers para seguir su consumo:

X-RateLimit-LimitNúmero máximo de solicitudes permitidas por hora
X-RateLimit-RemainingSolicitudes restantes en la ventana actual
X-RateLimit-ResetTimestamp UNIX de reinicio del contador
Errores

Códigos de error

En caso de error, la respuesta contiene un campo error con un mensaje descriptivo.

400Parámetro faltante o inválido
401Clave API inválida o revocada
429Límite de solicitudes superado (rate limit)
502Error de conexión al servicio interno
500Error interno del servidor
429 Too Many Requests
{
"error": "Rate limit exceeded",
"limit": 100,
"reset": 1709913600
}

Terminal (curl)

Sin clave ni parámetros: consulta directamente la raíz del sitio desde curl, wget, HTTPie o PowerShell. Respuestas sin caché, CORS permitido.

GET /

Devuelve tu dirección IP pública en texto plano, seguida de un salto de línea, cuando la petición procede de un cliente de línea de comandos (curl, wget, HTTPie, PowerShell…). La ruta /ip devuelve la misma respuesta desde cualquier cliente.

Solicitud
$ curl mon-ip.dev
Respuesta · text/plain
203.0.113.42
GET /json

Geolocalización e información de red de tu IP, en JSON indentado (legible directamente en el terminal).

Respuesta JSON
ipstringDirección IP analizada
ipTypestringVersión: IPv4 o IPv6
ipClassstringClase de IP (A, B, C)
hostnamestringReverse DNS
countrystringPaís
countryCodestringCódigo de país ISO 3166-1 (2 letras)
citystringCiudad
continentstringContinente
postalCodestringCódigo postal (si se conoce)
latitudenumberLatitud aproximada
longitudenumberLongitud aproximada
timezonestringZona horaria (IANA)
providerstringProveedor de acceso u operador
asnnumberNúmero de sistema autónomo (AS)
Solicitud
$ curl mon-ip.dev/json
Respuesta · application/json
{
"ip": "203.0.113.42",
"ipType": "IPv4",
"ipClass": "C",
"hostname": "42.113.0.203.example.net",
"country": "France",
"countryCode": "FR",
"city": "Paris",
"continent": "Europe",
"latitude": 48.8566,
"longitude": 2.3522,
"timezone": "Europe/Paris",
"provider": "Orange SA",
"asn": 3215
}
GET /{ip}/json

La misma información para cualquier dirección IPv4 o IPv6 indicada en la ruta. Los campos ausentes no se devuelven.

Parámetros
iprequeridoDirección IPv4 o IPv6 a analizar, en la ruta (ej.: 8.8.8.8)
Solicitud
$ curl mon-ip.dev/8.8.8.8/json
Respuesta · application/json
{
"ip": "8.8.8.8",
"ipType": "IPv4",
"ipClass": "A",
"country": "United States",
"countryCode": "US",
"city": "Mountain View",
"continent": "North America",
"latitude": 37.422,
"longitude": -122.085,
"provider": "Google LLC",
"asn": 15169
}

IP y Geolocalización

GET /api/v1/json

Devuelve información de geolocalización, ISP y seguridad de la IP del cliente.

Respuesta JSON
ipstringDirección IPv4
ipv6stringDirección IPv6 (si disponible)
hostnamestringReverse DNS
typestringTipo de IP (Residential, Business, etc.)
classstringClase de IP (A, B, C)
locationobjectcountry, countryCode, city, continent, latitude, longitude, timezone, postalCode
networkobjectprovider, asn
securityobjectIndicadores de seguridad (proxy, VPN, Tor, etc.)
Solicitud
$ curl https://mon-ip.dev/api/v1/json
Respuesta · application/json
{
"ip": "203.0.113.42",
"hostname": "42.113.0.203.example.net",
"type": "Residential",
"class": "C",
"location": {
"country": "France",
"countryCode": "FR",
"city": "Paris",
"latitude": 48.8566,
"longitude": 2.3522,
"timezone": "Europe/Paris"
},
"network": { "provider": "Orange SA", "asn": "AS3215" },
"security": { "proxy": false, "vpn": false, "tor": false }
}
GET /api/v1/ipv6

Detecta si el cliente se conecta por IPv4 o IPv6.

Respuesta JSON
ipstringDirección IP del cliente
is_ipv4booleantrue si IPv4
is_ipv6booleantrue si IPv6 nativo
protocolstring"IPv4" o "IPv6"
timestampstringMarca de tiempo ISO 8601
Solicitud
$ curl https://mon-ip.dev/api/v1/ipv6
Respuesta · application/json
{
"ip": "203.0.113.42",
"is_ipv4": true,
"is_ipv6": false,
"protocol": "IPv4",
"timestamp": "2026-03-09T14:30:00Z"
}

DNS y Dominios

GET /api/v1/dns

Realiza una resolución DNS para un tipo de registro dado.

Parámetros
hostrequeridoNombre de dominio (ej: google.com)
record_typerequeridoTipo: A, AAAA, MX, NS, TXT, CNAME, SOA, PTR, SRV
Respuesta JSON
hoststringDominio consultado
recordsarrayLista de registros: record_type, value, ttl
Solicitud
$ curl "https://mon-ip.dev/api/v1/dns?host=google.com&record_type=MX"
Respuesta · application/json
{
"host": "google.com",
"records": [
{ "record_type": "MX", "value": "10 smtp.google.com", "ttl": 300 }
]
}
GET /api/v1/whois

Devuelve la información WHOIS de un dominio o una IP.

Parámetros
targetrequeridoDominio o IP (ej: google.com)
Respuesta JSON
targetstringObjetivo consultado
rawstringRespuesta WHOIS sin procesar
parsedobjectdomain_name, registrar, creation_date, expiration_date, name_servers, status, dnssec
cachedbooleantrue si el resultado proviene del caché
Solicitud
$ curl https://mon-ip.dev/api/v1/whois?target=google.com
Respuesta · application/json
{
"target": "google.com",
"parsed": {
"domain_name": "google.com",
"registrar": "MarkMonitor Inc.",
"creation_date": "1997-09-15",
"expiration_date": "2028-09-14",
"name_servers": ["ns1.google.com", "ns2.google.com"],
"dnssec": "unsigned"
},
"cached": false
}
GET /api/v1/ssl

Verifica el certificado SSL/TLS de un dominio conectándose al puerto 443.

Parámetros
hostrequeridoNombre de dominio (ej: google.com)
Respuesta JSON
hoststringDominio probado
validbooleantrue si el certificado es válido
days_remainingnumberDías hasta la expiración
subjectstringSujeto (CN)
issuerstringEmisor (CN)
issuer_orgstringOrganización del emisor
valid_fromstringFecha de inicio (ISO 8601)
valid_tostringFecha de expiración (ISO 8601)
serialstringNúmero de serie
fingerprintstringHuella SHA-256
protocolstringProtocolo TLS (ej: TLSv1.3)
bitsnumber | nullTamaño de clave en bits
alt_namesstring[]Nombres alternativos (SAN)
Solicitud
$ curl https://mon-ip.dev/api/v1/ssl?host=google.com
Respuesta · application/json
{
"host": "google.com",
"valid": true,
"days_remaining": 62,
"subject": "*.google.com",
"issuer": "GTS CA 1C3",
"protocol": "TLSv1.3",
"alt_names": ["*.google.com", "google.com"]
}

Seguridad

GET /api/v1/blacklist

Verifica si una dirección IPv4 está listada en 8 listas negras DNS.

Parámetros
iprequeridoDirección IPv4 (ej: 8.8.8.8)
Respuesta JSON
ipstringIP probada
totalnumberNúmero de listas probadas
listednumberNúmero de listas donde aparece la IP
cleanbooleantrue si la IP no está en ninguna lista
resultsarrayDetalle por lista: name, zone, listed
Solicitud
$ curl https://mon-ip.dev/api/v1/blacklist?ip=8.8.8.8
Respuesta · application/json
{
"ip": "8.8.8.8",
"total": 8,
"listed": 0,
"clean": true,
"results": [
{ "name": "Spamhaus ZEN", "zone": "zen.spamhaus.org", "listed": false }
]
}

Red

GET /api/v1/ping SSE

Envía paquetes ICMP y devuelve los resultados en tiempo real vía Server-Sent Events.

Parámetros
hostrequeridoHost o IP (ej: 8.8.8.8)
countopcionalNúmero de paquetes (por defecto: 4)
Eventos SSE
starthost, resolved_ip
replyseq, ip, time_ms, ttl
timeoutseq
donealive, packets_sent, packets_received, packet_loss, min_ms, avg_ms, max_ms
errormessage
Solicitud
$ curl -N "https://mon-ip.dev/api/v1/ping?host=8.8.8.8&count=4"
Respuesta · text/event-stream
data: {"type":"start","host":"8.8.8.8","resolved_ip":"8.8.8.8"}
data: {"type":"reply","seq":1,"ip":"8.8.8.8","time_ms":12.4,"ttl":118}
data: {"type":"reply","seq":2,"ip":"8.8.8.8","time_ms":11.8,"ttl":118}
data: {"type":"done","alive":true,"packets_sent":4,"packets_received":4,"packet_loss":0,"min_ms":11.2,"avg_ms":12.0,"max_ms":12.8}
GET /api/v1/traceroute SSE

Traza la ruta de red hacia un host en tiempo real vía Server-Sent Events.

Parámetros
hostrequeridoHost o IP (ej: google.com)
Eventos SSE
starthost, resolved_ip
hophop, ip, hostname, rtt_ms
donetotal_hops, reached
errormessage
Solicitud
$ curl -N https://mon-ip.dev/api/v1/traceroute?host=google.com
Respuesta · text/event-stream
data: {"type":"start","host":"google.com","resolved_ip":"142.250.179.110"}
data: {"type":"hop","hop":1,"ip":"192.168.1.1","hostname":"gateway","rtt_ms":1.2}
data: {"type":"hop","hop":2,"ip":"10.0.0.1","hostname":"isp-router","rtt_ms":5.4}
data: {"type":"done","total_hops":12,"reached":true}
CORSTodos los endpoints aceptan solicitudes cross-origin (CORS).
SSELos endpoints ping y traceroute usan Server-Sent Events. EventSource / curl -N
KEYSu clave API se muestra solo una vez al crearla. Guárdela con cuidado.
SECLas claves API están cifradas con AES-256-GCM en reposo.
CLIcurl mon-ip.dev devuelve solo la IP: ideal en un script (IP=$(curl -s mon-ip.dev)).
Volver al inicio

Obtenga su IP desde la terminal

Use nuestra API o el comando curl para integrar mon-ip.dev en sus scripts.

API JSON →