Watch-IP

IP 조회 API 레퍼런스

GET/v1/lookup/{ip}

제공한 단일 IPv4 또는 IPv6 주소를 서드파티 IP 지오로케이션 데이터베이스를 사용해 확인합니다 — GET /v1/geo와는 다른 데이터 소스와 응답 형태를 가집니다. 서버 간 전용이므로 백엔드에서만 호출하고 브라우저에서는 절대 호출하지 마세요.

인증

Authorization: Bearer YOUR_SECRET_KEY로 시크릿 키를 전달하세요. GET /v1/geo가 사용하는 공개 가능 키와 달리, 이 키는 반드시 서버에만 있어야 합니다 — 여기에 공개 가능 키를 사용하면 403이 반환됩니다.

응답 필드

ip
제공한 IP 주소를 그대로 반환합니다.
country, city, continent
소스 데이터베이스로부터 얻은 대략적인 위치이며, 이용할 수 없으면 null입니다.
region
행정구역 코드입니다(예: "TX") — 지역 이름이 아니며, GET /v1/geo의 region 필드와는 형태가 다릅니다.
postalCode, timezone
현재 소스 데이터베이스에서는 채워지지 않으며, 항상 null입니다.
latitude, longitude
대략적인 좌표이며, 이용할 수 없으면 null입니다.
found
IP에 일치하는 레코드가 없거나 기반 데이터베이스가 일시적으로 이용 불가능한 경우 false입니다 — 이 필드로는 두 경우를 구분하지 않습니다.

오류

400
제공한 IP가 유효한 IPv4 또는 IPv6 주소가 아닙니다.
401
API 키가 없거나 유효하지 않습니다.
403
시크릿 키 대신 공개 가능 키가 사용되었습니다.
429
현재 1분 윈도우의 속도 제한을 초과했습니다.

예시

요청

curl https://api.watch-ip.com/v1/lookup/203.0.113.1 \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

응답

{
  "ip": "203.0.113.1",
  "country": "US",
  "region": "TX",
  "city": "Austin",
  "postalCode": null,
  "latitude": 30.2672,
  "longitude": -97.7431,
  "continent": "NA",
  "timezone": null,
  "found": true
}

제한 사항

조회된 IP 단위로 과금되며, 방문자 지오로케이션 요금제의 요청량과는 별도입니다 — 가격과 이용 가능 여부는 IP 조회 제품 페이지를 참고하세요. 호출당 여러 IP가 필요하신가요? 대신 배치 엔드포인트를 사용하세요. 이 엔드포인트의 위치 데이터는 DB-IP가 제공합니다(IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).

관련 페이지