🌐 Consulta de Geoubicación IP

Endpoint

https://api.verifik.co/v2/ip-lookup

El servicio de Consulta de Geoubicación IP geolocaliza una dirección IPv4 o IPv6 y devuelve país, región, ciudad, ISP/ASN, coordenadas y zona horaria. Úselo para detección de fraude, control de acceso y puntuación de riesgo.

Campos habituales: country, countryCode, region, regionName, city, zip, lat, lon, timezone, isp, org, as.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parámetros

Name	Type	Required	Description
ip	string	Yes	Dirección IPv4 o IPv6 a geolocalizar.

Solicitud

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/ip-lookup", {
  params: { ip: "8.8.8.8" },
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
  },
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/ip-lookup"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"ip": "8.8.8.8"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Respuesta

200

{
  "data": {
    "country": "United States",
    "countryCode": "US",
    "region": "CA",
    "regionName": "California",
    "city": "Mountain View",
    "zip": "94043",
    "lat": 37.4056,
    "lon": -122.0775,
    "timezone": "America/Los_Angeles",
    "isp": "Google LLC",
    "org": "Google Public DNS",
    "as": "AS15169 Google LLC"
  },
  "signature": {
    "dateTime": "January 16, 2024 3:44 PM",
    "message": "Certified by Verifik.co"
  }
}

404

{
  "code": "NotFound",
  "message": "Record not found."
}

409

{
  "code": "MissingParameter",
  "message": "\"ip\" is required"
}

Notas

• Sandbox: 8.8.8.8 devuelve fila demo EE.UU.; 192.168.100.1–192.168.100.10 devuelven fixtures Colombia; 192.168.100.99 → 404.
• La disponibilidad upstream puede variar; caídas pueden devolver 5xx.
• Trate los resultados como señales de red/ubicación según sus políticas de privacidad y fraude.