API miip.link - Documentación

Endpoint Principal

GET Obtener información de IP https://miip.link/api/myip

Respuesta JSON

{
  "success": true,
  "ip": "2803:9810:510e:4d10:2d3b:ba2d:e180:25e3",
  "type": "IPv6",
  "isp": "Starlink Chile SPA",
  "asn": "AS14593",
  "city": "Bogotá",
  "region": "Bogota D.C.",
  "country": "Colombia",
  "countryCode": "CO",
  "latitude": 4.6097,
  "longitude": -74.0817,
  "timezone": "America/Bogota",
  "postal": "11001",
  "currency": "COP"
}

Campos Disponibles

Campo	Tipo	Descripción
`ip`	string	Dirección IP del cliente
`type`	string	IPv4 o IPv6
`isp`	string	Proveedor de internet
`city`	string	Ciudad estimada
`region`	string	Región/estado
`country`	string	País
`countryCode`	string	Código ISO del país (CO, US, etc.)
`latitude`	number	Latitud geográfica
`longitude`	number	Longitud geográfica
`timezone`	string	Zona horaria
`postal`	string	Código postal

💻 Ejemplos de Código

⚡ JavaScript

fetch('https://miip.link/api/myip')
  .then(res => res.json())
  .then(data => {
  });

🐍 Python

import requests

r = requests.get('https://miip.link/api/myip')
data = r.json()
print(f"IP: {data['ip']}")
print(f"País: {data['country']}")

🐘 PHP

$data = json_decode(
  file_get_contents(
    'https://miip.link/api/myip'
  ), true
);
echo "IP: " . $data['ip'];

🖥️ cURL

curl https://miip.link/api/myip

# Respuesta:
# {"ip":"1.2.3.4","country":"CO",...}

🔑 Autenticación API Key

La API funciona sin API key con límites bajos. Con una API key obtienes límites más altos:

Plan	Sin Key	Con Key	Precio
Free	100 req/día	100 req/día	Gratis
Developer	—	10,000 req/día	$9/mes
Business	—	Ilimitado	$29/mes

Uso: Añade ?api_key=TU_KEY a cualquier endpoint.

# Sin API key (límite: 100 req/día)
curl https://miip.link/api/json

# Con API key (límite: según plan)
curl https://miip.link/api/json?api_key=pk_free_xxx

🔌 Todos los Endpoints

Método	Endpoint	Descripción	Parámetros
GET	`/api/json`	Tu IP + geolocalización	`?api_key=xxx`
GET	`/api/myip`	Alias de /api/json	`?api_key=xxx`
GET	`/api/geo`	Geolocalizar IP específica	`?ip=1.2.3.4&api_key=xxx`
GET	`/api/dns`	Consulta registros DNS	`?domain=google.com&type=A`
GET	`/api/whois`	Información de dominio	`?domain=google.com`
GET	`/api/ports`	Escanear puertos comunes	`?host=1.2.3.4`

Ejemplos por Endpoint

🌍 /api/geo - Geolocalizar IP

# Tu IP automáticamente
curl https://miip.link/api/geo

# IP específica
curl https://miip.link/api/geo?ip=8.8.8.8

# Respuesta:
{
  "ip": "8.8.8.8",
  "type": "IPv4",
  "isp": "Google LLC",
  "city": "Ashburn",
  "country": "United States",
  "latitude": 39.03,
  "longitude": -77.5
}

🔍 /api/dns - Consulta DNS

# Registro A (IPv4)
curl https://miip.link/api/dns?domain=google.com&type=A

# Registro AAAA (IPv6)
curl https://miip.link/api/dns?domain=google.com&type=AAAA

# Registro MX (email)
curl https://miip.link/api/dns?domain=gmail.com&type=MX

# Tipos: A, AAAA, MX, TXT, NS, CNAME

/api/whois - Info de Dominio

curl https://miip.link/api/whois?domain=miip.link

# Respuesta:
{
  "domain": "miip.link",
  "status": "Dominio activo",
  "nameservers": ["bart.ns.cloudflare.com", "sima.ns.cloudflare.com"]
}

🔌 /api/ports - Escaneo de Puertos

curl https://miip.link/api/ports?host=scanme.nmap.org

# Respuesta:
{
  "host": "scanme.nmap.org",
  "ports": [
    {"port": 22, "service": "SSH", "open": false},
    {"port": 80, "service": "HTTP", "open": true},
    {"port": 443, "service": "HTTPS", "open": false}
  ]
}

# Puertos escaneados: 21, 22, 23, 25, 80, 443, 3306, 3389, 5432, 8080

Límites por Plan

Plan	Requests/Hora	Requests/Día	Precio
Sin Key	60	500	Gratis
Free API Key	100	100	Gratis
Developer	1,000	10,000	$9/mes
Business	5,000	Ilimitado	$29/mes

Nota: Sin API key se aplican límites globales por IP. Con API key los límites son por key, lo que permite más requests desde múltiples dispositivos.

60

Requests/min
(límite global)

300s

Cache TTL
(geolocalización)

30 días

API Key válida
(renovable)

🎯 Casos de Uso

🌍 Geolocalización

Mostrar contenido localizado según país, ciudad o zona horaria del usuario.

🔒 Seguridad

Detectar proxies, VPNs y bloquear acceso desde países específicos.

Analytics

Analizar el tráfico y ubicación de usuarios en tiempo real.

🛡️ Protección

Rate limiting inteligente basado en IP y comportamiento.

Documentación de la API