Documentación de la API

Guía completa para integrar IP Info API en tus aplicaciones

API v1.0 - Estable

Inicio Rápido

Obtener tu API Key

  1. Regístrate en nuestro sitio web
  2. Elige un plan de suscripción
  3. Completa el pago con Mercado Pago
  4. Recibe tu API key por email

Primera Consulta

# Ejemplo con cURL
curl "https://protected-array.com/json/8.8.8.8?key=TU_API_KEY"

# Respuesta JSON
{
  "query": "8.8.8.8",
  "country": "United States",
  "countryCode": "US",
  "status": "success"
}

Autenticación

Todas las consultas requieren un parámetro key con tu API key.

Importante: Mantén tu API key segura y no la compartas en código público.

Endpoints de la API

GET /json/{ip}

Devuelve información de geolocalización en formato JSON.

Parámetros:

  • ip (requerido) - Dirección IP a consultar
  • key (requerido) - Tu API key

Ejemplo:

GET https://protected-array.com/json/8.8.8.8?key=tu_api_key

Respuesta:

{
  "query": "8.8.8.8",
  "country": "United States",
  "countryCode": "US",
  "status": "success"
}
GET /csv/{ip}

Devuelve información de geolocalización en formato CSV.

Ejemplo:

GET /csv/8.8.8.8?key=tu_api_key

Respuesta CSV:

status,query,country,countryCode
success,8.8.8.8,United States,US
GET /jsonp/{ip}

Devuelve información en formato JSONP para llamadas cross-domain.

Parámetros adicionales:

  • callback (requerido) - Nombre de la función callback

Ejemplo:

GET /jsonp/8.8.8.8?key=tu_api_key&callback=myFunction

Respuesta:

myFunction({
  "query": "8.8.8.8",
  "country": "United States",
  "countryCode": "US",
  "status": "success"
});

Esquema de Respuesta

Campo Tipo Descripción
query string La IP consultada
country string Nombre del país
countryCode string Código ISO del país (2 letras)
status string Estado de la consulta ("success" o "fail")
message string Mensaje de error (solo en caso de fallo)

Códigos de Error

Invalid IP address

La dirección IP proporcionada no es válida.

Invalid API key

La API key proporcionada no existe o es inválida.

API key expired

Tu API key ha expirado. Renueva tu suscripción.

Request limit exceeded

Has excedido el límite de consultas de tu plan.

Límites de Uso

Basic

10,000

consultas/mes

500/min

Pro

100,000

consultas/mes

1,000/min

Enterprise

1,000,000

consultas/mes

Ilimitado

Ejemplos de Código

JavaScript

fetch('https://protected-array.com/json/8.8.8.8?key=TU_API_KEY')
  .then(response => response.json())
  .then(data => {
    console.log('País:', data.country);
    console.log('Código:', data.countryCode);
  })
  .catch(error => console.error('Error:', error));

Python

import requests

response = requests.get(
    'https://protected-array.com/json/8.8.8.8',
    params={'key': 'TU_API_KEY'}
)

data = response.json()
print(f"País: {data['country']}")
print(f"Código: {data['countryCode']}")

PHP

$url = 'https://protected-array.com/json/8.8.8.8?key=TU_API_KEY';
$response = file_get_contents($url);
$data = json_decode($response, true);

echo "País: " . $data['country'] . "\n";
echo "Código: " . $data['countryCode'] . "\n";

cURL

curl -X GET "https://protected-array.com/json/8.8.8.8?key=TU_API_KEY" \
     -H "accept: application/json"