API de iplover
Endpoints gratuitos en JSON y texto plano: tu propia dirección, quién está detrás de cualquier dirección, su tipo de red y si un rastreador es quien dice ser. Sin clave, sin registro, y con CORS abierto, así que también puedes usarla desde el navegador.
Primeros pasos
Desde una terminal, sin configurar nada:
curl iplover.com
curl https://iplover.com/json
curl https://iplover.com/api/check/8.8.8.8.txt
curl "https://iplover.com/api/verify-bot.txt?ip=66.249.66.1&ua=Googlebot"
Endpoints
| Endpoint | Qué devuelve | Límite |
|---|---|---|
GET /ip | Tu dirección pública en texto plano. | Ninguno |
GET /json | Tu dirección, ubicación aproximada y red. | Ninguno |
GET /json/{ip} | El registro y el DNS inverso de cualquier dirección pública. | 30 por minuto más el presupuesto común de 60 por minuto |
GET /api/check/{ip} | Quién está detrás de una dirección: categoría, tipo de red y titular, con las pruebas. | 30 por minuto más el presupuesto común de 60 por minuto |
GET /api/verify-bot | Si un rastreador es quien dice su user agent. | 30 por minuto más el presupuesto común de 60 por minuto |
POST /api/classify | El tipo de red de hasta 100 direcciones en una sola petición. | 30 por minuto |
GET /api/asn/index | Una tabla dirección → red, en trozos pequeños, para buscar en el navegador. | 30 por minuto solo cuentan las peticiones que nuestra caché no puede responder |
GET /ip
Tu dirección pública en texto plano.
Formato: text
Límite: Ninguno
curl iplover.com da la misma respuesta: los clientes de línea de comandos (curl, Wget, HTTPie, xh, PowerShell) reciben solo la dirección en la página principal. Ambos funcionan también por HTTP simple, para scripts que no siguen redirecciones.
Ejemplo
curl iplover.com
curl https://iplover.com/ip
Respuesta de ejemplo
203.0.113.7
GET /json
Tu dirección, ubicación aproximada y red.
Formato: JSON
Límite: Ninguno
La ubicación es la estimación de Cloudflare para tu conexión: normalmente la ciudad de la pasarela de tu proveedor, no tu casa. Una VPN o una red móvil la cambian.
Ejemplo
curl https://iplover.com/json
Respuesta de ejemplo
{
"ip": "203.0.113.7",
"ip_version": 4,
"country": "Italy",
"country_code": "IT",
"region": "Lombardy",
"city": "Milan",
"postal_code": "20121",
"latitude": 45.4642,
"longitude": 9.19,
"timezone": "Europe/Rome",
"asn": 64500,
"as_organization": "Example Telecom",
"user_agent": "curl/8.5.0"
}
GET /json/{ip}
El registro y el DNS inverso de cualquier dirección pública.
Formato: JSON
Límite: 30 por minuto (más el presupuesto común de 60 por minuto)
Consultamos el registro regional (RDAP) y un resolvedor DNS público. Si una parte falla, queda vacía y status y errors explican por qué. Las respuestas completas se guardan en caché una hora. Las direcciones privadas y reservadas reciben un 422 con su kind.
Parámetros
{ip}(en la ruta)- Una dirección IPv4 o IPv6.
Ejemplo
curl https://iplover.com/json/8.8.8.8
Respuesta de ejemplo
{
"ip": "8.8.8.8",
"ip_version": 4,
"summary": "This address belongs to Google LLC (a cloud/hosting network) in the United States. Its reverse DNS name is dns.google.",
"network": { "name": "GOGL", "handle": "NET-8-8-8-0-2", "range": "8.8.8.0 - 8.8.8.255", "cidr": ["8.8.8.0/24"], "country": "United States", "country_code": "US", "country_source": "address" },
"owner": { "organization": "Google LLC", "abuse_email": "network-abuse@google.com" },
"registration": { "registered": "2023-12-28", "last_changed": "2023-12-28", "registry": "ARIN" },
"hosting_network": true,
"reverse_dns": ["dns.google"],
"status": { "rdap": "ok", "reverse_dns": "ok", "rdap_via": "rdap.org" },
"errors": { "rdap": null, "reverse_dns": null },
"sources": { "rdap": "https://rdap.arin.net/registry/ip/8.8.8.8", "reverse_dns": "https://cloudflare-dns.com/dns-query" },
"fetched_at": "2026-11-16T19:20:48.593Z",
"cached": false
}
Errores: invalid_ip, not_public, rate_limited
GET /api/check/{ip}
Quién está detrás de una dirección: categoría, tipo de red y titular, con las pruebas.
Formato: JSON · text
Límite: 30 por minuto (más el presupuesto común de 60 por minuto)
Revisa las listas publicadas que se describen en Fuentes de datos (nubes, grandes empresas, rastreadores, escáneres, Tor, VPN, listas de bloqueo), además del registro y el DNS inverso con confirmación directa. Añade .txt para texto plano y ?lang= para el idioma de los textos legibles. Las direcciones privadas y reservadas reciben un 200 con la categoría reserved.
Parámetros
{ip}(en la ruta)- Una dirección IPv4 o IPv6.
lang(query)- Idioma de los textos legibles: en, it, de, es, fr, pt. Los nombres de campo y los códigos siempre están en inglés.
format(query)textpara texto plano (igual que añadir.txt).
Ejemplo
curl https://iplover.com/api/check/8.8.8.8
curl https://iplover.com/api/check/8.8.8.8.txt
Campos principales
category- La coincidencia más fuerte, una de las categorías de abajo.
ispsignifica que ninguna lista coincide: una red normal. level- Cuánta atención merece:
bad,warn,info,goodoneutral. verdict,explanation,action- Tres frases en el idioma pedido: qué es, por qué y qué hacer.
matched- Las fuentes que coinciden, con la prueba: una lista, el DNS inverso o el número de red.
sources- Cada fuente y su resultado:
matched,not_matchedonot_checked. Una fuente que no pudimos revisar nunca cuenta como resultado limpio. owner- El registro: organización, rango, contacto de abuso y fechas.
asn- El número de la red que anuncia la dirección, y su nombre.
reverse_dns- El nombre PTR, y si apunta de vuelta a la dirección (
forward_confirmed). country- Dónde está registrado el rango, no dónde está el dispositivo.
network- Tipo de red (residencial, móvil, hosting, VPN, Tor…).
identifiedcuando lo dice una lista publicada,estimatedcuando lo deducimos, y marcado como estimación. lists- Cuántas fuentes se revisaron y lo recientes que son nuestras copias.
Categorías
category | Etiqueta | level |
|---|---|---|
attacker | Ha atacado nuestros sensores | bad |
blocklisted | En una lista de bloqueo | bad |
tor | Nodo de salida de Tor | warn |
relay | Relay de privacidad | info |
scanner | Escáner de internet conocido | info |
bot | Rastreador verificado | good |
cloud | Proveedor de nube o hosting | info |
service | Red propia de una gran empresa | info |
isp | Red de un proveedor o de una empresa | neutral |
reserved | Dirección privada o reservada | info |
unknown | Datos insuficientes | info |
Las etiquetas siguen ?lang=. Un tipo de red como VPN, Tor u hosting no es señal de abuso; solo attacker y blocklisted tratan del comportamiento.
Respuesta de ejemplo
{
"ip": "8.8.8.8",
"ip_version": 4,
"category": "service",
"category_label": "Large company's own network",
"level": "info",
"verdict": "This address is part of Google's own network.",
"explanation": "It is in the IP ranges Google publishes for its own services (such as search, email or public DNS), not in the ranges it rents to cloud customers. …",
"action": "No action is needed based on these sources. If traffic from it misbehaves, report it to the abuse contact of Google.",
"matched": [{ "source": "google", "name": "Google IP ranges (goog.json)", "kind": "service", "evidence": "list", "detail": null }],
"sources": [{ "source": "aws", "name": "AWS IP address ranges", "kind": "cloud", "status": "not_matched", "updated_at": "2026-11-16T05:37:05Z" }, …],
"owner": { "organization": "Google LLC", "network": "GOGL", "cidr": ["8.8.8.0/24"], "range": "8.8.8.0 - 8.8.8.255", "abuse_email": "network-abuse@google.com", "registry": "ARIN", … },
"owner_status": "ok",
"asn": { "number": 15169, "name": "Google LLC" },
"reverse_dns": { "name": "dns.google", "forward_confirmed": true, "forward_addresses": [], "forward_error": false, "resolver": "cloudflare" },
"country": { "code": "US", "name": "United States", "source": "address" },
"network": {
"primary": "service",
"status": "identified",
"label": "Company's own network",
"explanation": "This address is in the IP ranges Google publishes for its own services, …",
"types": [{ "type": "service", "basis": "list", "source": "google", "provider": "Google", "label": "Company's own network", "attribution": null, … }],
"attribution": null,
"crawler": null,
"note": "The network type describes the network, not the person. …"
},
"providers": [{ "id": "ip2proxy", "name": "IP2Proxy", "status": "not_configured" }, …],
"lists": { "version": "89d308802d8e", "built_at": "2026-11-16T19:17:44.219Z", "newest_update": "2026-11-16T19:17:44.219Z", "checked": 36, "not_checked": 1, … },
"checked_at": "2026-11-16T19:31:38.854Z",
"language": "en",
"note": "No source is complete. …"
}
Errores: invalid_ip, rate_limited
GET /api/verify-bot
Si un rastreador es quien dice su user agent.
Formato: JSON · text
Límite: 30 por minuto (más el presupuesto común de 60 por minuto)
Indica ip, ua o ambos. Con una dirección, la comparamos con los rangos publicados del bot y con el DNS inverso con confirmación directa. Sin ella, solo te decimos qué bot dice ser el user agent. /api/verify-bot.txt devuelve texto plano. Las peticiones sin dirección no cuentan para el límite.
Parámetros
ip(query)- La dirección que envió la petición (opcional).
ua(query)- El User-Agent que envió (opcional), hasta 1000 caracteres.
lang(query)- Idioma de los textos legibles: en, it, de, es, fr, pt. Los nombres de campo y los códigos siempre están en inglés.
Ejemplo
curl "https://iplover.com/api/verify-bot?ip=66.249.66.1&ua=Googlebot"
curl "https://iplover.com/api/verify-bot.txt?ip=66.249.66.1&ua=Googlebot"
Campos principales
verdict- La respuesta: uno de los valores de abajo.
claim,botclaimes el bot que nombra el user agent;botes el bot al que se refiere el veredicto.identified- Bots cuyos rangos publicados o cuyo DNS inverso coinciden con la dirección.
evidence- La comprobación del DNS inverso y las listas consultadas, con sus fechas.
network- El tipo de red de la dirección, como en
/api/check.
Veredictos
verified- La dirección está en los rangos publicados del bot, o su DNS inverso está confirmado bajo el dominio del operador.
spoofed- El user agent dice ser un bot que publica cómo verificarlo, y la dirección no coincide: probablemente falso.
different- La dirección pertenece a otro bot conocido, no al que dice ser.
unverified- El bot que dice ser no publica nada con qué comprobarlo, o su lista no estaba disponible: no podemos decirlo.
notbot- No dice ser ningún bot, y la dirección no está en los rangos de ningún bot.
claim- Solo se dio un user agent: el bot que dice ser.
noclaim- Solo se dio un user agent, y no nombra ningún bot conocido.
Respuesta de ejemplo
{
"ip": "66.249.66.1",
"user_agent": "Googlebot",
"verdict": "verified",
"reason": null,
"claim": { "slug": "googlebot", "name": "Googlebot", "operator": "Google", "category": "search", "tokens": ["Googlebot"], "robots": "yes", "verify": "ip" },
"bot": { "slug": "googlebot", … },
"identified": [{ "slug": "googlebot", "name": "Googlebot", "source": "googlebot", "list": "Google common crawlers (Googlebot)", "evidence": "list", … }],
"evidence": {
"reverse_dns": { "name": "crawl-66-249-66-1.googlebot.com", "forward_confirmed": true, "operator_domain": true, … },
"lists": [{ "id": "googlebot", "name": "Google common crawlers (Googlebot)", "fetched_at": "2026-11-16T19:17:44.219Z", "source_time": "2026-11-16T15:45:57.000000", "count": 317, … }]
},
"network": { "primary": "service", "status": "identified", "label": "Company's own network", "crawler": { "name": "Googlebot", "source": "googlebot", "evidence": "list", … }, … },
"owner": "Google LLC",
"asn": { "number": 15169, "name": "Google LLC" },
"known_bots": 34,
"checked_at": "2026-11-16T19:32:09.527Z"
}
Errores: empty, invalid_ip, rate_limited
POST /api/classify
El tipo de red de hasta 100 direcciones en una sola petición.
Formato: JSON
Límite: 30 por minuto
Usa solo nuestras copias de las listas publicadas: no consulta registros, servidores DNS ni otros servicios. Por eso es rápido, pero no da titular ni DNS inverso. El cuerpo puede tener como máximo 16 KB. Los duplicados se juntan, y las entradas que no son direcciones vuelven en invalid. Nuestro revisor de logs usa este endpoint.
Parámetros
ips(cuerpo JSON)- Una lista de direcciones:
{"ips": ["…"]}. lang(query)- Idioma de los textos legibles: en, it, de, es, fr, pt. Los nombres de campo y los códigos siempre están en inglés.
Ejemplo
curl -X POST https://iplover.com/api/classify \
-H "Content-Type: application/json" \
-d '{"ips": ["8.8.8.8", "185.220.101.1"]}'
Campos principales
results- Una entrada por dirección:
category,level,verdict,matched(ids de fuentes) ynetwork. invalid- Entradas que no son direcciones IP.
Respuesta de ejemplo
{
"results": [
{ "ip": "8.8.8.8", "category": "service", "category_label": "Large company's own network", "level": "info", "verdict": "This address is part of Google's own network.", "matched": ["google"], "network": { "primary": "service", "status": "identified", "label": "Company's own network", … } },
{ "ip": "185.220.101.1", "category": "tor", "category_label": "Tor exit node", "level": "warn", "verdict": "This is a Tor exit node.", "matched": ["tor", "x4bnet-vpn"], "network": { "primary": "tor", "status": "identified", "label": "Tor exit node", "types": [{ "type": "tor", … }, { "type": "vpn", "label": "Known VPN range (community list)", "attribution": "Source: X4BNet lists_vpn (CC BY-SA 4.0)", … }], … } }
],
"invalid": [],
"checked_at": "2026-11-16T19:21:02.311Z",
"note": "Network types from published lists only. Nothing you send is stored. …"
}
Errores: invalid_json, no_ips, invalid_ip, method_not_allowed, too_large, too_many, no_public_ips, rate_limited, unavailable
GET /api/asn/index
- GET
/api/asn/{gen}/v{family}/{shard}/{hash} - GET
/api/asn/n/{shard}/{hash}
Una tabla dirección → red, en trozos pequeños, para buscar en el navegador.
Formato: JSON · binary · text
Límite: 30 por minuto (solo cuentan las peticiones que nuestra caché no puede responder)
Nuestra prueba WebRTC y el revisor de logs la usan para encontrar la red de una dirección sin enviarla a ningún sitio: descarga el índice, toma el último trozo que empieza en la dirección o antes, y busca en él. El formato binario está en el archivo OpenAPI, y hay un lector en /js/asnmap.js. Los nombres y países de las redes están en 256 trozos de texto: la red n está en el trozo n % 256. Se reconstruye cada día a partir de iptoasn.com (dominio público). Si necesitas la tabla entera, descárgala de iptoasn.com.
Ejemplo
curl https://iplover.com/api/asn/index
Respuesta de ejemplo
{
"gen": 1,
"fetched_at": "2026-11-16T09:37:04.503Z",
"source_date": "2026-11-01T09:38:43.000Z",
"source": "https://iptoasn.com/",
"license": "PDDL 1.0 (public domain)",
"rows": { "v4": 405962, "v6": 94218 },
"v4": [0, 93810688, 136380928, …],
"v6": ["0000000000000000", …],
"h4": ["9c1e04aa", …],
"h6": ["51f0c2d7", …],
"hn": ["0be2a1c4", …]
}
Errores: not_found, rate_limited, unavailable
Errores
Los errores son JSON con un código error estable y un message legible. El mensaje está en inglés y su redacción puede cambiar, así que usa el código. Los endpoints de texto plano devuelven el mensaje como texto, con el mismo código de estado.
HTTP/1.1 429 Too Many Requests
Retry-After: 60
Content-Type: application/json; charset=utf-8
{
"error": "rate_limited",
"message": "Too many checks. Try again in a minute."
}
| Código | Estado | Significado |
|---|---|---|
invalid_ip | 400 | No es una dirección IPv4 ni IPv6. |
empty | 400 | No se indicó ip ni ua. |
invalid_json | 400 | El cuerpo no es JSON válido. |
no_ips | 400 | Falta la lista ips, o está vacía. |
method_not_allowed | 405 | Método incorrecto: usa POST. |
not_found | 404 | Ese trozo no existe, o la tabla aún no está creada. |
too_large | 413 | El cuerpo supera 16 KB. |
too_many | 413 | Más de 100 direcciones. |
not_public | 422 | Una dirección privada, reservada o de uso especial. kind dice cuál. |
no_public_ips | 422 | Solo direcciones privadas o reservadas. |
rate_limited | 429 | Demasiadas peticiones: espera los segundos que indica Retry-After (60). |
unavailable | 503 | Un problema temporal por nuestra parte: vuelve a intentarlo en un minuto. |
Límites de peticiones
- Los límites se aplican por visitante: una dirección IPv4, o un /64 de IPv6 (una conexión suele controlar un /64 entero).
- Cada endpoint permite 30 peticiones por minuto. Los endpoints que contactan con otros servidores (
/json/<ip>,/api/checky/api/verify-botcon una dirección) comparten además un presupuesto de 60 por minuto, para que usar varios a la vez no lo multiplique. /ipy/jsonno tienen límite. En la tabla de redes solo cuentan las peticiones que nuestra caché no puede responder.- Por encima del límite recibes
429conRetry-After: 60. Espera y luego sigue: no reintentes en un bucle continuo. - Los contadores se llevan en cada ubicación de Cloudflare y son aproximados. Si el abuso lo hace necesario, los bajaremos y lo diremos aquí.
Ejemplos de código
Cada ejemplo revisa una dirección y espera cuando alcanza el límite.
curl
# -f hace que curl falle en 4xx y 5xx; --retry espera y reintenta con 429
curl -sf https://iplover.com/api/check/8.8.8.8 || echo "failed: see the status code"
curl -s --retry 3 --retry-delay 60 https://iplover.com/json
Python
# pip install requests
import time
import requests
def check(ip, lang="en"):
while True:
r = requests.get(f"https://iplover.com/api/check/{ip}",
params={"lang": lang}, timeout=20,
headers={"User-Agent": "my-app/1.0 (+https://example.com)"})
if r.status_code == 429: # rate limited: wait, then retry
time.sleep(int(r.headers.get("Retry-After", "60")))
continue
r.raise_for_status()
return r.json()
result = check("8.8.8.8")
print(result["category"], "-", result["verdict"])
# Up to 100 addresses at once, from the lists only
r = requests.post("https://iplover.com/api/classify",
json={"ips": ["8.8.8.8", "185.220.101.1"]}, timeout=20)
for item in r.json()["results"]:
print(item["ip"], item["category"])
JavaScript
// Works in browsers (CORS is open), Node 18+, Deno and Workers.
async function check(ip, lang = "en") {
for (;;) {
const res = await fetch(`https://iplover.com/api/check/${encodeURIComponent(ip)}?lang=${lang}`);
if (res.status === 429) {
// Rate limited: wait Retry-After seconds, then retry.
const wait = Number(res.headers.get("Retry-After") || 60);
await new Promise((resolve) => setTimeout(resolve, wait * 1000));
continue;
}
const body = await res.json();
if (!res.ok) throw new Error(`${body.error}: ${body.message}`);
return body;
}
}
const result = await check("8.8.8.8");
console.log(result.category, result.verdict, result.network?.label);
Versiones y cambios
- La versión actual es la 1.3.0. La URL no lleva versión.
- Podemos añadir campos y valores nuevos en cualquier momento: ignora los que no conozcas.
- No eliminaremos ni renombraremos un campo documentado, ni cambiaremos su significado, sin anunciarlo aquí con al menos 30 días de antelación, salvo para frenar un abuso o cumplir la ley.
- Los textos legibles (veredictos, etiquetas, mensajes) pueden cambiar de redacción en cualquier momento. No los analices: usa los códigos.
Cambios
- 1.3.0 ():
asnganacountryyregistry: el país y el registro de la asignación a la que pertenece la dirección (de Team Cymru), no una ubicación. El nombre del titular ahora sale de los objetos role de RIPE cuando el registrante es solo una cuenta de mantenimiento, y un 404 de rdap.org ahora consulta también al registro. - 1.2.0 (): El tipo de red ahora puede venir del nombre de DNS inverso de la dirección (por ejemplo
dynamic.pool-…omob-…) y de palabras de proveedor de internet en los nombres de la red; un campo nuevoevidencedice de dónde. - 1.1.0 (): El tipo de red ahora tiene en cuenta todos los nombres de la red (organización y nombre en el registro, nombre del ASN), usa una lista comunitaria de centros de datos, dice «ISP residencial o de empresa (estimación)» en lugar de «No identificado» cuando los nombres no coinciden con nada, y tiene un campo nuevo
confidence. - 1.0.0 (): Primera versión documentada.
Uso libre y uso justo
- Gratis para uso personal y comercial, sin clave. No hay garantía ni garantía de disponibilidad: consulta las condiciones de uso.
- Mantente dentro de los límites, guarda en caché lo que puedas y envía un User-Agent con el nombre de tu app y una forma de contactarte.
- No la uses para escanear rangos de direcciones ni para crear o revender una copia de nuestros datos. No la uses como único motivo para bloquear a personas: un tipo de red no es prueba de abuso.
- Los resultados incluyen datos de las fuentes que aparecen en Fuentes de datos, cada una con sus propias condiciones. Algunas piden reconocimiento: conserva el texto de
attributioncuando muestres esos resultados. - Podemos bloquear sin aviso el tráfico que dañe el servicio. Mencionarnos se agradece, pero no es obligatorio.
Qué pasa con lo que envías
No guardamos ni registramos las direcciones o user agents que envías, ni tu propia dirección.
Para responder, /json/<ip>, /api/check y /api/verify-bot envían la dirección a rdap.org y a los servicios RDAP de los registros de internet, y la consultan mediante resolvedores DNS públicos (Cloudflare, o Google como alternativa), que preguntan a Team Cymru su número de red. /api/classify y la tabla de redes no envían nada a nadie. Cloudflare, nuestro proveedor de alojamiento, procesa cada petición: consulta la política de privacidad.
Las demás URL bajo /api/ (como /api/email-domain, /api/health y /report.json) sirven a nuestras propias páginas y a la monitorización. No forman parte de esta API y pueden cambiar sin aviso.