자주 묻는 질문
IP 지오로케이션, VPN 탐지, ASN 조회, 요청 제한, API 작동 방식에 관한 모든 것.
시작하기
ipto란 무엇인가요?
무료 IP 인텔리전스 API입니다. 모든 IPv4 또는 IPv6 주소를 조회하여 국가, ASN, ISP, 호스팅 탐지, VPN 탐지, Tor 출구 노드 식별, 악성 네트워크 점수를 확인할 수 있습니다. 하나의 JSON 응답. 가입 불필요.
API 키가 필요한가요?
아니요. 무료 요금제는 키도 가입도 필요 없습니다. 엔드포인트를 바로 호출하면 됩니다(한도는 IP 주소별로 집계됩니다). Pro 또는 Enterprise 한도를 쓰려면
X-API-Key 헤더 또는 ?api_key=로 키를 보내세요. 무료 키는 POST /v1/keys로 즉시 발급받을 수 있습니다.기본 URL은 무엇인가요?
https://ipto.to입니다. 모든 엔드포인트는 /v1/ 아래에 있습니다. 모든 엔드포인트에서 CORS가 활성화되어 있습니다.내 IP를 어떻게 조회하나요?
GET https://ipto.to/v1/ip — 매개변수가 필요 없습니다. IP와 함께 도시, 주(state), 시간대, 위경도를 반환합니다. 또는 터미널에서 curl ipto.to를 실행하세요.터미널에서 사용할 수 있나요?
네.
curl ipto.to는 curl User-Agent를 자동으로 감지하여 사용자 본인의 IP에 대해 국가, 도시, ASN, 실시간 날씨를 포함한 간결한 JSON을 반환합니다. curl ipto.to/8.8.8.8은 어떤 IP에 대해서도 동일하게 작동합니다(날씨 제외). Wget과 HTTPie도 사용할 수 있습니다.IP 지오로케이션
왜 위치가 잘못된 도시로 표시되나요?
IP 지오로케이션은 IP 대역을 최종 사용자가 아닌 네트워크 인프라의 물리적 위치에 매핑합니다. ISP는 수백 마일 떨어진 지역 교환 지점을 통해 트래픽을 라우팅합니다. 국가 정확도는 높습니다. 도시 수준 정밀도는 가정용 및 모바일 IP에서 떨어집니다.
VPN을 사용할 때 국가가 잘못 표시되는 이유는 무엇인가요?
VPN에 연결되어 있으면 트래픽은 VPN 서버의 IP 주소에서 나갑니다. ipto는 사용자 본인의 물리적 위치가 아니라 그 출구 서버의 위치를 보고합니다. 이 경우
is_vpn 플래그가 true가 됩니다.지오로케이션 정확도는 무엇에 좌우되나요?
데이터 품질은 ISP와 기관이 WHOIS 및 라우팅 등록기관에 IP 블록을 얼마나 정확하게 등록하는지에 좌우됩니다. 대형 클라우드 제공업체와 ISP는 매우 정확한 기록을 가지고 있습니다. 작거나 오래된 할당은 부정확할 수 있습니다.
IPv6를 지원하나요?
예. IPv6 주소는 ASN, 조직, IP 범위와 함께, 해당 범위가 포함된 경우 MaxMind 데이터셋의 도시 수준 위치(도시, 지역, 우편번호, 위도/경도)를 반환하며 보곤/사설 범위도 식별합니다. 한 가지 제약은 VPN, Tor, 악용 플래그가 현재 IPv4 전용이라는 점입니다. 해당 피드가 IPv4 범위로 제공되기 때문이며, IPv6 주소에서는 추측하지 않고 false로 반환됩니다.
bogon IP란 무엇인가요?
bogon(가짜) IP는 공용 인터넷에서 출발지로 나타나서는 안 되는 모든 주소입니다: 루프백(127.x.x.x), RFC 1918 사설 대역(10.x, 172.16–31.x, 192.168.x), 링크 로컬(169.254.x), 멀티캐스트(224–239.x), IANA 예약 블록입니다. ipto는 다른 데이터베이스 조회에 앞서 이를 감지하고
bogon: true와 bogon_type 사유를 반환합니다. bogon IP 검사기에서 아무 주소나 확인해 보세요.위협 인텔리전스
VPN을 어떻게 탐지하나요?
ipto는 BGP 라우팅 분석과 능동적 열거를 통해 구축된 알려진 VPN 서버 IP 대역 데이터베이스를 유지합니다. 조회 시마다 각 IP를 이 데이터베이스와 대조합니다. 제공업체 식별은 ASN 소유 정보에서 도출됩니다: ASN이 VPN 사업자에게 독점적으로 등록되어 있으면 제공업체를 식별합니다. VPN & 프록시 검사기에서 아무 IP나 테스트해 보세요.
Tor 출구 노드를 어떻게 탐지하나요?
Tor 출구 노드 목록은 check.torproject.org의 공식 Tor Project 대량 출구 노드 목록에서 가져옵니다. 이는 현재 Tor 출구 트래픽을 발생시킬 수 있는 IP의 권위 있는 목록입니다. 6시간마다 갱신됩니다.
is_abuser는 무엇을 의미하나요?
해당 IP가 여러 독립적인 위협 인텔리전스 피드에서 악성 인프라(스팸 발신지, 악성코드 명령제어 서버, 봇넷 릴레이, 대량 익스플로잇 도구)로 표시된 네트워크 대역에 속함을 의미합니다. 악용 점수가 높을수록 더 많은 피드가 독립적으로 동의했음을 의미합니다.
is_datacenter와 is_residential의 차이는 무엇인가요?
is_datacenter는 IP가 호스팅 제공업체, 클라우드 플랫폼, CDN에 속함을 의미합니다. is_residential은 IP가 소비자용 광대역 연결로 분류됨을 의미합니다. 대부분의 IP는 둘 다 아닙니다 — 호스팅도 주거용도 아닌 ISP 인프라에 속합니다.is_proxy는 무엇인가요?
VPN이나 Tor로 분류되지 않은 알려진 프록시 출구 지점을 표시합니다. 현재는 위협 피드 파이프라인의 데이터로 제한됩니다. 커버리지는 VPN 및 Tor 탐지보다 낮습니다.
ASN 및 네트워크
ASN이란 무엇인가요?
자율 시스템 번호(ASN)는 인터넷에서 자체 IP 라우팅 정책을 독립적으로 관리하는 네트워크의 고유 식별자입니다. 예: Google은 AS15169, Amazon은 AS16509입니다. 모든 IP 블록은 정확히 하나의 ASN에 의해 공지됩니다. ASN 조회 도구에서 직접 조회해 보세요.
asn_type은 무엇을 의미하나요?
ASN을 운영하는 조직의 범주입니다. 값:
hosting(클라우드 또는 서버 호스팅), isp(인터넷 서비스 제공업체), business(기업 네트워크), education(대학 또는 연구기관), government(정부), mobile(이동통신사), residential(주거용).is_mobile은 무엇을 의미하나요?
해당 IP 블록이 이동통신사에 등록되어 있음을 의미합니다. 모바일 IP는 사용자 간에 자주 재할당되며, 통신사 본사와 다른 지리적 위치에서 나타나는 경우가 많습니다.
ASN의 IP 대역 개수뿐 아니라 전체 목록도 볼 수 있나요?
네 —
GET /v1/asn/:asn/ranges?limit=&offset=는 실제 대역 목록(각각 국가 코드와 hosting/mobile/residential/bot/blacklist 플래그 포함)을 요청당 최대 200개까지 페이지네이션하여 반환합니다. 기본 GET /v1/asn/:asn 조회 결과에도 ip_range_count와 rank(해당 국가 내에서 대역 수 기준 ASN 규모 순위)가 포함되어 있어, ranges 엔드포인트 없이도 확인할 수 있습니다. ASN 조회 도구를 참고하세요.ASN의 WHOIS 등록 정보나 피어링 관계는 어떻게 조회하나요?
GET /v1/asn/:asn/whois는 RDAP를 통해 RIR 등록 기록(이름, 상태, 국가, 등록/최종 변경일, 연락처)을 반환합니다. GET /v1/asn/:asn/relationships는 CAIDA의 AS-Relationships 데이터셋을 기반으로 알려진 피어, 상위(provider) 및 하위(customer) 네트워크를 반환하며, GET /v1/asn/:asn/related는 같은 조직이 운영할 가능성이 높은 다른 ASN을 찾아줍니다. 세 가지 모두 ASN 조회 페이지에 함께 표시됩니다.한 번에 하나의 ASN이 아니라, 전체 공인 IPv4 주소 공간을 볼 수 있는 디렉터리도 있나요?
네 — 전체 IP 대역(
GET /v1/ip-ranges)은 가능한 256개의 /8 블록 전체를 탐색할 수 있는 디렉터리로, /16 단계를 거쳐 실제로 할당된 대역과 그 대역이 속한 ASN까지 확인할 수 있습니다.API 사용
요청 제한은 얼마인가요?
무료 플랜은 IP 주소당 하루 1,000회 요청을 허용하며, 가입이나 키가 필요하지 않습니다. Pro 키는 하루 100,000회, Enterprise는 무제한입니다. 한도를 초과하면 HTTP 429가 반환됩니다. 자세한 내용은 요금제를 참고하세요.
일괄 조회는 어떻게 하나요?
IP 문자열의 JSON 배열을
/v1/ip/bulk에 POST하세요 — 요청당 최대 100개, Pro/Enterprise 전용입니다(요금제 참고). 응답은 IP를 키로 하는 객체입니다. 병렬 캐시 읽기 덕분에 순차 호출보다 빠릅니다. 각 IP는 개별 조회와 마찬가지로 일일 사용량에 포함됩니다.응답 필드를 필터링하려면 어떻게 하나요?
단일 IP 요청에
?fields=field1,field2를 추가하세요. 예: /v1/ip/1.1.1.1?fields=ip,country_code,is_vpn,is_tor. ip 필드는 항상 포함됩니다.어떤 출력 형식을 사용할 수 있나요?
JSON(기본값), CSV, 일반 텍스트, XML, YAML을 지원합니다. 단일 IP 요청에
?format=csv, ?format=text, ?format=xml, ?format=yaml를 추가하세요. CSV와 텍스트는 평면 키/값 쌍을 반환하고, XML과 YAML은 flags처럼 중첩된 객체를 유지합니다.SDK가 있나요?
아직 공식 SDK는 없습니다. API는 표준 HTTP JSON 엔드포인트입니다 — 어떤 HTTP 클라이언트로도 사용할 수 있습니다. curl, JavaScript, Python, PHP, Go 예제는 문서를 참고하세요.
AI 에이전트(Claude, Cursor 등)가 ipto를 직접 사용할 수 있나요?
예.
https://ipto.to/mcp는 동일한 조회 기능을 JSON-RPC로 호출 가능한 도구로 제공하는 Model Context Protocol(MCP) 서버입니다. IP(단건 및 대량), ASN(범위/whois/관계), IP whois, RPKI, 기업, 통신사, 호스팅 도메인, 통합 검색, 주변 장소, 국가, 역방향 DNS, User-Agent, 전화, 이메일, 사기 점수, 언어, 통화, 날씨, 상표, 특허를 지원하므로 MCP 호환 클라이언트가 원시 HTTP 요청 대신 직접 호출할 수 있습니다. REST API와 동일한 X-API-Key 및 속도 제한 규칙이 적용됩니다.데이터
데이터는 얼마나 자주 갱신되나요?
ASN/IP 대역 데이터셋은 매일 UTC 04:00에 갱신됩니다. 도시 수준 위치 정보는 두 개의 독립적인 소스를 각자의 일정에 따라 병합합니다 — IP2Location은 매월, MaxMind는 매주 — 따라서 ASN 갱신 사이에도 정밀도가 향상될 수 있습니다. 위협 피드(VPN, Tor, 악용)는 6시간마다 동기화됩니다. 엣지 캐시 TTL은 5분입니다.
어떤 데이터 소스를 사용하나요?
매일 업데이트되는 주요 업계 데이터 공급업체 여러 곳에서 정보를 수집합니다. VPN 탐지는 BGP 기반 대역 인텔리전스를 사용합니다. Tor 노드 데이터는 공식 Tor Project 레지스트리와 검증된 릴레이 목록에서 가져옵니다. 악용 네트워크는 여러 소스를 교차 검증한 블랙리스트 인텔리전스를 사용합니다.
위협 인텔리전스는 얼마나 정확한가요?
VPN 및 Tor 탐지는 주요 제공업체와 모든 확인된 출구 노드에 대해 재현율이 높습니다. 일반 호스팅 ASN에서 IP 대역을 임대하는 소규모 또는 신생 VPN 서비스는 제공업체 이름으로 식별되지 않을 수 있습니다. 악용 점수는 교차 피드 검증을 사용합니다 — 네트워크가 Medium 등급에 오르려면 3개 이상의 독립적인 출처가, Critical 등급에는 8개 이상이 필요합니다.
새로운 기능
abuse_score와 threat_type은 무엇을 의미하나요?
abuse_score는 교차 피드 검증에 기반한 1–10 심각도 점수입니다: 얼마나 많은 독립적인 위협 출처가 동일한 네트워크를 표시하는지를 나타냅니다. threat_type은 어떤 범주가 플래그를 유발했는지 나타냅니다 — tor_exit, vpn, 또는 abuser입니다. risk_tier는 점수를 critical(8–10), high(5–7), medium(3–4)로 그룹화합니다. IP 악용 검사기에서 실시간으로 확인해 보세요.ipto는 환율 정보를 제공하나요?
네. 국가가 확인된 모든 응답에는
currency_code와 exchange_rate_usd가 포함됩니다 — 154개 세계 통화를 다루는 일일 기준 환율입니다. 이 목록에 없는 통화는 환율에 대해 null을 반환합니다.응답에 어떤 지역 데이터가 포함되나요?
국가 데이터가 있는 각 응답에는
languages(공용어), tld(국가 코드 최상위 도메인), capital(수도), borders(인접 국가의 ISO 코드)가 포함됩니다 — 두 번째 API 호출 없이 콘텐츠를 현지화하거나 국가 인식 폼을 구축하는 데 유용합니다.리버스 DNS / 호스트명 조회는 어떻게 하나요?
GET /v1/ip/:ip/hostname은 DNS-over-HTTPS를 통해 실시간 PTR 조회를 수행하고 { ip, hostname }을 반환합니다. 캐시된 도메인 목록화 데이터베이스가 아니라 단일 온디맨드 조회입니다 — PTR 레코드가 없으면 hostname은 null입니다. /reverse-dns-lookup에 브라우저 도구도 있습니다.원본 데이터셋을 다운로드할 수 있나요?
네.
GET /v1/datasets/:kind는 asn, ranges, geo-city에 대한 CSV 내보내기를 반환합니다 — API가 내부적으로 조회하는 것과 동일한 데이터셋이며, 동일한 일정으로 갱신됩니다. 도시 수준 데이터는 서로 다른 커버리지를 가진 두 개의 독립적인 소스에서 병합되므로 geo-city는 선택적으로 ?source=primary(기본값) 또는 ?source=secondary를 받습니다.Pro나 Enterprise API 키로 무엇을 얻나요?
Pro 키는 하루 100,000회 요청 한도와 일괄 조회(
POST /v1/ip/bulk, 요청당 최대 100개 IP)를 제공합니다 — 일괄 조회는 무료 플랜에서 전혀 사용할 수 없습니다. Enterprise(무제한 요청)는 맞춤형 SLA와 전담 지원을 추가로 제공합니다. 도시/우편번호/위경도 정밀도는 무료 플랜을 포함한 모든 등급에 포함됩니다. POST /v1/keys는 무료 플랜 키(하루 1,000회 요청, GET /v1/keys/usage?key=X로 사용량 추적)를 발급합니다 — 업그레이드는 요금제를 참고하세요.도시 수준 위치 정보는 어떤 IP에서나 작동하나요, 아니면 제 IP에서만 작동하나요?
geo_precision이 허용하는 경우 둘 다 가능합니다. 사용자 본인의 IP(GET /v1/ip)는 항상 연결 중인 엣지 네트워크에서 도시 수준 데이터를 얻습니다. 명시적 IP 조회(GET /v1/ip/:ip)는 해당 IP가 도시 수준 데이터셋의 커버리지 안에 있을 때 도시 수준 데이터를 얻습니다. 그렇지 않으면 geo_precision이 country로 낮아지고 city/state/lat/lon은 null을 반환합니다.응답을 다른 언어로 받으려면 어떻게 해야 하나요?
Add
?lang= to any request with one of: pt, fr, de, zh-TW, ko, zh-CN, ja-JP, es-ES, ar-SA, hi-IN (en is the default). This localizes country_name and continent into the target language. Field names and threat data stay in English regardless of locale.IP를 넘어서: 신원, 사기, 참조 데이터
ipto는 이메일 주소를 검증하나요?
네 —
GET /v1/email/:email은 형식, 실시간 MX 레코드 조회, 동기화된 차단 목록을 이용한 일회용/임시 도메인 탐지를 확인합니다. 무료, 가입 불필요. 이메일 검사기를 사용해 보세요.ipto는 전화번호를 검증하나요?
네 —
GET /v1/phone/:number는 모든 E.164 또는 국내 형식 번호에 대해 유효성, 국가, 지역, 회선 유형(모바일, 유선, VoIP)을 동기화된 MCC/MNC 이동통신사 데이터셋과 대조하여 분석합니다. 전화번호 검사기를 사용해 보세요.사기 점수 검사기란 무엇인가요?
GET /v1/fraud-score는 IP 위협 신호, 이메일 전달 가능성, 전화번호 유효성, User-Agent 봇 탐지를 하나의 통합된 0–100 위험 점수로 결합합니다 — 주요 단독 IP 인텔리전스 API 중 이를 제공하는 곳은 없습니다. 네 가지 입력 모두 선택 사항이며, 전달하지 않은 신호는 단순히 존재하지 않는 것으로 처리되며 깨끗한 것으로 채점되지 않습니다. 사기 점수 검사기를 사용해 보세요.ipto는 텍스트의 언어를 감지하나요?
네 —
GET /v1/language는 로컬 트라이그램 빈도 분석을 통해 76개 언어 중 어떤 텍스트의 언어든 식별합니다. 텍스트는 제3자 업체나 AI 모델로 전송되지 않으며, 아무것도 기록되지 않습니다. 언어 감지기를 사용해 보세요.독립된 환율 변환 엔드포인트가 있나요?
네 —
GET /v1/currency/convert와 GET /v1/currency/rates는 모든 IP/국가 조회에서 이미 exchange_rate_usd를 제공하는 것과 동일한 일일 환율 피드를 154개 통화에 대해 제공하며, 90일 과거 환율을 위한 GET /v1/currency/history도 있습니다. 환율 변환기를 사용해 보세요.ipto는 날씨 데이터를 제공하나요?
네 —
GET /v1/weather는 지명, 우편번호, 좌표 쌍에 대한 현재 상태를 반환합니다. 시간별 전망과 3일 예보를 원하면 &detail=1을 추가하세요. 홈페이지의 본인 IP 날씨 위젯과 날씨 조회 도구 모두 이를 사용합니다.ipto는 상표를 조회하나요?
네 —
GET /v1/trademark/:serial은 8자리 일련번호로 실시간 사건 상태를 확인하기 위해 USPTO의 TSDR API를 프록시합니다. 사건 상태 텍스트는 미국 정부 저작물로 퍼블릭 도메인이므로 모든 응답에 source/attribution 필드가 포함됩니다. 상표 로고/이미지 데이터는 의도적으로 범위에서 제외됩니다. 등록번호 조회는 지원되지 않습니다 — USPTO가 현재 문서화한 것은 일련번호 경로뿐입니다. 상표 조회 도구를 사용해 보세요.ipto는 특허를 조회하나요?
네 —
GET /v1/patent/:number는 7~8자리 실용특허 번호로 등록 상태를 확인하기 위해 USPTO의 실시간 Patent File Wrapper API를 프록시합니다. 커버리지는 2001년 이후 출원부터 시작하며, 데이터는 심사/서지 정보(출원일, 상태, 발명자, 담당 대리인)입니다 — Lens.org, Espacenet, Google Patents가 보여주는 인용 그래프, 특허 패밀리, 법적 상태 필드가 아닙니다. 디자인, 식물, 재발행 특허는 아직 지원되지 않습니다. 특허 조회 도구를 사용해 보세요.소유권, 라우팅 & 주변 장소
검색창은 실제로 무엇을 호출하나요?
단일 요청입니다 —
GET /v1/search/:query. 입력한 것이 IP, ASN, 국가 코드, 이메일, 전화번호 중 무엇인지 감지한 다음, 서버 측에서 관련된 모든 확인(IP 조회, RPKI, 기업, whois, 이동통신사, 호스팅 도메인, 주변 장소)을 병렬로 실행합니다. 한 번의 검색은 기능별로 여러 번이 아니라 일일 요청 한도에서 단 한 번만 차감됩니다.ipto는 RPKI / 경로 출처 인증을 검증하나요?
네 —
GET /v1/ip/:ip/rpki(그리고 명시적인 GET /v1/rpki?asn=&prefix= 형식)는 5개 RIR 전체의 ROA 데이터를 집계하는 RIPEstat을 통해 경로 출처 검증을 실시간으로 확인합니다. 상태는 항상 valid, invalid, unknown 중 하나이며 — 다른 신호로부터 추론되지 않습니다. RPKI 검증기를 사용해 보세요.IP로 기업 조회는 어떻게 작동하며, WHOIS와 무엇이 다른가요?
IP 뒤의 이동통신사를 식별할 수 있나요?
최선의 추정치이며, 이미 모바일 네트워크로 분류된 IP에 대해서만 가능합니다.
GET /v1/ip/:ip/carrier는 ASN의 조직명을 해당 IP 국가로 범위가 지정된 MCC/MNC 사업자 디렉터리와 퍼지 매칭합니다. 의도적으로 단일 carrier: "X" 필드는 없습니다 — 단순한 이름은 데이터가 정직하게 뒷받침할 수 없는 실시간 개별 가입자 주장처럼 읽힐 수 있기 때문입니다. IP로 이동통신사 조회 도구를 사용해 보세요.IP에 어떤 도메인이 호스팅되어 있는지 찾을 수 있나요?
GET /v1/ip/:ip/hosted-domains는 IP의 리버스 DNS 호스트명과 인증서 투명성 로그(crt.sh)를 통해 도메인을 찾습니다 — 이는 일반적인 리버스 IP 조회가 아닙니다. 응답 자체의 limitations 필드는 구조적으로 볼 수 없는 것(PTR 레코드가 없는 IP, 공유 호스팅의 무관한 도메인, CT 로그에 기록된 적 없는 도메인)을 명시합니다. 호스팅 도메인을 사용해 보세요.Places 기능은 무엇인가요?
GET /v1/places/:ip는 IP의 기존 도시 수준 위치를 리버스 지오코딩한 다음, 주변 관심 지점(식당, 공원, 학교, 대중교통), 주요 랜드마크, 데이터 출처가 존재하는 경우 지역 범죄 데이터(영국과 미국만 해당), 목적지를 제공하면 선택적인 온디맨드 자동차 통근 시간 추정치를 반환합니다. 주변 장소를 사용해 보세요.connection_type은 무엇을 의미하며, is_mobile과 어떻게 다른가요?
GET /v1/ip/:ip의 connection_type은 flags 객체와 동일한 ASN 분류에서 도출된 단일 최선 추정 라벨입니다 — mobile, datacenter, unknown 중 하나입니다. 이는 Cloudflare Worker가 관찰할 수 없는(원시 TCP/IP 패킷 접근 불가) 기기 수/NAT 기반 연결 탐지를 대체합니다 — 그래서 이를 위조하는 대신, 분류되지 않은 ASN은 정직하게 unknown을 반환합니다.프리미엄 전화 인텔리전스(통신사 및 번호이동 조회)
형식/지역뿐 아니라 전화번호의 실제 통신사도 조회할 수 있나요?
네, 항상 무료인 로컬 확인 위에 얹히는 프리미엄 레이어로 제공됩니다.
GET /v1/phone/:number는 여전히 먼저 무료 로컬 검증(형식, 지역, 회선 유형 — 변경 없음, 이전 질문 참고)을 실행하고, 예산이 허용하면 당사의 실시간 통신사 조회 제공업체로부터 실시간 carrier, original_carrier, is_ported, phone_type 분류, 그리고 세부 지역 단위의 phone_region과 country_prefix를 추가합니다. 전체 국가명을 담은 country_name은 등급과 관계없이 항상 포함되며, 다른 모든 엔드포인트의 country_name 필드와 마찬가지로 ?lang=/Accept-Language를 통해 현지화됩니다 — 실제로 어떤 언어가 적용되었는지는 응답의 lang/lang_source를 확인하세요. 응답의 source 필드는 어느 등급이 응답했는지 알려줍니다: "premium" 또는 "local".무료 프리미엄(통신사/번호이동) 전화 조회는 몇 번 사용할 수 있나요?
Free 등급은 IP 주소당 월 100회, Pro는 API 키당 월 1,000회, Enterprise는 월 5,000회의 프리미엄 조회를 제공합니다 — 요금제를 참고하세요. 이는 기존 무료 로컬 전화 조회 예산(Free에서 일 100회)에 추가되는 것이며, 이 예산에는 별도의 월간 한도가 없습니다.
해당 월의 프리미엄 전화 조회를 모두 사용하면 어떻게 되나요?
아무것도 깨지지 않습니다.
GET /v1/phone/:number는 남은 기간 동안 무료 로컬 엔진으로 매끄럽게 대체됩니다 — 형식, 지역, 회선 유형 데이터가 포함된 완전한 200 응답은 계속 받지만, 실시간 carrier/is_ported 필드만 없습니다(이 경우 null과 source: "local"을 반환). 오류도 없고, 무료 등급을 계속 사용하기 위한 가입도 필요 없습니다.응답에서 phone_type과 line_type의 차이는 무엇인가요?
이 두 값은 서로 다른 두 엔진에서 나오는 독립적인 분류이며, 의도적으로 분리되어 있습니다.
line_type은 항상 무료인 로컬 확인에서 나옵니다(이 확인의 자체 enum, 예: MOBILE, FIXED_LINE, PREMIUM_RATE). phone_type은 source가 "premium"일 때만 나타나며, 통신사 조회 제공업체 자체의 카테고리를 사용합니다: mobile, fixed_line, voip, toll_free, premium_rate, shared_cost, personal_number, pager, uan, voicemail, unknown. 사기 탐지 신호로 이 API를 사용한다면 특히 premium_rate를 주의 깊게 살펴볼 가치가 있습니다 — 프리미엄 요금 번호(일반 회선보다 분당 요금이 높게 청구되는 번호)는 국제 수익 분배 사기(IRSF, International Revenue Share Fraud)의 흔한 수단이며, 이 엔드포인트는 VoIP만 표시하는 대신 이 분류를 직접 표면화합니다.체커를 사용할 때 제 전화번호가 제3자에게 전송되나요?
실제로 프리미엄 조회가 실행될 때만 그렇습니다(즉, 이전 질문의 월간 예산이 소진되지 않은 경우) — 무료 로컬 확인은 ipto.to 자체의 Cloudflare Workers를 절대 벗어나지 않습니다. 프리미엄 조회가 실행될 때, 번호는 해당 요청 하나에 응답하기 위해서만 당사의 통신사 조회 제공업체로 전송됩니다. 저희는 제공업체의 API 키를 공개적으로 접근 가능한 곳에 저장하지 않으며, ipto.to의 표준 로깅 정책(소개 참고)에 따라 저희도 조회 기록을 로깅하지 않습니다.
계정, 한도 및 개인정보
일일 한도는 언제 초기화되나요?
매일 00:00 UTC에 초기화됩니다. 한도를 초과한 요청은 HTTP 429와 함께
Retry-After 헤더 및 초기화까지 남은 시간을 알려 주는 retry_after_seconds 필드를 반환합니다.API 키는 어떻게 받나요?
API 키는 어떻게 보내나요?
X-API-Key 헤더(쿼리 문자열은 로그에 남을 수 있어 권장) 또는 URL의 ?api_key=로 보냅니다. 키가 포함된 요청은 IP가 아닌 해당 키의 한도에 집계됩니다. 키 사용량은 GET /v1/keys/usage?key=X로 확인하세요.요청 한 번이 항상 1회로 집계되나요?
대부분 그렇습니다. 검색창 검색이나 MCP 도구 호출은 서버에서 여러 검사로 확장되어도 1회 요청입니다. 대량 호출은 항목별로 과금되어,
POST /v1/ip/bulk의 각 IP와 대량 전화 조회의 각 번호가 개별로 집계됩니다. 주변 장소와 프리미엄 전화 조회에는 일반 한도와 별개로 자체 한도가 있습니다.조회한 IP나 쿼리를 기록하나요?
아니요. ipto는 조회한 IP 주소를 기록하지 않고, 쿼리 기록을 저장하거나 프로필을 만들지 않습니다. 용량 계획을 위한 집계된 요청 수만 보관합니다. 홈페이지의 검색 기록과 즐겨찾기 조회는 사용자의 브라우저에만 저장됩니다. 자세한 내용은 개인정보 처리방침을 참고하세요.