API 문서

요청한 클라이언트의 공인 IP 주소만을 일반 텍스트(Content-Type: text/plain)로 반환합니다 — 예: 73.9.114.155. ipinfo.io/ip와 직접적으로 동일하게 동작합니다: curl, Wget, HTTPie, 또는 일반 브라우저 방문 모두 동일하게 작동하며(위의 curl ipto.to 단축 명령과 달리 User-Agent 감지를 하지 않습니다), 브라우저에서 열면 페이지 장식 없이 순수한 IP만 표시됩니다.

파라미터도 쿼리 문자열도 없습니다. 전체 지오로케이션/위협 인텔리전스 객체가 필요하면 아래의 GET /v1/ip를 대신 사용하세요. 이 라우트는 접속 중인 IP를 직접 읽으며(D1/KV 조회 없음), 일일 요청 한도에 포함되지 않습니다 — 요청 제한을 참고하세요.

요청 IP에 대한 지오로케이션과 위협 인텔리전스를 반환하며, CF 엣지 객체를 통한 도시 수준 데이터도 포함됩니다.

필수 파라미터는 없습니다. ?lang=, ?fields=, ?format=을 지원합니다 — 아래의 현지화 및 출력 형식을 참고하세요.

모든 IPv4 주소를 조회합니다. 도시 수준 필드(city, state, postal_code, latitude, longitude, timezone)는 해당 IP가 병합된 두 지리 데이터셋(IP2Location 또는 MaxMind) 중 하나에 포함될 때 채워집니다 — 응답의 geo_precision을 확인하면 도시 수준 데이터인지 국가 수준 데이터인지 알 수 있습니다. timezone의 형식은 어느 소스가 일치했는지에 따라 달라집니다(IP2Location인 경우 UTC 오프셋 문자열, MaxMind인 경우 IANA 명칭). IPv6 조회는 현재 국가 수준 데이터만 반환합니다.

홈페이지 검색창 뒤에서 동작하는 통합 검색 엔드포인트입니다. :query가 IP인지, ASN(AS15169 또는 15169)인지, 2자리 국가 코드인지, 이메일인지, 전화번호인지를 감지한 뒤 관련된 모든 검사를 하나의 응답으로 취합합니다. IP 쿼리의 경우 서버 측에서 병렬로 기본 IP 조회에 더해 RPKI, IP-to-company, 모바일 통신사, 호스팅된 도메인, places까지 함께 조회하므로, 기능별로 여러 번 요청하는 대신 검색 한 번으로 일일 요청 한도를 한 번만 소모합니다.

각 하위 필드는 독립적으로 성능이 저하됩니다 — 업스트림(RIPEstat, RDAP 서버, crt.sh)이 느리거나 실패하면 해당 필드만 null이 되며, 검색 전체가 실패하지는 않습니다. 기본 쿼리 자체가 유효하지 않은 경우(예: 잘못된 형식의 IP)에만 요청 전체에 대한 오류 상태가 반환됩니다.

역방향 DNS — 도메인 열거 데이터베이스가 아니라 DNS-over-HTTPS를 통한 단발성 실시간 PTR 조회입니다. 해당 IP에 PTR 레코드가 없으면 null을 반환합니다.

IP가 현재 announce 중인 라우트에 대한 RPKI 라우트 오리진 검증으로, RIPEstat을 통해 실시간으로 확인합니다(ROA 데이터베이스를 자체적으로 수집하거나 동기화하지 않습니다). status는 오직 "valid", "invalid", "unknown" 중 하나이며 — 다른 신호로부터 합성되는 값이 아닙니다. RIPEstat 실패나 타임아웃이 발생하면 오류가 아니라 이유를 설명하는 문자열과 함께 "unknown"을 반환합니다.

명시적인 (ASN, prefix) RPKI 검증입니다 — 위의 IP 기반 편의 기능과 달리, 확인하려는 정확한 라우트를 이미 알고 있을 때 사용합니다.

RDAP(구조화된 WHOIS) 등록자 데이터와 ASN 자체 조직명을 결합하여 IP가 등록된 조직을 식별하며, 결과는 숫자 점수가 아니라 범주형 신뢰도로 제공됩니다.

RDAP 등록 레코드 원본 자체입니다 — 네트워크 블록, 등록/최종 변경 날짜, RDAP에 기록된 모든 연락처가 포함됩니다. 이 동일한 등록자 데이터를 ASN 조직명과 대조하여 신뢰도 점수가 매겨진 하나의 답으로 정리하는 위의 /company와는 다르게, 이 엔드포인트는 원본 레코드를 그대로 반환하며 고전적인 WHOIS 출력에 더 가깝습니다. IPv6 주소도 지원됩니다.

모바일 네트워크로 분류된 IP에 대해 MCC/MNC 통신사 디렉터리와 대조하여 최선을 다해 통신사를 식별합니다. 단일 carrier 필드는 의도적으로 제공하지 않습니다 — 아래 matched_carrier_entries와 note를 참고하세요 — 단순한 통신사명만 표시하면 실시간 가입자별 정보처럼 읽힐 수 있는데, 이 데이터로는 그런 주장을 정직하게 뒷받침할 수 없기 때문입니다.

IP의 역방향 DNS(PTR) 호스트명과 인증서 투명성 로그(crt.sh)를 통해 해당 IP와 연관된 도메인을 찾습니다 — 일반적인 역방향 IP 조회가 아닙니다. 응답에 포함된 limitations 필드에서 이 기능이 정확히 무엇을 찾을 수 있고 없는지 설명합니다.

일괄 조회 — 요청당 최대 100개 IP, Pro/Enterprise 전용입니다. 각 IP를 키로 하는 객체를 반환합니다. 캐시와 데이터베이스를 병렬로 읽기 때문에 순차 호출보다 빠릅니다. 배치 안의 각 IP는 개별 조회와 동일하게 일일 요청 한도에 포함됩니다. 무료 티어 요청은 403을 반환합니다 — 요금제를 참고하세요.

번호로 자율 시스템(Autonomous System)을 조회합니다. 조직명, 국가, 대륙, IP 범위 개수, 분류 유형, 환율, 로케일 참조 데이터(languages, tld, capital, borders)를 반환합니다.

IP의 기존 도시 수준 위치를 역지오코딩한 뒤, 주변의 관심 지점(레스토랑, 공원, 학교, 대중교통, 주요 랜드마크), 데이터 소스가 존재하는 지역의 현지 범죄 데이터(영국과 미국만 해당), 그리고 선택적으로 요청 시 계산되는 자동차 통근 시간 추정치를 반환합니다.

국가 수준의 집계 통계와 로케일 참조 데이터(currency, exchange rate, languages, tld, capital, borders)입니다.

User-Agent 문자열을 파싱합니다. 브라우저, OS, 기기 유형, 봇 감지 결과를 반환합니다. 기본적으로 호출자의 User-Agent 헤더를 읽으며, ?ua=를 통해 임의의 문자열을 전달할 수도 있습니다.

전화번호를 항상 무료로 검증하고 형식을 지정합니다: 자체 호스팅 파서를 통해 지역, 회선 유형, E.164/national/international 형식을 제공하며, 제공업체 호출은 없습니다. IP/키당 월간 프리미엄 예산이 있는 경우(Free는 월 100회, 유료 등급은 그 이상 — 요금제 참고), 동일한 요청이 실시간 통신사 조회 서비스로부터 실시간 통신사 이름, 번호이동 상태, 제공업체가 분류한 전화 유형도 추가로 반환합니다 — source와 아래 필드를 참고하세요. 현지화된 country_name과 lang/lang_source는 등급과 관계없이 항상 포함됩니다 — 현지화를 참고하세요. 프리미엄 예산이 소진되거나 업스트림에 문제가 있으면 위의 무료 필드로 매끄럽게 대체되며, 이로 인해 요청이 실패하는 일은 없습니다. 번호별 조회 대신 국가 수준의 네트워크 사업자 참조 데이터가 필요하면 GET /v1/carriers를 참고하세요.

일괄 검증입니다. /v1/ip/bulk와 달리 모든 티어에서 일괄 접근이 가능합니다 — Free 티어를 제한하는 것은 403이 아니라 티어별 배치 상한입니다. Free: 요청당 10개, 하루 100개. Pro: 요청당 100개, 하루 1,000개. Enterprise: 요청당 1,000개, 하루 10,000개. 이 한도는 일반적인 일일 요청 한도와는 별개입니다 — 요청 제한을 참고하세요.

참조 조회: 특정 전화번호와는 무관하게, 주어진 국가에 알려진 모바일 통신사(MCC/MNC)를 조회합니다. 커뮤니티가 관리하는 MCC/MNC 목록(MIT 라이선스, 2026년 마지막 동기화 — 자세한 내용은 docs 저장소를 참고하세요)에서 가져오며, 번호 체계 할당은 자주 바뀌지 않으므로 실시간 피드가 아니라 정적 참조 테이블로 제공됩니다.

이메일 구문 검증, DNS-over-HTTPS를 통한 실시간 MX 레코드 확인, 그리고 커뮤니티가 관리하는 차단 목록(CC0 라이선스, 매일 동기화)을 기준으로 한 일회용/임시 도메인 감지를 수행합니다. 메일함이 실제로 존재하는지는 검증하지 않습니다 — 이를 위해서는 이 API가 수행하지 않는 SMTP 핸드셰이크가 필요합니다(has_mx가 정확히 무엇을 증명하고 증명하지 않는지는 아래 필드 참조를 확인하세요).

IP, 이메일, 전화번호, User-Agent 중 제공한 항목을 결합하여 하나의 0–100 점수로 산출합니다 — 이는 ip-api.com, ipapi.co, ipgeolocation.io, ipify.org, ipregistry.co, ip2location.io, AbstractAPI, IPLocate.io, BigDataCloud 중 어느 곳도 하나의 통합 신호로 제공하지 않는 기능입니다(직접 확인함). 네 개의 입력 모두 선택 사항이며 서로 독립적입니다 — 원하는 조합을 전달하면 됩니다. ip를 생략하면 본인의 IP가, ua를 생략하면 본인의 User-Agent 헤더가 기본값으로 사용되며, 이는 GET /v1/ip 및 GET /v1/ua와 동일한 규칙입니다. 전달하지 않은 신호는 단순히 응답에서 빠지며 정상(clean)으로 채점되지 않습니다 — 그 가중치는 실제로 제공된 신호들에 재분배됩니다.

실제 헤드리스 Chrome 인스턴스(Cloudflare Browser Rendering, 서드파티 스크린샷 업체가 아님)에서 URL을 렌더링하여 PNG를 반환합니다. 내부/사설 대상(localhost, RFC 1918 대역, 링크 로컬/클라우드 메타데이터 주소)은 브라우저가 실행되기도 전에 거부됩니다. Browser Rendering 자체의 플랫폼 수준 제한이 적용되며, 이는 이 API의 다른 부분보다 훨씬 엄격합니다 — 낮은 등급의 Cloudflare 플랜에서는 일반적인 일일 요청 한도에 도달하기 훨씬 전에 이 기능이 먼저 제한될 수 있습니다.

로컬 트라이그램 빈도 분석을 통해 텍스트의 언어를 식별합니다 — 외부 업체 호출도, AI 모델 추론도, 로깅도 없습니다. 입력이 10자 미만이면 language는 null을 반환하며, 약 30자 미만이면 최선의 추측값은 반환하지만 reliable은 false가 됩니다.

모든 IP, ASN, 국가 조회에서 currency_code/exchange_rate_usd를 제공하는 것과 동일한 일일 기준 환율 피드를 사용하여 두 통화(154개 지원) 간 금액을 변환합니다 — 지오로케이션 응답 안에 중첩되는 대신 독립적인 변환 엔드포인트로 제공됩니다.

USD뿐 아니라 지원되는 모든 통화를 기준으로 재계산한 전체 환율표(154개 통화)입니다.

하나의 통화 쌍에 대해 최대 90일 전까지의 일일 기준 환율 이력입니다 — 환율 변환 도구의 환율 추세 차트 뒤에 있는 데이터입니다. 한 번 백필된 뒤, GET /v1/currency/convert를 업데이트하는 것과 동일한 cron에 의해 매일 추가됩니다. 매수/매도 거래 스프레드가 아니라 시간에 따른 단일 일일 기준 환율입니다.

지명, 우편번호 또는 "lat,lon" 쌍, 혹은 lat + lon 또는 ip에 대한 현재 기상 상태를 반환하며, detail=1을 사용하면 시간별 전망과 여러 날에 걸친 예보도 함께 제공합니다. 미국 지역은 미국 국립기상청(National Weather Service)이, 그 밖의 지역은 MET Norway가 응답합니다. include=를 추가하면 단위 선택, 최대 9일, 태양과 달, 공식 경보 등을 포함한 전체 문서를 받을 수 있습니다 — 아래의 include 카드를 참고하세요. weather-lookup 도구는 이 엔드포인트를 명시적으로 호출하기 전에 브라우저에서 호출자 자신의 위치도 자동으로 감지합니다.

8자리 일련번호로 사건 상태를 조회하기 위해 USPTO의 Trademark Status & Document Retrieval(TSDR) 시스템에 실시간으로 프록시합니다 — 요청마다 직접 호출되며, 캐시되거나 재판매되는 사본이 아닙니다. 사건 상태 데이터는 미국 정부 저작물로서 USPTO 이용 약관에 따라 퍼블릭 도메인이므로, 모든 응답에는 이를 조용히 캐시하거나 재판매하는 대신 source/attribution 필드가 포함됩니다. 상표 로고/이미지 데이터는 의도적으로 범위에서 제외됩니다 — USPTO 약관은 이미지 라이선스를 이 엔드포인트가 반환하는 사건 상태 텍스트 데이터와 별도로 취급합니다. 등록번호 조회는 아직 지원되지 않습니다. 현재 USPTO가 문서화한 것은 일련번호 경로뿐입니다. 상표 조회 도구에서 직접 사용해 보세요.

7~8자리 실용특허(utility patent) 번호로 등록 상태를 조회하기 위해 USPTO의 Patent File Wrapper API(Open Data Portal)에 실시간으로 프록시합니다 — 요청마다 직접 호출되며, 캐시되거나 재판매되는 사본이 아닙니다. 원래 목표했던 소스(PatentsView의 Search API)는 2026-03-20에 서비스 종료가 확인되어, 대신 그 실시간 후속 서비스에 프록시합니다. Patent File Wrapper 데이터는 미국 정부 저작물로서 USPTO 이용 약관에 따라 퍼블릭 도메인이므로, 모든 응답에는 source/attribution 필드가 포함됩니다. 범위는 출원/심사 절차 중심입니다 — Lens.org, Espacenet, Google Patents처럼 인용 그래프, 특허 패밀리, 법적 상태 필드, 이미지는 제공하지 않습니다. 데이터 범위는 2001년 이후 출원부터 시작합니다. 디자인, 식물, 재발행 특허는 아직 지원되지 않으며, 등록된 특허 번호를 통한 실용특허만 지원됩니다. 특허 조회 도구에서 직접 사용해 보세요.

페이지네이션된 VPN, Tor, 위협 인텔리전스 피드입니다. 페이지당 200개 항목이 제공됩니다. 각 항목에는 IP/CIDR, 제공자 정보, ISP, 국가, 분류 유형이 포함됩니다.

메타데이터만 반환합니다 — 전체 항목 수, 소스별 개수, 마지막 동기화 시간. IP 데이터는 반환하지 않습니다.

페이지네이션된 악용 네트워크 범위입니다. 여러 피드 간 교차 검증을 통해 1-10점으로 점수가 매겨집니다. 위험 등급: critical(8-10), high(5-7), medium(3-4).

메타데이터만 반환합니다 — 전체 네트워크 수, 소스별 개수, 위험 등급별 분류, 마지막 동기화 시간.

이 API가 이미 기반으로 하고 있는 공개 데이터셋을 다운로드 가능한 CSV로 내보냅니다 — 동일한 데이터이며 새로운 라이선스는 아닙니다. asn과 ranges는 항상 사용할 수 있으며, geo-city는 해당 소스의 데이터셋이 배포 환경에서 활성화되기 전까지 503을 반환합니다. geo-city는 병합된 뷰가 아니라 한 번에 하나의 지리 소스의 원본 행을 내보냅니다 — ?source=primary(기본값) 또는 ?source=secondary를 전달하세요.

API 키를 즉시 발급합니다 — 이메일도 가입도 필요 없습니다. 모든 키는 Free 티어(하루 1,000회 요청, 일괄 조회 미포함)로 시작합니다. Pro와 Enterprise 키는 더 높은 일일 한도와 일괄 조회(요청당 최대 100개 IP)를 제공합니다 — 요금제를 참고하세요. 키를 안전하게 보관하세요 — 나중에 다시 조회할 수 없습니다.

키가 지금까지 몇 번의 요청을 했는지 확인합니다. 요청 수에 반영되도록 하려면 임의의 /v1/* 요청에 X-API-Key 헤더 또는 ?api_key=로 키를 전달하세요.

IP를 소유한 네트워크의 악용 신고 연락처를 RDAP에서 가져옵니다: RIR, 네트워크 핸들, 해당 CIDR, 악용 신고용 메일함. 신고를 어디로 보내야 하는지 알 때 사용합니다.

레지스트리에 연결할 수 없으면 available 은 false 이며 failure 에 사유가 들어갑니다.

ASN이 실제로 광고하는 IP 범위를 페이지 단위로 반환하며, 각 범위에는 국가와 호스팅 / 모바일 / 주거용 / 봇 / 블랙리스트 플래그가 포함됩니다.

ASN의 레지스트리(RDAP) 정보: 핸들, 이름, 국가, 할당 유형, 등록일, RIR 및 연락처.

레지스트리에 연결할 수 없으면 available 은 false 이며 reason 이 포함됩니다.

이 ASN과 관련되었을 가능성이 높은 다른 ASN: 같은 등록 조직이 먼저, 그다음 같은 국가와 유형입니다.

ASN이 실제로 어디에 있는지: 가장 큰 범위 일부를 샘플링해 도시 수준으로 위치를 파악한 지점과 가장 많은 도시. ASN 페이지의 분포 지도에 사용됩니다.

샘플이며 전체 범위 목록이 아닙니다. 모든 범위는 /v1/asn/:asn/ranges 를 사용하세요.

ASN에서 호스팅되는 도메인으로, 주소 샘플에 대한 역방향 DNS(PTR)로 찾습니다. 각 항목에는 루트 도메인, PTR 호스트 이름, 샘플링한 IP가 포함됩니다.

샘플링한 결과이므로 ASN이 무엇을 호스팅하는지에 대한 단서일 뿐 전체 목록이 아닙니다. 단일 IP는 /v1/ip/:ip/hosted-domains 를 사용하세요.

ASN의 BGP 관계: 피어, 업스트림 공급자, 다운스트림 고객과 각각의 개수.

BGP 데이터 소스에 연결할 수 없으면 available 은 false 입니다. available: true 이면서 배열이 비어 있으면 해당 ASN에 대해 보고된 항목이 없다는 뜻입니다.

IPv4 공간 디렉터리: /8 블록마다 한 항목으로, 포함된 범위·국가·ASN 수와 최다 국가를 보여줍니다. 여기서 시작해 /v1/ip-ranges/:a 와 /v1/ip-ranges/:a/:b 로 더 깊이 들어가세요.

하나의 /8(예: 8.0.0.0/8) 안의 /16 블록으로, 블록별 범위·국가·ASN 수가 같은 형식으로 포함됩니다.

하나의 /16(예: 8.8.0.0/16) 안의 할당된 범위로, 각 범위가 속한 ASN과 블록별 개수가 포함됩니다.

좌표에 대한 Nearby 페이로드의 한 부분으로, 클라이언트가 도착하는 대로 각 부분을 렌더링할 수 있습니다: 역지오코딩, 주변 관심 장소, 지역 범죄 통계.

두 지점 간 자동차 이동 시간과 거리. 빠른 경로: /v1/places/:ip 가 수행하는 역지오코딩과 주변 장소 조회를 건너뜁니다.

목적지를 확인할 수 없으면 응답에 to: null, commute: null 및 reason 문자열이 포함됩니다.

IP 대신 입력한 도로명 주소를 기준으로 한 /v1/places/:ip 페이로드: 지오코드, 지역 정보, 선택적 통근 시간 추정.

주소를 지오코딩할 수 없으면 found 는 false 입니다.

주소 자동 완성: 입력 중인 주소와 일치하는 몇 개의 장소를 반환하며, 특정 지점을 우선하도록 지정할 수 있습니다.

지명, 우편번호, 좌표 또는 IP에 대한 전체 날씨 문서입니다. include로 필요한 블록을 고르세요: current, hourly, daily, astro(태양과 달), solar, indicators, alerts, marine, air_quality, nowcast 또는 all. 미국 지역은 미국 국립기상청(National Weather Service), 그 밖의 지역은 MET Norway의 데이터이며 어느 쪽인지는 meta.source에 표시됩니다. include를 생략하면 위에 설명한 간단한 { query, weather } 형식이 반환됩니다.

meta.coverage는 해당 장소에서 사용할 수 있는 필드를 알려줍니다. 강수 확률, 돌풍, 뇌우 확률은 미국과 북유럽에만 있으며 그 밖의 지역에서는 null입니다(0이 아님). alerts는 미국과 노르웨이의 공식 경보입니다. marine, air_quality, nowcast는 노르웨이와 인근 해역만 다루며 다른 곳에서는 available: false입니다. meta.derived에 있는 항목은 ipto.to의 추정값이고, indicators는 파생된 표시일 뿐 공식 경보가 아닙니다. 데이터를 표시할 때는 meta.attribution을 유지하세요(MET Norway 데이터는 CC BY 4.0입니다).

이미 조회된 장소에 대해 ipto.to가 자체적으로 기록한 일별 데이터입니다. 그날의 예보 스냅샷에서 나타난 가장 높은 최고기온, 가장 낮은 최저기온, 가장 큰 강수량을 담습니다. 이미 요청된 장소만 데이터가 있으며 시간이 지나며 쌓입니다.

예보 스냅샷이며 관측소 관측값이나 재분석이 아니므로 관측된 이력으로 사용하지 마세요. 404는 해당 장소의 스냅샷이 아직 기록되지 않았다는 뜻입니다.

사용 가능한 레이더 애니메이션 프레임을 오래된 순으로 반환하며, 각 프레임에는 Unix 타임스탬프와 레이더 타일 URL에 사용할 프레임 id가 있습니다.

표준 웹 지도 z/x/y 위치에서 한 프레임의 레이더 지도 타일(PNG). 같은 출처로 프록시되어 지도가 서드파티 요청 없이 불러올 수 있습니다.

표준 웹 지도 z/x/y 위치의 위성 영상 지도 타일로, 같은 출처로 프록시됩니다.

/v1/email/:email 에 대한 기계 판독 가능한 OpenAPI 3.1 계약. LLM 및 MCP 에이전트가 이 문서를 읽지 않고도 이메일 엔드포인트를 호출할 수 있도록 작성되었습니다.