Geolocalizzazione IP API
Paese, regione, città, coordinate e fuso orario di qualsiasi indirizzo IPv4 o IPv6 pubblico. Powered by MaxMind GeoLite2 — calcolo totalmente locale, nessun limite di frequenza condiviso.
Non hai una API key?
Accedi al tuo account per creare e gestire le tue API key.
Guida all'integrazione
Copia uno snippet, sostituisci la tua API key, esegui. Funziona con qualsiasi client HTTP — esempi qui sotto in cURL, JavaScript e Python.
/api/ip-geolocationhttps://www.apipick.comGet geolocation data for any public IP address
ipstringfacoltativoPublic IPv4 or IPv6 address. Omit to look up caller's own IP. 8.8.8.8
curl -X GET "https://www.apipick.com/api/ip-geolocation" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"code": 200,
"message": "ok",
"data": {
"ip": "8.8.8.8",
"country_code": "US",
"country_name": "United States",
"continent": "North America",
"continent_code": "NA",
"city": "Mountain View",
"latitude": 37.4056,
"longitude": -122.0775,
"timezone": "America/Los_Angeles",
"currency": "USD",
"isp": "Google LLC",
"asn": 15169
},
"credits_used": 1,
"remaining_credits": 99
}Costruita per casi d'uso reali
Rilevamento frodi
Segnala registrazioni o transazioni da regioni ad alto rischio. Verifica se l'IP di un utente corrisponde alla località dichiarata o al paese di fatturazione.
Localizzazione dei contenuti
Seleziona automaticamente lingua, valuta e prezzi regionali in base alla località del visitatore. Mostra i banner sui cookie conformi all'UE solo ai visitatori dell'UE.
Limitazione della frequenza
Applica limiti di frequenza o controlli di accesso per paese. Blocca o limita il traffico da regioni specifiche senza acquistare costosi strumenti di sicurezza.
Arricchimento per agenti IA
Consenti agli agenti IA di arricchire i record degli utenti, classificare i lead per area geografica o localizzare i contenuti generati in base ai dati IP in tempo reale.
Alternativa a ipinfo.io e ipapi.co
Fatturazione a crediti per account — nessun pool di limiti di frequenza condiviso, nessun livello di piano, nessun tetto mensile che si azzera il primo del mese.
ipinfo.io | ipapi.co | API Pick ✓ | |
|---|---|---|---|
| Piano gratuito | 50k req/month | 1,000 req/day | 100 crediti alla registrazione |
| Modello di limitazione frequenza | Rischio pool IP condiviso | Rischio pool IP condiviso | Crediti per account |
| I crediti / la quota scadono? | Reset mensile | Reset giornaliero | Non scadono mai |
| Paese + regione + città | ✓ | ✓ | ✓ |
| Fuso orario | Piano a pagamento | ✓ | ✓ |
| Supporto IPv6 | ✓ | ✓ | ✓ |
| Indicatore appartenenza UE | Piano a pagamento | ✓ | ✓ |
| Nessuna carta di credito per iniziare | ✓ | ✓ | ✓ |
| Pronta per agenti IA / LLM | Parziale | Parziale | ✓ JSON nativo |
Il problema del pool di limiti di frequenza condiviso
Con i piani gratuiti di ipinfo.io e ipapi.co, i limiti di frequenza sono applicati per IP client. Ciò significa che tutte le richieste dalla stessa regione Vercel, AWS o GCP condividono un unico pool di quota. Se un altro tenant sullo stesso nodo edge ha già esaurito il limite giornaliero di 1.000, le tue chiamate API iniziano a fallire — anche se non hai ancora fatto una singola richiesta.
Fatturazione a crediti: prevedibile a qualsiasi scala
API Pick addebita per account, non per IP. Ogni chiamata scala esattamente 1 credito dal tuo saldo — solo in caso di risposta riuscita. I crediti non scadono mai. Che tu faccia 10 ricerche o 10.000 in un solo giorno, paghi solo per ciò che usi senza alcun rischio di fallimenti a sorpresa dovuti a una quota condivisa.
Campi della risposta
| Campo | Tipo | Descrizione |
|---|---|---|
| data.ip | string | L'indirizzo IP interrogato |
| data.country_code | string | Codice paese ISO 3166-1 alpha-2 (es. US, DE, JP) |
| data.country_name | string | Nome completo del paese in inglese |
| data.continent | string | Nome del continente (es. North America, Europe) |
| data.continent_code | string | Codice continente a due lettere (es. NA, EU) |
| data.city | string | Nome della città (stringa vuota se non disponibile) |
| data.latitude | number | null | Latitudine approssimativa della località dell'IP |
| data.longitude | number | null | Longitudine approssimativa della località dell'IP |
| data.timezone | string | Identificatore di fuso orario IANA (es. America/Los_Angeles) |
| data.currency | string | Codice valuta ISO 4217 del paese (es. USD, EUR) |
| data.isp | string | Nome dell'ISP / organizzazione dal database ASN |
| data.asn | integer | null | Autonomous System Number (es. 15169 per Google) |
| credits_used | integer | Crediti scalati per questa richiesta |
| remaining_credits | integer | Crediti rimanenti nel tuo account |
Limiti di frequenza
Il throttling è per API key, con finestra mobile di 60 secondi. Al raggiungimento del limite ricevi un 429 pulito con header Retry-After.
120req/min
Per API key e per endpoint. Finestra mobile di 60 secondi.
3concurrent
Numero massimo di richieste simultanee in corso per API key.
X-RateLimit-LimitNumero massimo di richieste consentite al minutoX-RateLimit-RemainingRichieste rimanenti nella finestra correnteX-RateLimit-ResetSecondi al reset della finestra correnteRetry-AfterSecondi da attendere prima di riprovare (solo in caso di 429)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}Domande frequenti
D: Cosa succede se non passo un indirizzo IP?
R: L'endpoint rileva automaticamente l'IP del chiamante dagli header della richiesta (X-Forwarded-For). È utile per le ricerche lato server in cui vuoi geolocalizzare l'utente finale senza passare l'IP esplicitamente.
D: Gli IP privati sono supportati?
R: No. Gli IP privati (intervalli RFC 1918 come 192.168.x.x, 10.x.x.x), il loopback (127.0.0.1) e altri intervalli riservati restituiscono un errore 400. Sono supportati solo gli indirizzi IPv4 e IPv6 instradabili pubblicamente.
D: Quanto è accurata la geolocalizzazione?
R: Powered by MaxMind GeoLite2-City. L'accuratezza a livello di paese è in genere del 95–99%. L'accuratezza a livello di città varia per regione — generalmente affidabile in Nord America ed Europa, meno precisa in alcune parti dell'Asia e dell'Africa. Le coordinate rappresentano l'area generale, non una posizione fisica precisa.
D: Gli agenti IA possono usarla come tool?
R: Sì. L'endpoint accetta un singolo parametro di query ip facoltativo e restituisce un oggetto JSON piatto — facile da esporre come funzione tool per OpenAI, Claude, LangChain o qualsiasi framework di agenti. Utile per gli agenti che devono ragionare sulla località dell'utente, applicare regole geografiche o arricchire i dati dei lead con il contesto regionale.
Usa Geolocalizzazione IP in Claude Code e negli agenti IA
Installa la skill ufficiale per Claude Code per geolocalizzare qualsiasi indirizzo IP direttamente all'interno del tuo agente di coding IA — paese, città, ISP, fuso orario e altro in linguaggio naturale.
Chiedi al tuo agente IA in modo naturale
Piattaforme compatibili
Skill per Claude Code per l'API APIpick Geolocalizzazione IP
Restituisce paese, continente, città, latitudine/longitudine, fuso orario IANA, codice valuta ISO, nome dell'ISP e ASN per qualsiasi indirizzo IP.