SDKs oficiais do OpenIPApi
Baixe os clientes oficiais leves para JavaScript, Python e PHP.
Todos os SDKs apontam para a mesma REST API em https://api.openipapi.com, autenticam com o header X-API-Key e expõem os mesmos métodos: lookup(ip), me(), batch(ips), asn(asn), validate(ip).
JavaScript / TypeScript
Baixar: openipapi.jsInstalar / usar
Coloque o arquivo no seu projeto (ou importe diretamente de /sdk/javascript/openipapi.js no navegador). Funciona em navegadores modernos e no Node.js 18+. Sem etapa de build, sem dependências de terceiros.
Compatibilidade de endpoints
Todos os cinco endpoints REST: lookup, me, batch, asn, validate. Endpoints restritos a planos continuam exigindo o plano correspondente na sua chave de API.
Exemplo
import { OpenIPApi } from '/sdk/javascript/openipapi.js';
const client = new OpenIPApi('YOUR_KEY');
const data = await client.lookup('8.8.8.8');
console.log(data.threat?.is_vpn);
// Batch lookup
const batch = await client.batch(['8.8.8.8', '1.1.1.1']);
Python
Baixar: openipapi.pyInstalar / usar
Coloque o arquivo no seu projeto e importe-o. Python 3.8+. Usa apenas a biblioteca padrão (urllib).
Compatibilidade de endpoints
Todos os cinco endpoints REST: lookup, me, batch, asn, validate. Endpoints restritos a planos continuam exigindo o plano correspondente na sua chave de API.
Exemplo
from openipapi import OpenIPApi
client = OpenIPApi("YOUR_KEY")
data = client.lookup("8.8.8.8")
print(data.get("threat", {}).get("is_vpn"))
# Batch lookup
batch = client.batch(["8.8.8.8", "1.1.1.1"])
Instalar / usar
Coloque o arquivo no seu projeto e use require. PHP 8.0+. Usa cURL quando disponível, com fallback via stream context. Não requer Composer.
Compatibilidade de endpoints
Todos os cinco endpoints REST: lookup, me, batch, asn, validate. Endpoints restritos a planos continuam exigindo o plano correspondente na sua chave de API.
Exemplo
require __DIR__ . '/OpenIPApiClient.php';
$client = new OpenIPApiClient('YOUR_KEY');
$data = $client->lookup('8.8.8.8');
echo !empty($data['threat']['is_vpn']) ? 'yes' : 'no';
// Batch lookup
$batch = $client->batch(['8.8.8.8', '1.1.1.1']);
Fallback HTTP direto
Nenhum SDK é necessário para usar o OpenIPApi. A API é uma camada fina de REST + JSON — qualquer cliente HTTP funciona:
$ curl https://api.openipapi.com/v1/lookup/8.8.8.8 \
-H "X-API-Key: YOUR_KEY"
Versões nos registros de pacotes npm, PyPI e Packagist poderão ser adicionadas no futuro.