Watch-IP
IP·이메일·로그인 위험 API

IP 지오로케이션, 이메일 검사, 로그인 위험 신호를 하나의 API로.

브라우저에서 사이트 방문자의 위치를 파악하고, 백엔드에서 IP 주소를 조회하고, 가입 이메일의 일회용 도메인과 오타를 잡아내고, 로그인 시 불가능한 이동을 감지하세요. 모두 하나의 요금제와 하나의 월간 요청 한도로 이용할 수 있습니다. 카드는 이 페이지 요청의 엣지 데이터와 로컬 보강 결과를 미리 보여 주며, API 응답이 아닙니다.

페이지 요청 엣지 미리보기request.cf
Columbus, OH, US

216.73.216.231

Columbus 위에 마커가 표시된 지도
좌표
39.9612, -82.9988
시간대
America/New_York
우편번호
43215
대륙
NA
네트워크
Anthropic, PBC
ASN
AS16509
통화
$ USD
국가 전화 코드
+1
일출 / 일몰
오전 7:49 / 오후 6:42
기기
—
보안
이용 불가 — 확인되지 않음

작업에 맞는 API 선택하기

웹사이트에서 방문자 위치 확인하기

허용된 오리진으로 제한된 공개 가능 키를 사용해 브라우저에서 직접 방문자 지오로케이션 API를 호출하세요. 근사 국가 및 도시 데이터, 시간대, 이용 가능한 지역 정보를 활용해 더 적합한 경험을 제안하세요.

방문자 지오로케이션 살펴보기 →

백엔드에서 IP 조회하기

애플리케이션에 이미 IP 주소가 있나요? 서버에서 IP 조회 엔드포인트로 전송하세요. 시크릿 키로 요청을 인증하며, 응답에는 서드파티 IP 지오로케이션 데이터베이스의 위치 필드가 포함됩니다.

IP 조회 API 살펴보기 →

IP 주소 목록 처리하기

하나의 배치 요청으로 최대 100개의 IP 주소를 전송하고, 보고, 보강, 기타 백엔드 워크플로를 위한 순서가 유지된 조회 결과 목록을 받으세요. 조회 사용량은 배치 요청이 아닌 IP 단위로 측정됩니다.

대량 IP 조회 살펴보기 →

가입 시 이메일 주소 검사

구문, 알려진 일회용 도메인, 도메인의 메일 서버 존재 여부, 오타 가능성, 역할 주소를 검사하고 이유와 함께 수락·검토·거부 판정을 받으세요. 공개 가능 키로 양식에서 호출하거나, 백엔드나 대시보드에서 요청당 최대 100개 — 또는 최대 100,000개 목록 — 를 검사할 수 있습니다.

이메일 검사 살펴보기 →

한 번의 호출로 신규 가입 점수화

POST /v1/signup/check는 이메일 검사와 가입 IP의 국가·네트워크, 요금제에 따른 VPN·Tor·데이터센터 지표, 이메일 도메인의 사용 기간을 결합해 0–100 점수와 이유가 포함된 판정을 반환합니다. 점수는 판단을 위한 맥락이며 악용의 증거가 아닙니다.

가입 악용 방지 워크플로 보기 →

로그인 시 불가능한 이동 감지

POST /v1/risk/check는 로그인 IP의 대략적인 위치를 사용자의 이전 저장 위치와 비교하여 거리, 경과 시간, 추정 속도, 위험 수준을 반환합니다. 오탐이 발생할 수 있으며 계정 탈취를 증명하지 않습니다.

불가능한 이동 감지 살펴보기 →

브라우저 통합 예제 및 엣지 미리보기

이 예제는 브라우저에서 GET /v1/geo를 호출하는 방법을 보여줍니다. 이 미리보기를 생성하기 위해 실행되지는 않았습니다. 위치는 이 페이지 요청에서 가져오며, 보강 정보는 로컬에서 파생됩니다. 누락된 값은 이용할 수 없는 값이며, 보안 검사는 실행되지 않습니다.

예제 요청 — 실행되지 않음

import { WatchIP } from "@digitload/watch-ip-sdk";

const client = new WatchIP("wip_pub_xxxxxxxx");
const { country, city, timezone, currency, callingCode } = await client.getGeo();

페이지 요청 미리보기 — API 응답 아님

{
  "ip": "216.73.216.231",
  "country": "US",
  "region": "Ohio",
  "regionCode": "OH",
  "city": "Columbus",
  "postalCode": "43215",
  "latitude": 39.96118,
  "longitude": -82.99879,
  "continent": "NA",
  "timezone": "America/New_York",
  "isEUCountry": false,
  "asn": 16509,
  "asOrganization": "Anthropic, PBC",
  "currency": {
    "code": "USD",
    "name": "US Dollar",
    "symbol": "$"
  },
  "callingCode": "+1",
  "compliance": {
    "isGDPR": false,
    "usPrivacyLaw": null,
    "isLGPD": false,
    "requiresCookieConsent": false,
    "dataResidencyZone": "US",
    "isEmbargoedCountry": false
  },
  "locale": {
    "suggestedLocale": "en-US",
    "measurementSystem": "imperial",
    "firstDayOfWeek": 0,
    "dateFormat": "MM/DD/YYYY"
  },
  "sun": {
    "sunrise": "2026-10-23T11:49:40.834Z",
    "sunset": "2026-10-23T22:42:44.749Z"
  },
  "holiday": {
    "isPublicHolidayToday": false,
    "todayHolidayName": null,
    "nextHoliday": {
      "date": "2026-11-11",
      "name": "Veterans Day"
    }
  },
  "age": {
    "ageOfMajority": 18,
    "drinkingAge": 21,
    "adultContentVerificationRequired": true,
    "jurisdictionNote": "HB 96 (2025)"
  },
  "tax": {
    "jurisdictionCode": "US-OH",
    "taxSystem": "US_SALES_TAX",
    "rate": null
  },
  "userAgent": {
    "browser": null,
    "browserVersion": null,
    "os": null,
    "osVersion": null,
    "deviceType": "bot"
  }
}

방문자 및 백엔드 지오로케이션

방문자의 브라우저에서는 공개 가능 키로 GET /v1/geo를 사용하세요. 백엔드에서 제공된 IP를 처리할 때는 시크릿 키로 GET /v1/lookup/{ip} 또는 POST /v1/lookup을 사용하세요.

모든 검사를 하나의 요금제로

지오로케이션, IP 조회, 이메일·가입·불가능한 이동 검사는 모두 동일한 월간 요청 한도를 사용합니다. 호출, 검사한 IP 또는 주소마다 1요청입니다. 별도로 구매할 제품이 없으며, Free를 포함한 모든 요금제에서 두 가지 키 유형을 모두 발급할 수 있습니다.

도메인 수준 이메일 검사

이메일 검사는 구문, 도메인의 일회용 여부와 메일 서버 레코드, 오타 가능성, 역할 주소를 확인합니다. 메일함에는 절대 연결하지 않으므로, 주소가 존재하거나 메일을 받을 수 있음을 확인해 주는 결과는 없습니다.

오리진으로 제한된 키

API 키는 Stripe나 Google Maps 키처럼 공개 가능한 키입니다. 요청은 등록한 오리진에만 응답되며, CORS도 해당 오리진에만 허용됩니다.

엣지 지오로케이션

GET /v1/geo는 연결된 IP의 네트워크 수준 위치 데이터를 읽습니다. IP 위치는 근사치이며, 응답 시간은 요청 내용과 활성화된 기능에 따라 달라집니다.

지역 보강 정보

방문자 응답은 위치와 요청 헤더를 기반으로 통화, 국가 전화 코드, 일출/일몰 시각, 기기 힌트를 파생합니다. 소스 데이터가 없으면 필드는 null이 될 수 있습니다.

지역 컴플라이언스 힌트

정적 국가 및 지역 매핑은 컴플라이언스 힌트를 제공합니다. 법적 의무를 규정하거나 준수를 보장하지 않습니다.

직접 구현할 필요 없는 로케일 협상

모든 응답에는 로케일 객체가 포함됩니다: 방문자의 국가와 브라우저의 Accept-Language 헤더를 결합한 최적의 BCP47 로케일(예: 캐나다의 프랑스어 사용 방문자는 fr-FR이 아닌 fr-CA를 받습니다), 그리고 측정 단위 체계, 한 주의 시작 요일, 날짜 형식까지 함께 제공되므로 자체 i18n 레이어에서 다시 구현할 필요가 없습니다.

공휴일 캘린더

모든 응답에는 공휴일 객체가 포함됩니다: 오늘이 방문자 국가의 공휴일인지 여부, 공휴일 이름, 다음 공휴일 — "오늘은 휴무입니다" 같은 고객 지원 위젯 문구, 결제 안내, 일정 로직에 유용하며, 약 40개국을 선별한 목록을 다룹니다.

연령 관할권 힌트

정적 매핑은 근사 IP 위치를 기반으로 연령 및 관할권 힌트를 제공합니다. 신원이나 연령을 검증하지 않으므로 적용 요건은 별도로 확인하세요.

세금 관할권 힌트

정적 매핑은 지역 세금 정보를 제공합니다. 세금 계산이나 유지 관리되는 세금 엔진의 대체 수단이 아닙니다.

SDK 소스 패키지

저장소에는 JavaScript/TypeScript, Python, PHP, Go, Flutter/Dart 클라이언트가 포함되어 있습니다. 엔드포인트 지원 범위는 다를 수 있으니 설치 전에 문서를 확인하고 패키지 이용 가능 여부를 확인하세요.

VPN, Tor 및 네트워크 신호

이용 가능한 방문자 요금제에는 리스트 기반 VPN, Tor, 데이터센터, 위협, 제재 대상 네트워크 지표가 포함됩니다. 플래그가 false라는 것은 이용 가능한 데이터에서 일치 항목이 없다는 뜻이며, 안전한 방문자라는 뜻은 아닙니다. IPv6 커버리지는 부분적이며 IPv6 Tor는 지원되지 않습니다.

브랜드 서브도메인

Growth와 Scale 요금제에는 대시보드에서 이용할 수 있는 커스텀 도메인 설정 경로가 포함됩니다. 이용 가능 여부는 계정 자격과 DNS/SSL 설정 성공 여부에 따라 다르며, 통합 시에는 설정된 기본 URL을 사용해야 합니다.

비정상 이동 신호

POST /v1/risk/check는 제공된 IP의 근사 위치를 저장된 사용자 기준 위치와 비교합니다. 오탐이 발생할 수 있으며 계정 탈취를 증명하지는 않습니다. 이용 가능 여부와 제공 절차는 문의를 통해 확인하세요.

통합 전에 응답을 이해하세요

방문자 API와 조회 API는 서로 다른 요청을 처리하며 서로 다른 데이터를 반환합니다. 방문자 지오는 연결된 요청의 엣지 지오로케이션을 사용하고 지역 정보를 추가합니다. IP 조회는 제공한 주소를 서드파티 IP 지오로케이션 데이터베이스로 해석합니다. 조회 응답에는 방문자 지오에서 제공하는 모든 보강 정보가 포함되지는 않습니다 — 예를 들어 우편번호와 시간대는 현재 데이터 소스에서 제공되지 않습니다. 이메일·가입·위험 검사는 각각 보내는 입력값(주소, 또는 사용자 ID와 IP)을 대상으로 하며, 아래의 모든 행은 동일한 월간 요청 한도를 사용합니다.

작업엔드포인트키데이터 초점
연결된 웹사이트 방문자 위치 확인GET /v1/geo공개 가능, 오리진 제한방문자 위치 및 지역 정보
제공된 IP 하나 조회GET /v1/lookup/{ip}시크릿 Bearer 키서드파티 IP 지오로케이션 데이터베이스 위치 결과
제공된 여러 IP 조회POST /v1/lookup시크릿 Bearer 키최대 100개의 순서가 유지된 위치 결과
가입 양식에서 이메일 주소 검사POST /v1/email/validate공개 가능, 오리진 제한구문·일회용 도메인·메일 서버·오타 신호와 판정
이메일 주소 대량 검사POST /v1/email/batch, /v1/email/jobs시크릿 Bearer 키요청당 최대 100개, 또는 비동기 목록 작업당 최대 100,000개
신규 가입 점수화POST /v1/signup/check시크릿 Bearer 키이메일·IP 네트워크·도메인 사용 기간 신호 기반 0–100 점수
로그인을 이전 위치와 비교POST /v1/risk/check시크릿 Bearer 키거리, 추정 속도, 불가능한 이동 플래그

자주 묻는 질문

제가 제공한 IP 주소도 Watch-IP로 지오로케이션할 수 있나요?

네. 시크릿 키를 사용하는 서버 사이드 IP 조회 API를 이용하세요. 브라우저 방문자 엔드포인트는 연결된 클라이언트의 위치를 확인하며 임의의 IP를 조회 대상으로 받지 않습니다.

브라우저 JavaScript에서 Watch-IP를 사용할 수 있나요?

웹사이트 오리진에 맞게 설정된 공개 가능 키로 방문자 지오를 사용하세요. 시크릿 조회 키는 백엔드에 두어야 하며 브라우저 코드에 노출되어서는 안 됩니다.

IP 지오로케이션은 브라우저의 Geolocation API와 같은가요?

아닙니다. Watch-IP는 IP 연결로부터 위치를 추정합니다. 브라우저의 Geolocation API는 기기 제공 위치에 대한 권한을 요청하는 별도의 메커니즘입니다.

IPv4와 IPv6 주소를 모두 조회할 수 있나요?

조회 엔드포인트는 유효한 IPv4 및 IPv6 주소를 받으며, 데이터베이스 레코드 존재 여부에 따라 달라집니다. 보안 신호의 커버리지는 별개의 문제이며 지표와 IP 버전에 따라 다릅니다.

Watch-IP에는 무료 요금제가 있나요?

네. Free 요금제에는 월간 요청 한도와 그보다 작은 IP 조회 한도가 포함됩니다. 현재 한도는 가격 페이지를 확인하세요. 이메일·가입·불가능한 이동 검사는 별도 요금제 없이 같은 한도를 사용합니다.

이메일 검사로 메일함 존재 여부를 확인하나요?

아니요. Watch-IP는 구문, 도메인(일회용 목록, 메일 서버 레코드, 사용 기간), 오타와 역할 계정 같은 주소 패턴을 검사합니다. 메일 서버에 연결하지 않으므로, 메일함이 존재하거나 메일을 받을 수 있음을 확인해 주는 결과는 없습니다.

이메일 검사와 위험 검사에 별도 요금제가 필요한가요?

아니요. 검사한 주소, 가입 검사, 불가능한 이동 검사는 각각 지오로케이션 및 조회 호출과 같은 월간 한도에서 1요청으로 계산됩니다. 백엔드 엔드포인트는 대시보드에서 발급한 시크릿 키를 사용합니다.

보안 플래그가 false이면 방문자가 안전하다는 뜻인가요?

아닙니다. 사용 중인 데이터에서 일치하는 항목을 찾지 못했다는 뜻입니다. 커버리지 누락, 목록에 없는 네트워크, 이용할 수 없는 신호는 별도로 고려해야 합니다.

첫 통합을 선택하세요

웹사이트라면 방문자 가이드로, 백엔드 애플리케이션이라면 IP 조회 제품 페이지로, 가입 양식이라면 이메일 검사로 시작하세요.