IP Coğrafi Konum API
Herhangi bir genel IPv4 veya IPv6 adresi için ülke, bölge, şehir, koordinat ve saat dilimi. MaxMind GeoLite2 ile güçlendirilmiştir — tamamen yerel hesaplama, paylaşımlı rate limit yok.
API key'iniz yok mu?
API key'lerinizi oluşturmak ve yönetmek için hesabınızda oturum açın.
Entegrasyon rehberi
Bir snippet kopyalayın, API anahtarınızı yerleştirin, çalıştırın. Herhangi bir HTTP istemcisinde çalışır — aşağıdaki örnekler cURL, JavaScript ve Python içindir.
/api/ip-geolocationhttps://www.apipick.comGet geolocation data for any public IP address
ipstringisteğe bağlıPublic 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
}Gerçek Dünya Kullanım Senaryoları İçin Tasarlandı
Dolandırıcılık Tespiti
Yüksek riskli bölgelerden gelen kayıtları veya işlemleri işaretleyin. Bir kullanıcının IP'sinin beyan ettiği konum veya fatura ülkesiyle eşleşip eşleşmediğini kontrol edin.
İçerik Yerelleştirme
Ziyaretçi konumuna göre dili, para birimini ve bölgesel fiyatlandırmayı otomatik seçin. AB uyumlu çerez banner'larını yalnızca AB ziyaretçilerine gösterin.
Rate Limit'leme
Ülke bazlı rate limit'ler veya erişim kontrolleri uygulayın. Pahalı güvenlik araçları satın almadan belirli bölgelerden gelen trafiği engelleyin veya kısıtlayın.
Yapay Zeka Ajanı Zenginleştirmesi
Yapay zeka ajanlarının kullanıcı kayıtlarını zenginleştirmesine, lead'leri coğrafyaya göre sınıflandırmasına veya gerçek zamanlı IP verilerine göre üretilen içeriği yerelleştirmesine izin verin.
ipinfo.io ve ipapi.co Alternatifi
Hesap başına kredi ücretlendirmesi — paylaşımlı rate-limit havuzu yok, plan katmanları yok, ayın ilk günü sıfırlanan aylık üst sınırlar yok.
ipinfo.io | ipapi.co | API Pick ✓ | |
|---|---|---|---|
| Ücretsiz katman | 50k req/month | 1,000 req/day | Kayıtta 100 kredi |
| Rate limit'leme modeli | Paylaşımlı IP havuzu riski | Paylaşımlı IP havuzu riski | Hesap başına kredi |
| Krediler / kota sona erer mi? | Aylık sıfırlama | Günlük sıfırlama | Asla sona ermez |
| Ülke + bölge + şehir | ✓ | ✓ | ✓ |
| Saat dilimi | Ücretli plan | ✓ | ✓ |
| IPv6 desteği | ✓ | ✓ | ✓ |
| AB üyeliği işareti | Ücretli plan | ✓ | ✓ |
| Başlamak için kredi kartı gerekmez | ✓ | ✓ | ✓ |
| Yapay zeka ajanı / LLM'ye hazır | Kısmi | Kısmi | ✓ Yerel JSON |
Paylaşımlı rate-limit havuzu sorunu
ipinfo.io ve ipapi.co ücretsiz katmanlarında rate limit'ler istemci IP'si başına uygulanır. Bu, aynı Vercel, AWS veya GCP bölgesinden gelen tüm isteklerin tek bir kota havuzunu paylaştığı anlamına gelir. Aynı edge düğümündeki başka bir kiracı 1.000'lik günlük limiti çoktan tüketmişse, henüz tek bir istek bile yapmamış olsanız da API çağrılarınız başarısız olmaya başlar.
Kredi bazlı ücretlendirme: her ölçekte öngörülebilir
API Pick IP başına değil, hesap başına ücretlendirir. Her çağrı bakiyenizden tam olarak 1 kredi düşer — yalnızca başarılı bir yanıtta. Krediler asla sona ermez. İster tek bir günde 10 sorgu yapın ister 10.000, yalnızca kullandığınız kadar ödersiniz ve paylaşımlı bir kotadan kaynaklanan sürpriz hata riski sıfırdır.
Yanıt Alanları
| Alan | Tür | Açıklama |
|---|---|---|
| data.ip | string | Sorgulanan IP adresi |
| data.country_code | string | ISO 3166-1 alpha-2 ülke kodu (ör. US, DE, JP) |
| data.country_name | string | İngilizce tam ülke adı |
| data.continent | string | Kıta adı (ör. Kuzey Amerika, Avrupa) |
| data.continent_code | string | İki harfli kıta kodu (ör. NA, EU) |
| data.city | string | Şehir adı (mevcut değilse boş dize) |
| data.latitude | number | null | IP konumunun yaklaşık enlemi |
| data.longitude | number | null | IP konumunun yaklaşık boylamı |
| data.timezone | string | IANA saat dilimi tanımlayıcısı (ör. America/Los_Angeles) |
| data.currency | string | Ülke için ISO 4217 para birimi kodu (ör. USD, EUR) |
| data.isp | string | ASN veritabanından İSS / kuruluş adı |
| data.asn | integer | null | Otonom Sistem Numarası (ör. Google için 15169) |
| credits_used | integer | Bu istek için düşülen kredi |
| remaining_credits | integer | Hesabınızda kalan kredi |
Rate limit'ler
Sınırlama, API anahtarı başına ve 60 saniyelik kayan pencere ile uygulanır. Sınıra ulaştığınızda Retry-After başlığıyla birlikte temiz bir 429 alırsınız.
120req/min
API anahtarı başına, endpoint başına. 60 saniyelik kayan pencere.
3concurrent
API anahtarı başına maksimum eşzamanlı işlemdeki istek sayısı.
X-RateLimit-LimitDakika başına izin verilen maksimum istek sayısıX-RateLimit-RemainingMevcut penceredeki kalan istek sayısıX-RateLimit-ResetMevcut pencere sıfırlanana kadarki saniyeRetry-AfterYeniden denemeden önce beklenecek saniye (yalnızca 429'da)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
}Sıkça Sorulan Sorular
S: Bir IP adresi göndermezsem ne olur?
C: Endpoint, arayanın IP'sini istek başlıklarından (X-Forwarded-For) otomatik algılar. Bu, IP'yi açıkça göndermeden son kullanıcının coğrafi konumunu belirlemek istediğiniz sunucu tarafı sorgular için yararlıdır.
S: Özel IP'ler destekleniyor mu?
C: Hayır. Özel IP'ler (192.168.x.x, 10.x.x.x gibi RFC 1918 aralıkları), loopback (127.0.0.1) ve diğer ayrılmış aralıklar 400 hatası döndürür. Yalnızca herkese açık yönlendirilebilir IPv4 ve IPv6 adresleri desteklenir.
S: Coğrafi konum ne kadar doğru?
C: MaxMind GeoLite2-City ile güçlendirilmiştir. Ülke düzeyinde doğruluk genellikle %95–99'dur. Şehir düzeyinde doğruluk bölgeye göre değişir — Kuzey Amerika ve Avrupa'da genellikle güvenilirdir, Asya ve Afrika'nın bazı kısımlarında daha az kesindir. Koordinatlar kesin bir fiziksel konumu değil, genel bir bölgeyi temsil eder.
S: Yapay zeka ajanları bunu bir tool olarak kullanabilir mi?
C: Evet. Endpoint tek bir isteğe bağlı ip sorgu parametresi kabul eder ve düz bir JSON nesnesi döndürür — OpenAI, Claude, LangChain veya herhangi bir ajan framework için bir function tool olarak sunması kolaydır. Kullanıcı konumu üzerine akıl yürütmesi, coğrafya bazlı kurallar uygulaması veya lead verilerini bölgesel bağlamla zenginleştirmesi gereken ajanlar için yararlıdır.
IP Coğrafi Konum'u Claude Code ve Yapay Zeka Ajanlarında Kullanın
Herhangi bir IP adresini doğrudan yapay zeka kodlama ajanınız içinde coğrafi olarak konumlandırmak için resmi Claude Code skill'ini yükleyin — doğal dille ülke, şehir, İSS, saat dilimi ve daha fazlası.
Yapay zeka ajanınıza doğal biçimde sorun
Uyumlu platformlar
APIpick IP Geolocation API'si için Claude Code skill'i
Herhangi bir IP adresi için ülke, kıta, şehir, enlem/boylam, IANA saat dilimi, ISO para birimi kodu, İSS adı ve ASN döndürür.