API 參考

只會以純文字（Content-Type: text/plain）回傳發出請求的客戶端本身的公開 IP 地址 — 例如 73.9.114.155。與 ipinfo.io/ip 完全對應：無論透過 curl、Wget、HTTPie，或直接以瀏覽器造訪都行為一致（不像上方的 curl ipto.to 捷徑，此路徑不做 User-Agent 偵測），在瀏覽器中開啟時只會顯示純粹的 IP，沒有任何頁面外觀。

沒有參數，也沒有查詢字串。若需要完整的地理位置／威脅情報物件，請改用下方的 GET /v1/ip。此路由會直接讀取連線的 IP（不經過 D1/KV 查詢），且不計入每日請求額度 — 詳見 請求頻率限制。

回傳發出請求之 IP 的地理位置與威脅情報，並透過 CF edge 物件提供城市級別的資料。

沒有必填參數。支援 ?lang=、?fields=、?format= — 詳見下方的在地化與輸出格式。

查詢任意 IPv4 地址。當該 IP 落在 IP2Location 或 MaxMind 這兩個合併地理資料集之一時，會填入城市級別欄位（city、state、postal_code、latitude、longitude、timezone） — 請檢查回應中的 geo_precision，以確認取得的是城市級別還是國家級別的資料。timezone 的格式取決於相符的資料來源（IP2Location 提供 UTC 偏移字串，MaxMind 提供 IANA 名稱）。IPv6 查詢目前僅回傳國家級別的資料。

首頁搜尋列背後所使用的統一搜尋端點。會自動偵測 :query 是 IP、ASN（AS15169 或 15169）、兩碼國家代碼、電子郵件，還是電話號碼，然後將所有相關檢查彙整成單一回應。若查詢對象是 IP，伺服器端會平行展開，同時執行主要的 IP 查詢，以及 RPKI、IP-to-company、行動業者、關聯網域與地點等查詢 — 因此單次搜尋只會消耗您每日請求額度中的一次，而不是每項功能各算一次。

每個子欄位皆獨立降級 — 若上游服務（RIPEstat、某個 RDAP 伺服器、crt.sh）緩慢或失敗，只會使該欄位變成 null，而不會導致整個搜尋失敗。只有主要查詢本身無效（例如格式錯誤的 IP）時，整個請求才會回傳錯誤狀態。

反向 DNS — 透過 DNS-over-HTTPS 進行單次即時 PTR 查詢，並非網域列舉資料庫。若該 IP 沒有 PTR 紀錄，則回傳 null。

針對某 IP 目前公告路由的 RPKI 路由來源驗證，透過 RIPEstat 即時解析（本地端不會匯入或同步任何 ROA 資料庫）。status 只會是 "valid"、"invalid" 或 "unknown" 其中之一 — 絕不會從其他訊號合成推論；只要 RIPEstat 失敗或逾時，就會回傳 "unknown" 並附上原因字串，而非錯誤。

明確指定 (ASN, prefix) 的 RPKI 驗證 — 適用於您已經知道確切要檢查的路由，而不需要依賴上方由 IP 推導出路由的便捷方式。

結合 RDAP（結構化 WHOIS）的註冊人資料與 ASN 本身的組織名稱，判斷某 IP 註冊登記的組織，並以分類式的信心等級呈現，而非數值分數。

底層的 RDAP 註冊紀錄本身 — 包含網路區塊、註冊／最後異動日期，以及 RDAP 存檔中的每一位聯絡人。這與上方的 /company 不同：後者會將同一份註冊人資料與 ASN 組織名稱互相比對，整合成單一信心評分的答案；本端點則是原封不動地回傳原始紀錄，較接近傳統 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 — 詳見 pricing。

依編號查詢自治系統。回傳組織名稱、國家、洲別、IP 範圍數量、分類類型、匯率，以及地區參考資料（語言、tld、首都、鄰國）。

對某 IP 既有的城市級別位置進行反向地理編碼，接著回傳附近的興趣點（餐廳、公園、學校、交通、知名地標）、若有資料來源可用的當地犯罪資料（僅限英國與美國），以及可選的即時開車通勤時間估算。

國家層級的彙整統計資料，加上地區參考資料（貨幣、匯率、語言、tld、首都、鄰國）。

解析 User-Agent 字串。回傳瀏覽器、作業系統、裝置類型，以及機器人偵測結果。預設會讀取呼叫端自身的 User-Agent 標頭，也可透過 ?ua= 傳入任意字串。

一律免費驗證並格式化電話號碼：透過自架解析器提供地區、線路類型，以及 E.164／國內／國際格式，不呼叫任何服務商。當每個 IP/金鑰的月度進階額度可用時（Free 方案每月 100 次，付費方案更多 — 請參閱價格），同一請求還會從即時電信業者查詢服務回傳即時電信業者名稱、攜碼狀態，以及服務商分類的電話類型 — 請參閱 source 及下方欄位。不論方案為何，一律會附上已在地化的 country_name，以及 lang/lang_source — 請參閱在地化。進階額度用盡，或上游發生任何問題時，會無縫回退到上方的免費欄位；請求不會因此而失敗。若需要國家層級的網路業者參考資料，而非逐號查詢，請改用 GET /v1/carriers。

批次驗證。每個方案都能使用批次功能（與 /v1/ip/bulk 不同） — 免費方案是靠各方案自身的批次上限來限制，而不是回傳 403。免費方案：每次請求 10 筆，每日 100 筆。Pro：每次請求 100 筆，每日 1,000 筆。Enterprise：每次請求 1,000 筆，每日 10,000 筆。此額度與您一般的每日請求限制分開計算 — 詳見 Rate limits。

參考資料查詢：列出某個國家已知的行動網路業者（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 相同。未傳入的訊號只是不會出現在回應中，而不會被視為「乾淨」計分 — 其權重會重新分配給您實際提供的訊號。

在真實的無頭 Chrome 實例中（Cloudflare Browser Rendering，並非第三方截圖服務商）渲染指定 URL，並回傳 PNG。內部／私有目標（localhost、RFC 1918 範圍、link-local／雲端中繼資料位址）會在瀏覽器啟動前就被拒絕。此功能受限於 Browser Rendering 自身的平台層級限制，比本 API 其餘部分嚴格許多 — 在較低階的 Cloudflare 方案上，這項限制很可能會比您一般的每日請求額度更早觸發節流。

透過本地端的三連字元頻率分析識別文字的語言 — 不呼叫外部服務商、不使用 AI 模型推論、不記錄任何資訊。輸入少於 10 個字元會回傳 null 語言；少於約 30 個字元時仍可能回傳最佳猜測，但 reliable 會是 false。

在兩種貨幣之間換算金額（支援 154 種貨幣），使用與每筆 IP、ASN、國家查詢中 currency_code/exchange_rate_usd 相同的每日參考匯率資料 — 在此以獨立的換算端點呈現，而非內嵌於地理位置回應之中。

完整匯率表（154 種貨幣），可以任何支援的貨幣為基準重新計算，不限於美元。

單一貨幣對最長 90 天的每日參考匯率歷史紀錄 — 即 the currency converter tool 匯率趨勢圖背後的資料。資料先一次性回補，之後由更新 GET /v1/currency/convert 的同一個排程工作每日追加。這是隨時間變化的單一每日參考匯率，而非買賣價差。

針對地名、郵遞區號、"lat,lon" 座標組合，或 lat + lon、ip，提供目前天氣狀況 — 若加上 detail=1，還會提供逐小時展望與多日預報。美國地點由美國國家氣象局（National Weather Service）提供，其他地區由 MET Norway 提供。加上 include= 可取得完整文件，包含單位選擇、最多 9 天、太陽與月亮、官方警報等 — 請見下方的 include 卡片。weather-lookup 工具還會在明確呼叫此端點之前，先於用戶端自動偵測呼叫者本身的位置。

即時代理 USPTO 的 Trademark Status & Document Retrieval（TSDR）系統，依 8 碼流水序號查詢案件狀態 — 每次請求皆直接呼叫，並非快取或轉售的副本。案件狀態資料屬於美國政府著作，依 USPTO 自身的使用條款屬於公共領域，因此每則回應都會附上 source/attribution 欄位，而不會靜默地快取或轉售。商標圖樣／圖片資料刻意排除在範圍之外 — USPTO 的條款將圖片授權與本端點回傳的案件狀態文字資料分開處理。目前尚不支援以註冊號碼查詢；USPTO 目前僅記載序號查詢路徑。歡迎在 Trademark Lookup 工具上試用。

即時代理 USPTO 的 Patent File Wrapper API（Open Data Portal），依 7 至 8 碼發明專利號碼查詢核准狀態 — 每次請求皆直接呼叫，並非快取或轉售的副本。原先鎖定的資料來源（PatentsView 的 Search API）已確認於 2026-03-20 關閉；本端點改為代理其後繼的即時服務。Patent File Wrapper 資料屬於美國政府著作，依 USPTO 自身的使用條款屬於公共領域，因此每則回應都會附上 source/attribution 欄位。涵蓋範圍以申請／審查程序為中心 — 不包含引用關係圖、專利家族、法律狀態欄位或圖片，不像 Lens.org、Espacenet 或 Google Patents 那樣提供。涵蓋範圍自 2001 年申請的案件起算。目前尚不支援設計專利、植物專利與再領證專利；僅支援以核准的發明專利號碼查詢。歡迎在 Patent Lookup 工具上試用。

分頁呈現的 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 金鑰 — 不需要電子郵件，也不需要註冊。每把金鑰起始皆為免費方案（每日 1,000 次請求；不含批次查詢）。Pro 與 Enterprise 金鑰可解鎖更高的每日額度與批次查詢（每次請求最多 100 個 IP） — 詳見 pricing。請妥善保存金鑰 — 之後將無法再次取得。

查詢某把金鑰已發出的請求次數。在任何 /v1/* 請求中，透過 X-API-Key 標頭或 ?api_key= 傳入金鑰，即可計入用量。

擁有某個 IP 的網路的濫用檢舉聯絡方式，來自 RDAP：RIR、網路代號、所屬 CIDR 以及濫用檢舉信箱。用於得知檢舉應寄往何處。

無法連線至註冊機構時，available 為 false，並在 failure 中提供原因。

某個 ASN 實際公告的 IP 範圍，分頁回傳，每個範圍包含國家以及代管 / 行動 / 住宅 / 機器人 / 黑名單標記。

ASN 的註冊機構（RDAP）紀錄：代號、名稱、國家、配置類型、註冊日期、RIR 及其聯絡人。

註冊機構無法連線時，available 為 false 並附上 reason。

可能與此 ASN 相關的其他 ASN：先列出同一註冊組織，再列出相同國家與類型者。

ASN 實際所在位置：根據其最大 IP 範圍的樣本取得的城市層級定位點，以及最常見的城市。用於 ASN 頁面的分布地圖。

這是樣本，並非完整的 IP 範圍清單。要取得所有範圍，請使用 /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 區塊一筆，包含其 IP 範圍、國家與 ASN 的數量以及占比最高的國家。由此開始，再透過 /v1/ip-ranges/:a 與 /v1/ip-ranges/:a/:b 逐層深入。

某個 /8（例如 8.0.0.0/8）內的 /16 區塊，同樣包含每個區塊的 IP 範圍、國家與 ASN 數量。

某個 /16（例如 8.8.0.0/16）內已配置的 IP 範圍，每個範圍附上所屬 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 代理無需閱讀本文件即可呼叫電子郵件端點。