Consulta de IPv4

Ubicación, zona horaria y datos de red de una dirección IPv4. Omite la dirección para consultar la de quien llama.

Parámetros

Ejemplo

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

// In a browser, with no ip parameter, this returns the visitor's own address
const geo = await (await fetch("https://api.mygeocode.com/v1/ipv4", { headers: { "X-API-Key": "YOUR_KEY" } })).json();
console.log(geo.country_code, geo.timezone);

import requests

geo = requests.get("https://api.mygeocode.com/v1/ipv4", params={"ip": "1.1.1.1"}, headers={"X-API-Key": "YOUR_KEY"}, timeout=5).json()
print(geo["country_code"], geo["org"], geo["is_datacenter"])

{
  "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"
}

Campos de la respuesta

Cualquier versión en una sola llamada

GET /v1/ip acepta una dirección IPv4 o IPv6 (o ninguna, para la de quien llama) y devuelve el mismo registro que los endpoints específicos de cada versión. Úsalo cuando no sepas de antemano qué tipo de dirección vas a recibir.

Notas

• Las direcciones anycast como 1.1.1.1 y 8.8.8.8 se sirven desde muchos lugares a la vez. La ubicación devuelta es la registrada, y por eso is_datacenter es true para ellas.
• Llámalo desde tu servidor con la dirección del visitante en ip. Llamarlo sin ip devuelve la dirección desde la que llegó la solicitud, que detrás de un proxy o CDN es la del proxy.
• Los datos de IP se actualizan cada semana. Un tiempo de caché de un día es razonable.

La misma consulta en los formatos de otros proveedores

Si ya tienes código escrito para uno de estos proveedores, consérvalo: el host compatible acepta la misma ruta y los mismos parámetros y responde con la estructura de respuesta de ese proveedor, con este endpoint detrás. Consulta cómo funcionan los hosts compatibles.

Errores

400 invalid_request cuando ip no es una dirección IPv4 válida, cuando se envía una dirección IPv6 a este endpoint (usa /v1/ipv6), o cuando ips tiene más de 100 entradas.