필요한 API에 맞는 요금제를 선택하세요

키와 오리진 검사를 통과한 인증된 호출은 각각 1요청으로 계산됩니다. 방문자 지오로케이션 호출, 조회한 각 IP, 검사한 각 이메일 주소, 각 가입 검사, 각 불가능한 이동 검사가 해당합니다. 이후 입력 검증에 실패한 호출도 계산됩니다. 키 누락 또는 무효, 허용되지 않은 오리진, 분당 속도 제한으로 거부된 호출은 계산되지 않으며, 위험 기준선 삭제나 이메일 목록 작업 상태 조회도 계산되지 않습니다.

이는 시계 분 단위에 맞춰진 고정된 1분 창이며, 이동 평균이 아닙니다. Free 요금제에서는 예를 들어 10:32:00부터 10:32:59 사이에 최대 30회의 요청을 보낼 수 있으며, 카운터는 10:33:00에 0으로 재설정됩니다. 초과하면 몇 초 후 창이 재설정되는지 알려주는 Retry-After 헤더와 함께 HTTP 429가 반환됩니다. 이는 아래의 월간 요청 사용량과는 별개이며, 총 사용량이 아니라 순간적인 요청 폭주를 제한합니다. 이 제한은 항목 수가 아니라 API 호출 수를 셉니다. 최대 100개의 IP 또는 이메일 주소를 담은 배치나 이메일 목록 작업 생성은 1건의 요청으로 계산되며, 그 안의 각 IP나 주소는 여전히 월간 요청량에 개별적으로 계산됩니다.

자동으로 키를 차단하지는 않습니다. 요금제 한도에 지속적으로 근접한다면 언제든지 대시보드에서 업그레이드할 수 있습니다 — 코드나 API 키 변경이 필요하지 않습니다.

방문자 지오로케이션은 엣지 요청 데이터를 읽고 지역 정보를 로컬에서 보강하므로, 비용 — 그리고 가격 — 을 대부분의 제공업체가 제공하는 동급 요금제보다 훨씬 낮게 유지할 수 있습니다. 서버 사이드 IP 조회는 별도로 판매되지 않고 동일한 요금제와 가격에 포함됩니다. 각 요금제에는 요청 한도와 IP 조회 할당량이 모두 포함되며, 둘 다 해당 요금제의 공유 월간 풀에서 차감됩니다.

방문자 지오로케이션과 IP 조회 응답에는 소스 데이터가 있는 경우 지역 보강 정보가 포함됩니다. 대상 요금제에는 리스트 기반 보안 지표도 포함됩니다. 이메일 검사는 도메인 수준의 별도 결과를 반환합니다. 지연 시간은 요청과 활성화된 기능에 따라 다릅니다.

네. GET /v1/geo는 여전히 클라이언트 측에서 실제로 연결된 IP를 확인하는 방문자 자체 조회 전용입니다. 임의의 IP를 조회하려면 GET /v1/lookup/{ip}(단일)와 POST /v1/lookup(배치, 호출당 최대 100개의 IP)이 게시 가능한 키가 아닌 비공개 키로 인증되는 서버 간 엔드포인트입니다 — 키는 백엔드에 남아 있으며 브라우저로 전송되지 않습니다. 두 엔드포인트 모두 당사의 실시간 네트워크 데이터가 아닌 제3자 IP 지오로케이션 데이터베이스를 기반으로 하며, 응답 형식이 다르고 검증된 상대적 정확도 순위도 없습니다 — 특정 제공업체와 필요한 출처 표기는 데이터 소스를 참조하세요 — 사용량은 조회한 IP 단위로 과금되며, 지오 요청과 1대1 비율로 요금제의 공유 월간 풀에서 차감됩니다(총 조회 건수에 대한 별도 상한은 위의 요금제 IP 조회 할당량을 참조하세요). 이 엔드포인트는 방문자가 직접 호출하는 것이 아니라 고객님의 고객이 제공한 IP를 조회하므로, 이는 Watch-IP를 고객님을 대신하여 해당 제3자 데이터를 처리하는 처리자로 만듭니다 — 이것이 고객님 자신의 컴플라이언스 의무에 어떤 의미인지는 DPA를 참조하세요.

POST /v1/risk/check는 제공된 IP의 타사 위치를 저장된 사용자 기준 위치와 비교해 low/medium/high 위험도와 impossibleTravel 플래그를 반환합니다. 백엔드 Bearer 시크릿 키를 사용합니다. 이용 가능 여부, 제공 절차, 가격은 문의를 통해 확인하세요 — 독립적인 위험 요금제 시행 여부와 체크아웃 준비 상태는 아직 확인되지 않았습니다. VPN 전환과 모바일 라우팅은 오탐을 유발할 수 있습니다.

네. POST /v1/email/validate는 오리진이 제한된 공개 가능 키로 구문, 알려진 일회용 도메인, 도메인의 메일 서버 존재 여부, 오타 가능성, 역할 주소를 검사하고 이유와 함께 수락·검토·거부 판정을 반환합니다. 백엔드에서는 POST /v1/email/batch가 호출당 최대 100개 주소를, 목록 작업이 최대 100,000개를 처리하며, POST /v1/signup/check는 가입 IP의 네트워크 신호를 추가합니다. 검사한 각 주소는 요금제 월간 한도에서 1요청으로 계산됩니다(목록 작업은 고유 주소마다 한 번만 과금). 이 검사들은 모두 메일함에 연결하지 않으므로 메일함의 존재, 소유권, 전달 가능성을 확인하지 않습니다.

키 유형에 따라 다릅니다. 공개 가능 키(GET /v1/geo 및 POST /v1/email/validate용)는 Stripe나 Google Maps의 공개 가능 키처럼 페이지 소스에 포함하도록 설계되었으며, 접근 제어는 오리진 제한입니다. 각 키는 등록한 도메인에서만 작동하고 CORS는 일치하는 오리진에만 허용됩니다. 시크릿 키(IP 조회, 이메일 대량 검사, 가입 검사, 불가능한 이동 검사용)는 백엔드에 보관해야 하며 브라우저 코드에 절대 노출되어서는 안 됩니다.

JavaScript/TypeScript, Python, PHP, Go, Flutter/Dart용 SDK 소스 패키지가 있습니다. 사용 전에 레지스트리 이용 가능 여부와 엔드포인트 지원 범위를 확인하세요. GET /v1/geo는 항상 연결된 호출자를 확인하며, 백엔드 호출은 웹사이트 방문자를 확인하지 않습니다. 제공된 IP에는 시크릿 키 조회를 사용하세요.

네, 다만 선택적으로 활성화해야 합니다: 요청에 ?include=hostname을 추가하거나(SDK에서는 include: ["hostname"]) 응답에 hostname 필드가 추가되며, DNS-over-HTTPS PTR 조회로 확인됩니다. PTR 레코드가 없으면 null입니다. 위의 상시 활성화된 보강 필드와 달리, 이 기능은 요청 내에서 실제 네트워크 조회를 수행하므로 모든 호출에 지연 시간을 추가하지 않도록 기본적으로 비활성화되어 있습니다.

대상 요금제에는 방문자 지오로케이션과 IP 조회 응답 모두에 리스트 기반 isVpn, isTor, isDatacenter, isThreat, isSanctionedNetwork 플래그가 포함됩니다. Free에서는 보안 정보가 생략됩니다. IPv4는 리스트 및 ASN 매칭을 지원합니다. IPv6는 VPN, 데이터센터, 위협 범위와 ASN 매칭을 지원하지만 Tor는 지원하지 않습니다. 프로덕션 커버리지는 사용 가능한 피드에 따라 달라집니다. false는 사용 가능한 데이터에서 일치 항목이 없다는 뜻이지 안전을 보장하지 않으며, 이 신호들은 확정적인 제재 심사가 아닙니다.

네 — 모든 응답에는 컴플라이언스 객체가 포함됩니다: isGDPR(EU/EEA + 영국), usPrivacyLaw(방문자의 주(state)에 따라 적용되는 미국 주법, 예: CCPA/CPRA 또는 VCDPA), isLGPD(브라질), 파생된 requiresCookieConsent 플래그, 대략적인 dataResidencyZone, isEmbargoedCountry(OFAC 포괄적 국가 제재)입니다. 통화 및 국가 전화 코드와 마찬가지로 모든 요금제에서 추가 비용 없이 제공됩니다. 이는 방문자의 위치를 기반으로 계산된 1차적인 관할권 신호일 뿐 법률 자문이 아니므로, 컴플라이언스 요건은 항상 자체 법률 자문을 통해 확인하세요.

네 — 모든 응답에는 로케일 객체가 포함됩니다: suggestedLocale은 방문자의 국가와 브라우저 자체의 Accept-Language 헤더를 결합한 BCP47 로케일로, 실제로 해당 지역에서 사용되는 언어를 우선합니다(예: 캐나다 방문자의 Accept-Language가 "fr"이면 "fr-FR"이 아닌 "fr-CA"를 반환합니다). 헤더에 일치하는 항목이 없으면 국가의 기본 로케일로 대체됩니다. 같은 객체에는 measurementSystem(미터법/야드파운드법), firstDayOfWeek, dateFormat도 포함되어 있어 지역별 형식 규칙을 직접 다시 구현할 필요가 없습니다. 모든 요금제에서 추가 비용 없이 제공됩니다.

네 — 모든 응답에는 공휴일 객체가 포함됩니다: 방문자 국가의 isPublicHolidayToday, todayHolidayName, nextHoliday(날짜와 이름)이며, 요청 시점에 계산되는 것이 아니라 Nager.Date에서 가져와 연 1~2회 수동으로 갱신하는 선별된 정적 테이블(현재 약 40개국 — G20 + EU/EEA + 영국)을 기반으로 합니다. 목록에 없는 국가는 null이며, 주(州) 단위 기념일이 아닌 전국 공휴일만 집계합니다. 모든 요금제에서 추가 비용 없이 제공되며, 요청 시 더 많은 국가를 추가할 수 있습니다.

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