IP 지오로케이션 API
모든 공용 IPv4 또는 IPv6 주소의 국가, 지역, 도시, 좌표, 시간대를 조회합니다. MaxMind GeoLite2 기반 — 완전 로컬 연산으로 공유 레이트 리밋이 없습니다.
통합 가이드
스니펫을 복사하고 API 키를 교체한 뒤 실행하세요. 모든 HTTP 클라이언트에서 작동합니다 — 아래에 cURL, JavaScript, Python 예제가 있습니다.
/api/ip-geolocationhttps://www.apipick.comGet geolocation data for any public IP address
ipstring선택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
}실전 활용 사례를 위해 제작
사기 탐지
고위험 지역에서의 가입이나 거래를 표시하세요. 사용자의 IP가 본인이 주장한 위치나 청구 국가와 일치하는지 확인합니다.
콘텐츠 현지화
방문자 위치에 따라 언어, 통화, 지역별 가격을 자동 선택하세요. EU 방문자에게만 EU 규정을 준수하는 쿠키 배너를 표시합니다.
레이트 리밋
국가별 레이트 리밋이나 접근 제어를 적용하세요. 값비싼 보안 도구를 구매하지 않고도 특정 지역의 트래픽을 차단하거나 제한할 수 있습니다.
AI 에이전트 데이터 보강
AI 에이전트가 실시간 IP 데이터를 바탕으로 사용자 레코드를 보강하고, 지역별로 리드를 분류하거나 생성한 콘텐츠를 현지화하도록 하세요.
ipinfo.io & ipapi.co 대안
계정 단위 크레딧 청구 — 공유 레이트 리밋 풀도, 요금제 등급도, 매월 1일에 초기화되는 월간 한도도 없습니다.
ipinfo.io | ipapi.co | API Pick ✓ | |
|---|---|---|---|
| 무료 등급 | 50k req/month | 1,000 req/day | 가입 시 100 크레딧 |
| 레이트 리밋 모델 | 공유 IP 풀 리스크 | 공유 IP 풀 리스크 | 계정별 크레딧 |
| 크레딧 / 쿼터 만료? | 월간 초기화 | 일간 초기화 | 만료 없음 |
| 국가 + 지역 + 도시 | ✓ | ✓ | ✓ |
| 시간대 | 유료 요금제 | ✓ | ✓ |
| IPv6 지원 | ✓ | ✓ | ✓ |
| EU 회원국 표시 | 유료 요금제 | ✓ | ✓ |
| 시작 시 신용카드 불필요 | ✓ | ✓ | ✓ |
| AI 에이전트 / LLM 지원 | 부분 지원 | 부분 지원 | ✓ 네이티브 JSON |
공유 레이트 리밋 풀 문제
ipinfo.io와 ipapi.co 무료 등급에서는 레이트 리밋이 클라이언트 IP 단위로 적용됩니다. 즉, 같은 Vercel, AWS, GCP 리전에서 오는 모든 요청이 하나의 쿼터 풀을 공유합니다. 같은 엣지 노드의 다른 테넌트가 이미 일일 1,000 한도를 다 써버렸다면, 당신이 아직 단 한 번도 요청하지 않았더라도 API 호출이 실패하기 시작합니다.
크레딧 기반 청구: 어떤 규모에서도 예측 가능
API Pick은 IP가 아닌 계정별로 청구합니다. 모든 호출은 잔액에서 정확히 1 크레딧만 차감하며 — 성공한 응답에 대해서만 차감합니다. 크레딧은 만료되지 않습니다. 하루에 10번을 조회하든 10,000번을 조회하든, 사용한 만큼만 지불하며 공유 쿼터로 인한 예기치 못한 실패 위험이 전혀 없습니다.
응답 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| data.ip | string | 조회한 IP 주소 |
| data.country_code | string | ISO 3166-1 alpha-2 국가 코드 (예: US, DE, JP) |
| data.country_name | string | 영문 국가명 전체 |
| data.continent | string | 대륙명 (예: North America, Europe) |
| data.continent_code | string | 두 글자 대륙 코드 (예: NA, EU) |
| data.city | string | 도시명 (없으면 빈 문자열) |
| data.latitude | number | null | IP 위치의 대략적인 위도 |
| data.longitude | number | null | IP 위치의 대략적인 경도 |
| data.timezone | string | IANA 시간대 식별자 (예: America/Los_Angeles) |
| data.currency | string | 해당 국가의 ISO 4217 통화 코드 (예: USD, EUR) |
| data.isp | string | ASN 데이터베이스 기준 ISP / 조직명 |
| data.asn | integer | null | 자율 시스템 번호 (예: Google의 경우 15169) |
| credits_used | integer | 이 요청으로 차감된 크레딧 |
| remaining_credits | integer | 계정에 남은 크레딧 |
요청 제한
스로틀링은 API 키 단위, 60초 슬라이딩 윈도우입니다. 한도에 도달하면 Retry-After 헤더가 포함된 깔끔한 429를 받습니다.
120req/min
API 키별, 엔드포인트별. 60초 슬라이딩 윈도우.
3concurrent
API 키당 동시에 처리 중인 최대 요청 수.
X-RateLimit-Limit분당 허용되는 최대 요청 수X-RateLimit-Remaining현재 윈도우에 남은 요청 수X-RateLimit-Reset현재 윈도우가 초기화되기까지의 초Retry-After재시도 전 대기 초 (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
}자주 묻는 질문
Q: IP 주소를 전달하지 않으면 어떻게 되나요?
A: 엔드포인트가 요청 헤더(X-Forwarded-For)에서 호출자의 IP를 자동으로 감지합니다. IP를 명시적으로 전달하지 않고도 최종 사용자의 위치를 알아내고 싶은 서버 사이드 조회에 유용합니다.
Q: 사설 IP도 지원하나요?
A: 아니요. 사설 IP(192.168.x.x, 10.x.x.x 같은 RFC 1918 범위), 루프백(127.0.0.1), 기타 예약 범위는 400 오류를 반환합니다. 공개적으로 라우팅 가능한 IPv4와 IPv6 주소만 지원됩니다.
Q: 지오로케이션은 얼마나 정확한가요?
A: MaxMind GeoLite2-City 기반입니다. 국가 수준 정확도는 일반적으로 95~99%입니다. 도시 수준 정확도는 지역에 따라 다른데, 북미와 유럽에서는 대체로 신뢰할 만하지만 아시아와 아프리카 일부 지역에서는 덜 정확합니다. 좌표는 정밀한 물리적 위치가 아닌 대략적인 권역을 나타냅니다.
Q: AI 에이전트가 이것을 도구로 사용할 수 있나요?
A: 네. 엔드포인트는 선택적 ip 쿼리 매개변수 하나를 받아 평탄한 JSON 객체를 반환하므로 OpenAI, Claude, LangChain 등 어떤 에이전트 프레임워크의 함수 도구로도 쉽게 노출할 수 있습니다. 사용자 위치를 추론하거나, 지역 기반 규칙을 적용하거나, 리드 데이터에 지역 맥락을 보강해야 하는 에이전트에 유용합니다.
Claude Code와 AI 에이전트에서 IP Geolocation 사용하기
공식 Claude Code 스킬을 설치해 AI 코딩 에이전트 안에서 자연어로 모든 IP 주소를 바로 조회하세요 — 국가, 도시, ISP, 시간대 등을 확인할 수 있습니다.
AI 에이전트에게 자연스럽게 물어보세요
호환 플랫폼
APIpick IP Geolocation API용 Claude Code 스킬
모든 IP 주소의 국가, 대륙, 도시, 위도/경도, IANA 시간대, ISO 통화 코드, ISP명, ASN을 반환합니다.