Geolokalizacja IP API
Kraj, region, miasto, współrzędne i strefa czasowa dla dowolnego publicznego adresu IPv4 lub IPv6. Napędzane przez MaxMind GeoLite2 — w pełni lokalne obliczenia, bez współdzielonych limitów zapytań.
Nie masz klucza API?
Zaloguj się na swoje konto, aby tworzyć klucze API i nimi zarządzać.
Przewodnik integracji
Skopiuj fragment kodu, podmień swój klucz API, uruchom. Działa w dowolnym kliencie HTTP — przykłady poniżej w cURL, JavaScript i Pythonie.
/api/ip-geolocationhttps://www.apipick.comGet geolocation data for any public IP address
ipstringopcjonalnePublic 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
}Stworzone do rzeczywistych przypadków użycia
Wykrywanie oszustw
Oznaczaj rejestracje lub transakcje z regionów wysokiego ryzyka. Sprawdź, czy IP użytkownika zgadza się z deklarowaną lokalizacją lub krajem rozliczeniowym.
Lokalizacja treści
Automatycznie dobieraj język, walutę i regionalne ceny na podstawie lokalizacji odwiedzającego. Wyświetlaj zgodne z przepisami UE bannery cookie tylko odwiedzającym z UE.
Ograniczanie zapytań
Stosuj limity zapytań lub kontrolę dostępu per kraj. Blokuj lub ograniczaj ruch z określonych regionów bez kupowania drogich narzędzi bezpieczeństwa.
Wzbogacanie danych przez agentów AI
Pozwól agentom AI wzbogacać rekordy użytkowników, klasyfikować leady według geografii lub lokalizować generowaną treść na podstawie danych IP w czasie rzeczywistym.
Alternatywa dla ipinfo.io i ipapi.co
Rozliczanie kredytowe per konto — bez współdzielonej puli limitów zapytań, bez poziomów planów, bez miesięcznych limitów resetujących się pierwszego dnia miesiąca.
ipinfo.io | ipapi.co | API Pick ✓ | |
|---|---|---|---|
| Darmowy poziom | 50k req/month | 1,000 req/day | 100 kredytów przy rejestracji |
| Model ograniczania zapytań | Ryzyko współdzielonej puli IP | Ryzyko współdzielonej puli IP | Kredyty per konto |
| Czy kredyty / limit wygasają? | Reset miesięczny | Reset dzienny | Nigdy nie wygasają |
| Kraj + region + miasto | ✓ | ✓ | ✓ |
| Strefa czasowa | Plan płatny | ✓ | ✓ |
| Obsługa IPv6 | ✓ | ✓ | ✓ |
| Flaga członkostwa w UE | Plan płatny | ✓ | ✓ |
| Bez karty kredytowej na start | ✓ | ✓ | ✓ |
| Gotowe dla agentów AI / LLM | Częściowo | Częściowo | ✓ Natywny JSON |
Problem współdzielonej puli limitów zapytań
W darmowych poziomach ipinfo.io i ipapi.co limity zapytań są egzekwowane per IP klienta. Oznacza to, że wszystkie żądania z tego samego regionu Vercel, AWS lub GCP dzielą jedną pulę limitów. Jeśli inny najemca na tym samym węźle brzegowym zużył już dzienny limit 1000, Twoje wywołania API zaczynają zawodzić — choć nie wykonałeś jeszcze ani jednego żądania.
Rozliczanie kredytowe: przewidywalne w każdej skali
API Pick nalicza per konto, nie per IP. Każde wywołanie odejmuje dokładnie 1 kredyt z Twojego salda — wyłącznie przy udanej odpowiedzi. Kredyty nigdy nie wygasają. Niezależnie od tego, czy wykonasz 10 czy 10 000 wyszukiwań w ciągu jednego dnia, płacisz tylko za to, czego używasz, bez ryzyka niespodziewanych błędów z powodu współdzielonego limitu.
Pola odpowiedzi
| Pole | Typ | Opis |
|---|---|---|
| data.ip | string | Odpytywany adres IP |
| data.country_code | string | Kod kraju ISO 3166-1 alpha-2 (np. US, DE, JP) |
| data.country_name | string | Pełna angielska nazwa kraju |
| data.continent | string | Nazwa kontynentu (np. North America, Europe) |
| data.continent_code | string | Dwuliterowy kod kontynentu (np. NA, EU) |
| data.city | string | Nazwa miasta (pusty ciąg, jeśli niedostępna) |
| data.latitude | number | null | Przybliżona szerokość geograficzna lokalizacji IP |
| data.longitude | number | null | Przybliżona długość geograficzna lokalizacji IP |
| data.timezone | string | Identyfikator strefy czasowej IANA (np. America/Los_Angeles) |
| data.currency | string | Kod waluty ISO 4217 dla kraju (np. USD, EUR) |
| data.isp | string | Nazwa ISP / organizacji z bazy danych ASN |
| data.asn | integer | null | Numer systemu autonomicznego (np. 15169 dla Google) |
| credits_used | integer | Kredyty odjęte za to żądanie |
| remaining_credits | integer | Kredyty pozostałe na Twoim koncie |
Limity zapytań
Ograniczanie działa per klucz API, w przesuwnym oknie 60 sekund. Po przekroczeniu limitu otrzymasz czyste 429 z nagłówkiem Retry-After.
120req/min
Per klucz API, per endpoint. Przesuwne okno 60 sekund.
3concurrent
Maksymalna liczba jednoczesnych żądań w toku na klucz API.
X-RateLimit-LimitMaksymalna dozwolona liczba żądań na minutęX-RateLimit-RemainingPozostała liczba żądań w bieżącym oknieX-RateLimit-ResetSekundy do zresetowania bieżącego oknaRetry-AfterSekundy oczekiwania przed ponowieniem (tylko przy 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
}Najczęściej zadawane pytania
P: Co się stanie, jeśli nie przekażę adresu IP?
O: Endpoint automatycznie wykrywa IP osoby wywołującej z nagłówków żądania (X-Forwarded-For). Jest to przydatne przy wyszukiwaniach po stronie serwera, gdy chcesz zgeolokalizować użytkownika końcowego bez jawnego przekazywania IP.
P: Czy prywatne adresy IP są obsługiwane?
O: Nie. Prywatne adresy IP (zakresy RFC 1918, takie jak 192.168.x.x, 10.x.x.x), pętla zwrotna (127.0.0.1) i inne zarezerwowane zakresy zwracają błąd 400. Obsługiwane są wyłącznie publicznie routowalne adresy IPv4 i IPv6.
P: Jak dokładna jest geolokalizacja?
O: Napędzana przez MaxMind GeoLite2-City. Dokładność na poziomie kraju wynosi zwykle 95–99%. Dokładność na poziomie miasta różni się w zależności od regionu — ogólnie niezawodna w Ameryce Północnej i Europie, mniej precyzyjna w części Azji i Afryki. Współrzędne przedstawiają ogólny obszar, a nie dokładną lokalizację fizyczną.
P: Czy agenci AI mogą używać tego jako narzędzia?
O: Tak. Endpoint przyjmuje pojedynczy opcjonalny parametr zapytania ip i zwraca płaski obiekt JSON — łatwo udostępnić go jako narzędzie funkcyjne dla OpenAI, Claude, LangChain lub dowolnego frameworku agentowego. Przydatne dla agentów, którzy muszą wnioskować o lokalizacji użytkownika, egzekwować reguły geograficzne lub wzbogacać dane leadów o kontekst regionalny.
Używaj IP Geolocation w Claude Code i agentach AI
Zainstaluj oficjalną umiejętność Claude Code, aby geolokalizować dowolny adres IP bezpośrednio w swoim agencie kodowania AI — kraj, miasto, ISP, strefa czasowa i więcej za pomocą języka naturalnego.
Zapytaj swojego agenta AI w naturalny sposób
Kompatybilne platformy
Umiejętność Claude Code dla API IP Geolocation od APIpick
Zwraca kraj, kontynent, miasto, szerokość/długość geograficzną, strefę czasową IANA, kod waluty ISO, nazwę ISP i ASN dla dowolnego adresu IP.