Geolocalizar una IP
Una dirección IP por sí sola no dice casi nada útil hasta que se resuelve. Este endpoint convierte una IP en dos datos sólidos que provienen de los registros regionales de internet: el país donde está registrado el bloque y la red que lo administra —su nombre registrado, su rango de direcciones y su tipo de asignación— para que la lógica de precios, cumplimiento y fraude trabaje con datos de registro y no con suposiciones.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
Una dirección sin lugar es solo un número
Las direcciones IP se asignan en bloques a proveedores de internet, empresas de hosting y organizaciones, y esos bloques quedan registrados ante autoridades regionales que publican quién los administra y, a grandes rasgos, en qué país. La resolución funciona comparando una IP contra esos datos de registro, y produce una lectura confiable del país y de la organización que administra el bloque, sin contactar jamás al visitante. Es una consulta de registro, no una técnica de rastreo de dispositivos.
Qué le entrega la respuesta
La respuesta le da el país donde está registrado el bloque, el nombre registrado de la red que lo administra, el rango de direcciones que abarca ese bloque y su tipo de asignación —la diferencia entre una asignación directa a un operador grande y una sub-asignación más pequeña—. Lo que no le da es una ciudad, una región ni una calle: los datos de registro resuelven al país y al administrador del bloque, no a un punto en el mapa, y quien prometa precisión a nivel de calle a partir de una IP está prometiendo más de lo que el dato realmente permite.
Por qué la red importa tanto como el país
Dos IPs pueden estar en el mismo país y significar cosas muy distintas según quién administre el bloque. Un nombre registrado puede ser un proveedor de banda ancha residencial, otro una empresa de hosting en la nube con miles de clientes sin relación entre sí detrás. Mostrar el nombre y el tipo de la red registrada junto al país permite construir reglas que un campo de país por sí solo no puede sostener, como distinguir un hogar real de un servidor alquilado, sin fingir jamás que se conoce la calle exacta de donde vino la solicitud.
De los registros regionales a una consulta en vivo
Los registros regionales de internet que asignan los bloques de IP existen desde los inicios de la red, originalmente para evitar que el espacio de direcciones se agotara de forma desordenada. Esa misma estructura de registro, consultada en vivo mediante RDAP en el momento de la solicitud, es lo que permite resolver de forma automática sin una consulta manual contra una lista estática, y es la razón por la que el país y el administrador son confiables mientras que una ubicación física precisa simplemente no forma parte del registro.
Pensado para integrarse en flujos existentes
Llama el endpoint, recibe un task_id, y el resultado llega por su webhook firmado o por un enlace firmado válido por 24 horas. Está diseñado para insertarse en flujos de registro, checkout o registros de tráfico sin convertirse en el cuello de botella de ninguno.
Qué puede hacer con ella
Precios y moneda localizados
Muestre precios en la moneda y el idioma del visitante resolviendo el país registrado antes de renderizar el contenido.
Restricciones de contenido por país
Aplique reglas de acceso por país para contenido u ofertas que solo tienen licencia en ciertos países.
Contexto para prevención de fraude
Compare el país de la dirección de envío con el país resuelto de la IP para marcar pedidos que merecen una segunda revisión.
Analítica de tráfico por red
Segmente la analítica por el nombre de la red registrada para separar proveedores residenciales del tráfico de hosting o redes corporativas.
Preguntas frecuentes
¿Qué tan precisa es la ubicación?
Resuelve al país donde está registrado el bloque, que suele ser confiable, más la red que lo administra, no una ciudad, región ni calle. Los datos de registro pueden retrasarse ante reasignaciones, y las IPs de VPN o de redes móviles pueden estar registradas en otro lugar, así que trate el país y el administrador como los campos confiables.
¿Esta api de geolocalizacion de ip es gratuita?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Funciona con direcciones IPv6?
Sí, tanto IPv4 como IPv6 se resuelven a través del mismo endpoint.
¿Qué me dice el campo de red?
El nombre registrado, el rango de direcciones y el tipo de asignación del administrador del bloque, lo que muchas veces revela si el tráfico viene de una conexión residencial, una red empresarial o un proveedor de hosting — contexto que el país por sí solo no ofrece. Es el administrador registrado, no un identificador numérico de enrutamiento ni el nombre de una ciudad.
¿Puedo geolocalizar muchas IPs en bloque?
Cada llamada resuelve una IP; para volúmenes grandes, envíe una solicitud por IP y deje que el modelo asíncrono procese el volumen en paralelo.
¿Cómo recibo el resultado?
Obtiene un task_id de inmediato, y el país y la red resueltos llegan por su webhook firmado o por un enlace firmado válido por 24 horas.
¿Guardan las IPs que envío?
No. Los datos se eliminan al vencer el periodo de retención y nunca se usan para entrenar modelos.
¿Qué pasa si una consulta falla?
Se reintenta automáticamente hasta tres veces antes de devolver un error claro, y nunca se cobra una solicitud que no se completó.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/verify/ip-geo \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"ip":"8.8.8.8"}'const res = await fetch("https://api.kit.forhosting.com/verify/ip-geo", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"ip": "8.8.8.8"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/verify/ip-geo",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"ip": "8.8.8.8"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/verify/ip-geo", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"ip":"8.8.8.8"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"ip":"8.8.8.8"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/verify/ip-geo", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"ip": "8.8.8.8"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "verify.ip_geo",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |