Bibliotecas cliente

Encontre o código-fonte e as instruções de configuração do cliente da sua linguagem.

Escolha sua linguagem

Instale um cliente, faça uma consulta e leia os campos da resposta.

O seletor de linguagem precisa de JavaScript. Todos os repositórios dos clientes estão disponíveis abaixo.

TypeScript / JavaScript SDK

TypeScript / JavaScript

enrichip

Testado em execução

Requisitos: Módulos ES · testado no Node 26
Versão do pacote: 1.0.1

Instalar

Terminal

npm install enrichip@1.0.1

Consultar um IP

node lookup.mjs

lookup.mjs

import { queryIP } from "enrichip";

const info = await queryIP("1.1.1.1");
console.log(JSON.stringify(info, null, 2));

Comportamento do cliente

Este exemplo usa o pacote publicado no npm. O argumento IP aceita uma string, inclusive IPv6 na forma comprimida; o HEAD do repositório possui um validador mais restritivo.
O cliente não expõe um tempo limite por requisição. Use os exemplos HTTP quando precisar controlar diretamente as configurações da requisição.

Python

ipapi-py

Testado em execução

Requisitos: Testado no Python 3.13 · Pydantic 2
Revisão do código-fonte: 9bd6552

Instalar

Terminal

git clone https://github.com/ipqwery/ipapi-py.git
cd ipapi-py
git checkout 9bd655266582ec70d90d01296aa92784da5a27a5
python -m pip install "httpx==0.28.1" "pydantic>=2,<3"

Consultar um IP

python lookup.py

lookup.py

from ipapi.client import IPAPIClient

client = IPAPIClient()
try:
    info = client.query_ip("1.1.1.1")
    print(info.model_dump_json(indent=2))
finally:
    client.client.close()

Comportamento do cliente

Execute lookup.py a partir da cópia local do código-fonte. A distribuição publicada ipcore 0.1.2 contém metadados do pacote, mas nenhum módulo ipapi importável; esta configuração usa o repositório fixado em uma revisão.
O cliente usa o método obsoleto parse_raw do Pydantic. Feche seu cliente HTTP após o uso; o wrapper não possui gerenciador de contexto.

github.com/ipqwery/ipapi-go

Testado em execução

Requisitos: Go 1.24.2 ou posterior
Revisão do código-fonte: fc7efc4

Instalar

Terminal

go get github.com/ipqwery/ipapi-go@fc7efc494870418b9f1143f642aba8f5802ebf9f

Consultar um IP

go run .

main.go

package main

import (
    "fmt"
    "log"
    ipapi "github.com/ipqwery/ipapi-go"
)

func main() {
    info, err := ipapi.QueryIP("1.1.1.1")
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(info.IP)
    if info.ISP != nil {
        fmt.Println(info.ISP.ASN)
    }
}

Comportamento do cliente

Execute o comando de instalação dentro de um módulo Go. QueryIP retorna um valor IPInfo aninhado e um erro para respostas HTTP sem sucesso.
O cliente não tem tempo limite por chamada. As tags omitempty omitem valores false e zero ao serializar o resultado novamente; os valores lidos são preservados.

Rust

ipapi

Testado em execução

Requisitos: Edição 2021 do Rust · Tokio
Revisão do código-fonte: 2313f1f

Instalar

Terminal

cargo add ipapi --git https://github.com/ipqwery/ipapi-rust --rev 2313f1f6028803d5fcffc3332bc3cfda8a61df7f
cargo add tokio --features macros,rt-multi-thread,time

Consultar um IP

cargo run

src/main.rs

use std::time::Duration;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let info = tokio::time::timeout(
        Duration::from_secs(5),
        ipapi::query_ip("1.1.1.1"),
    ).await??;
    println!("{}", info.ip);
    if let Some(isp) = info.isp {
        println!("{:?}", isp.asn);
    }
    Ok(())
}

Comportamento do cliente

Instale a revisão fixada do código-fonte em um projeto Cargo; a versão documentada do crates.io está indisponível. O exemplo limita a consulta a cinco segundos com um timeout do Tokio.
Os campos aninhados opcionais usam Option. O cliente decodifica a resposta sem verificar primeiro o status HTTP; consulte a referência HTTP para tratar respostas de erro.

Java

ipapi-java

Exemplo de código-fonte

Requisitos: JDK 21 · wrapper do Gradle
Revisão do código-fonte: 5e303a5

Instalar

Terminal

git clone https://github.com/ipqwery/ipapi-java.git
cd ipapi-java
git checkout 5e303a5dd2a373ae5b56a1f53139d8b8ca7f6761
./gradlew :app:build

Consultar um IP

Lookup.java

import ipapi.java.Ipapi;
import ipapi.java.IPInfo;

public class Lookup {
    public static void main(String[] args) throws Exception {
        IPInfo info = Ipapi.queryIp("1.1.1.1");
        System.out.println(info.getIp());
        if (info.getIsp() != null) {
            System.out.println(info.getIsp().getAsn());
        }
    }
}

Comportamento do cliente

Compile a revisão fixada com JDK 21. Este exemplo deve ser usado em um projeto consumidor com a biblioteca compilada no classpath; ele não foi testado em execução aqui.
O código usa métodos estáticos em ipapi.java, sem chave de API. O namespace io.ipapi e o construtor com chave de API do README não correspondem a esta revisão. O status HTTP não é verificado antes da decodificação.

C++

ipapi-cpp

Atualização necessária

Requisitos: C++20 · CMake · libcurl
Revisão do código-fonte: a5ae87c

Instalar

Esta revisão do código-fonte precisa de uma atualização antes do uso.

Inspecionar o código C++

Consultar um IP

Use uma requisição HTTP padrão

O callback e o mapeamento de risco atuais do C++ precisam de correções. Uma requisição HTTP nativa retorna a resposta completa da API.

Ver o endpoint HTTPS

Comportamento do cliente

O cliente atual interpreta cada bloco da resposta do libcurl como um documento JSON completo. Uma resposta dividida em blocos pode não ser decodificada corretamente.
O mapeamento de risco deixa is_datacenter e risk_score sem definição. O callback do próprio IP também usa um tipo de resultado diferente do esperado por quem o chama. Use uma requisição HTTP padrão até que esses caminhos sejam corrigidos.

ipapi

Exemplo de código-fonte

Requisitos: R 4.1 ou posterior
Revisão do código-fonte: 79cd732

Instalar

Console do R

install.packages("remotes")
remotes::install_github("ipqwery/ipapi-r@79cd73249bd1f8fa41d950bc37ba5b9f6ee6d2d9")

Consultar um IP

Rscript lookup.R

lookup.R

library(ipapi)

info <- query_ips("1.1.1.1")
print(info[, c("ip", "asn", "country_code")])

Comportamento do cliente

Passe apenas um endereço para query_ips. Um vetor com vários endereços usa o caminho legado de consulta em lote, que a API rejeita.
O resultado é um data frame com colunas achatadas. Este exemplo com revisão fixada do código-fonte não foi testado em execução aqui.

.NET

IpApi

Testado em execução

Requisitos: .NET 9+ · testado no .NET 10
Versão do pacote: 2024.12.23.223133

Instalar

Terminal

dotnet add package IpApi --version 2024.12.23.223133

Consultar um IP

dotnet run

Program.cs

using IpApi;
using Microsoft.Extensions.DependencyInjection;
using System.Text.Json;

var services = new ServiceCollection();
services.AddIpApiClient();
using var provider = services.BuildServiceProvider();
var client = provider.GetRequiredService<IIApiClient>();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var info = await client.QueryIpAsync("1.1.1.1", timeout.Token);
if (info is null) throw new InvalidOperationException("Empty IP response");
Console.WriteLine(JsonSerializer.Serialize(info));

Comportamento do cliente

Execute em um projeto de console .NET. A interface registrada é IIApiClient, com dois caracteres I iniciais; o nome IIpApiClient do README é diferente.
A resposta usa objetos aninhados Isp, Location e Risk. Passe um token de cancelamento para limitar a requisição. O método legado de múltiplos IPs não é suportado pela API.

Antes de integrar

Consultas de um único IP: Use um endereço por consulta. Alguns clientes ainda expõem métodos em lote; a API rejeita essas requisições. Ler a política de consultas em lote
Respostas do próprio IP: O endpoint raiz retorna por padrão o IP público do processo que se conecta como texto. Para uma resposta JSON completa do próprio IP, use os exemplos HTTP
Escopo da verificação: Testado em execução significa que o pacote ou a revisão exibidos foram executados em consultas de um único IP. Os exemplos de código-fonte foram revisados em relação ao código, mas não executados. Uma revisão pode ser diferente de um pacote publicado.

Prefere HTTP nativo?Copie uma requisição com tempo limite e tratamento de erros HTTP.