API de consulta de IPv4

País, región, ciudad, coordenadas aproximadas, zona horaria, la red y el operador que hay detrás, indicadores de centro de datos y proxy, y un bloque de amenazas que indica si la dirección ha sido denunciada por abuso o ataques, y con qué gravedad. Si omites el parámetro ip, obtienes la dirección de quien hace la llamada, que es el caso habitual en los sitios web.

GEThttps://api.mygeocode.com/v1/ipv4?ip=...

Pruébalo en la demo Referencia completa

Ejemplo

Solicitud

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4?ip=8.8.8.8"

# The caller's own address
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4"

La geolocalización de una dirección IP a nivel de ciudad es una estimación y siempre lo será; la dirección pertenece a una red, no a una persona. El país es correcto en mucho más del 99 % de las direcciones. La ciudad es más fiable para los ISP residenciales y menos fiable para los operadores móviles y los centros de datos, por eso se marcan con indicadores.

Respuesta

{
  "status": "ok",
  "ip": "1.0.164.165",
  "version": 4,
  "found": true,
  "prefix": "1.0.164.0/24",
  "country": "Thailand",
  "country_code": "TH",
  "continent": "Asia",
  "continent_code": "AS",
  "region": "Krung Thep Maha Nakhon",
  "region_code": null,
  "city": "Bangkok",
  "postcode": "10200",
  "lat": 13.749976,
  "lon": 100.516819,
  "timezone": "Asia/Bangkok",
  "utc_offset": "+07:00",
  "utc_offset_seconds": 25200,
  "is_eu": false,
  "asn": 23969,
  "as_name": "TOT Public Company Limited",
  "org": "TOT Public Company Limited",
  "usage_type": "Eyeball",
  "registry": "apnic",
  "allocated": "2008-10-22",
  "tags": ["dsl"],
  "is_anycast": false,
  "is_satellite": false,
  "is_datacenter": false,
  "is_proxy": false,
  "is_vpn_provider": false,
  "is_tor": false,
  "is_private": false,
  "abuse_email": "abuse@totisp.net",
  "threat": {
    "listed": true,
    "score": 90,
    "source_count": 2,
    "categories": ["abuse", "attacker"],
    "is_tor": false,
    "is_tor_exit": false,
    "is_bogon": false,
    "listings": [
      { "category": "abuse", "confidence": 100, "recency_days": 1 },
      { "category": "attacker", "confidence": null, "recency_days": null }
    ]
  },
  "updated_at": "2026-09-18 06:53:39"
}

Qué recibes

Campo	Significado
`country`, `country_code`	Nombre del país y código ISO 3166-1 alfa-2.
`region`, `region_code`	Estado, provincia o equivalente, con su código ISO 3166-2 cuando existe.
`city`, `postcode`	La mejor estimación de la ciudad y el código postal. Se omite cuando se desconoce.
`lat`, `lon`	Coordenadas de la ciudad o, si no, del centro de la región o del país.
`timezone`	Nombre IANA, a partir de la ubicación.
`asn`, `org`	El número de sistema autónomo y la organización que anuncia el prefijo.
`is_datacenter`	La dirección está en un rango de hosting o de nube. Considera la ciudad poco fiable y ten en cuenta que el tráfico puede ser automatizado.
`is_proxy`, `is_tor`, `is_vpn_provider`	Evidencia, por dirección, de un relé de Tor o de su inclusión en listas de proxies; y, por separado, si el operador vende servicios de VPN.
`usage_type`, `tags`, `registry`, `allocated`, `abuse_email`	Qué tipo de operador gestiona la red, sus etiquetas de operador, qué registro la asignó y cuándo, y su contacto de abuso.
`threat`	Bloque de reputación: si está en listas o no, una puntuación de 0 a 100, cuántos informes independientes incluyen la dirección y en qué categorías, indicadores de Tor y bogon, y cada inclusión con su confianza y antigüedad. Se actualiza a diario.

Dónde se usa

Localizar una primera visita

Elige un país, una moneda, un idioma y unas unidades predeterminados antes de que el visitante haya escrito nada. Pasa la dirección del visitante como ip desde tu servidor.

Señales de fraude y abuso

Compara el país de la IP con el país de facturación. Trata is_proxy y is_datacenter como señales, no como veredictos.

Analítica sin cookies

Agrupa las visitas por país y región en el servidor a partir de los registros de acceso, sin ningún seguimiento del lado del cliente.

Precio y límites

Una llamada es una solicitud; cada dirección de un lote cuenta como una. Cada clave tiene 2.500 solicitudes gratuitas al día; a partir de ahí, 0,0001 € cada una del crédito prepago, o nada con una clave Unlimited (50 € al mes). Precios. ¿Vienes de ip-api, ipinfo o ipstack? Esos formatos están disponibles como hosts compatibles. Para direcciones IPv6, consulta la API de consulta de IPv6.