常見問題

一個免費的 IP 情資 API。查詢任何 IPv4 或 IPv6 地址,即可取得國家、ASN、ISP、主機偵測、VPN 偵測、Tor 出口節點辨識,以及濫用網路評分。單一 JSON 回應,無需註冊。

不需要。免費方案無需金鑰,也無需註冊——直接呼叫端點即可(額度依 IP 位址統計)。若要使用 Pro 或 Enterprise 的額度,請透過 X-API-Key 標頭或 ?api_key= 傳送您的金鑰。您可以透過 POST /v1/keys 立即取得免費金鑰。

https://ipto.to。所有端點皆位於 /v1/ 之下。所有端點都已啟用 CORS。

GET https://ipto.to/v1/ip — 不需要任何參數,即可回傳您的 IP,連同城市、州／省、時區與經緯度。或在終端機執行 curl ipto.to。

可以。curl ipto.to 會自動偵測 curl 的 User-Agent,並回傳您自己 IP 的精簡 JSON,欄位包含國家、城市、ASN 與即時天氣。curl ipto.to/8.8.8.8 則可查詢任何 IP（不含天氣）。Wget 與 HTTPie 同樣適用。

IP 地理位置對應的是網路基礎設施的實體位置,而非終端使用者本人。ISP 會透過可能遠在數百英里外的區域交換點來路由流量。國家層級的準確度很高,但城市層級的精確度在住宅與行動網路 IP 上會下降。

連上 VPN 時,您的流量會從 VPN 伺服器的 IP 地址對外傳出。ipto 回報的是該出口伺服器的位置,而非您實際所在的位置。此時 is_vpn 旗標會是 true。

資料品質取決於 ISP 與各組織在 WHOIS 及路由註冊機構登記其 IP 網段的準確程度。大型雲端業者與 ISP 的紀錄通常非常準確;較小或較舊的配發紀錄則可能不夠精確。

支援。IPv6 位址會回傳 ASN、組織與 IP 範圍資料;在範圍有涵蓋時,還會回傳來自 MaxMind 資料集的城市層級位置(城市、地區、郵遞區號、經緯度),並辨識 bogon/私有位址區段。唯一的限制是:VPN、Tor 與濫用標記目前僅支援 IPv4,因為這些資料來源以 IPv4 範圍發布——對 IPv6 位址,它們會回傳 false,而不是猜測。

bogon（虛假）IP 是指任何不該出現在公開網際網路來源位置的地址:loopback（127.x.x.x）、RFC 1918 私有範圍（10.x、172.16–31.x、192.168.x）、link-local（169.254.x）、多播（224–239.x）,以及 IANA 保留區塊。ipto 會在進行任何資料庫查詢之前先偵測這些情況,並回傳 bogon: true 與對應的 bogon_type 原因。歡迎在bogon IP 檢查工具查詢任何地址。

ipto 維護一個已知 VPN 伺服器 IP 範圍的資料庫,透過 BGP 路由分析與主動列舉建置而成。每次查詢都會將該 IP 與此資料庫比對。業者歸屬則依 ASN 擁有權推斷:當某個 ASN 專屬登記給 VPN 業者時,即可辨識出該業者。歡迎在VPN 與代理檢查工具測試任何 IP。

Tor 出口節點清單來自 Tor Project 官方在 check.torproject.org 提供的批次出口節點清單,這是目前能夠發起 Tor 出口流量的權威 IP 清單,每 6 小時更新一次。

代表該 IP 落在一個被多個獨立威脅情資來源共同標記為託管濫用基礎設施的網路範圍內:包含垃圾郵件來源、惡意程式命令與控制伺服器、殭屍網路中繼站,或大規模漏洞利用工具。濫用分數越高,代表越多來源各自獨立地做出相同判定。

is_datacenter 代表該 IP 屬於主機代管業者、雲端平台或 CDN。is_residential 代表該 IP 被歸類為一般消費者的寬頻連線。大多數 IP 兩者皆非 — 它們屬於既非主機代管、也非住宅用途的 ISP 基礎設施。

標記出未被歸類為 VPN 或 Tor 的已知代理出口點。目前僅限於威脅情資管線提供的資料,涵蓋範圍低於 VPN 與 Tor 偵測。

自治系統編號（ASN）是網際網路上,一個能獨立管理自身 IP 路由政策的網路的唯一識別碼。例如:Google 是 AS15169,Amazon 是 AS16509。每個 IP 網段都恰好由一個 ASN 公告。歡迎直接在ASN 查詢工具查詢任何 ASN。

代表營運該 ASN 的組織類別。可能值包括:hosting（雲端或伺服器代管）、isp（網際網路服務供應商）、business（企業網路）、education（大學或研究機構）、government（政府）、mobile（電信業者）、residential（住宅）。

代表該 IP 網段是登記給電信業者的。行動網路的 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 查詢工具。

GET /v1/asn/:asn/whois 會透過 RDAP 回傳 RIR 的註冊紀錄（名稱、狀態、國家、註冊／最後異動日期、聯絡人）。GET /v1/asn/:asn/relationships 會根據 CAIDA 的 AS-Relationships 資料集回傳已知的 peer、上游（provider）與下游（customer）;GET /v1/asn/:asn/related 則會找出可能由同一組織營運的其他 ASN。這三者會一起顯示在 ASN 查詢頁面上。

有 — 所有 IP 網段（GET /v1/ip-ranges）是一個可瀏覽的目錄,涵蓋全部 256 個可能的 /8 區塊,並可一路鑽取到 /16、再到實際配發的網段以及各自所屬的 ASN。

免費方案允許每個 IP 地址每日發送 1,000 次請求,無需註冊或金鑰。Pro 金鑰可提升至每日 100,000 次;Enterprise 則無限制。超過限額會回傳 HTTP 429。詳情請見定價頁面。

將 IP 字串組成的 JSON 陣列 POST 到 /v1/ip/bulk — 每次請求最多 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。這個 API 是標準的 HTTP JSON 端點 — 任何 HTTP 客戶端都能使用。curl、JavaScript、Python、PHP 與 Go 的範例請見文件。

可以——https://ipto.to/mcp 是一個 Model Context Protocol(MCP)伺服器,以 JSON-RPC 方式將相同的查詢功能公開為可呼叫的工具——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 偵測對主要業者及所有已確認的出口節點,涵蓋率都很高。若較小或較新的 VPN 服務向一般代管 ASN 承租 IP 空間,則可能無法以業者名稱辨識出來。濫用分數評分採用多方情資交叉驗證 — 需要 3 個以上獨立來源才會列入中等等級,8 個以上來源才會列入嚴重等級。

abuse_score 是根據多方情資交叉驗證得出的 1–10 嚴重程度分數:代表有多少個獨立威脅來源標記同一個網路。threat_type 說明觸發標記的類別 — tor_exit、vpn 或 abuser。risk_tier 則將分數分組為嚴重（8–10）、高（5–7）或中等（3–4）。歡迎在IP 濫用檢查工具進行即時檢查。

會。任何解析出國家的回應都會包含 currency_code 與 exchange_rate_usd — 這是涵蓋 154 種世界貨幣的每日參考匯率。清單之外的貨幣,匯率欄位會回傳 null。

每個包含國家資料的回應都會包含 languages（官方使用語言）、tld（國碼頂級網域）、capital（首都）,以及 borders（鄰國的 ISO 代碼）— 這些資訊有助於本地化內容,或建立具國家感知能力的表單,而無需再多呼叫一次 API。

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 金鑰可解鎖每日 100,000 次請求的額度,以及批量查詢功能（POST /v1/ip/bulk,每次請求最多 100 個 IP）— 免費方案完全不提供批量查詢。Enterprise（無限制請求）則額外提供自訂 SLA 與專屬支援。城市／郵遞區號／經緯度精確度在所有方案（包括免費方案）都已包含。POST /v1/keys 可核發免費方案金鑰（每日 1,000 次請求,可透過 GET /v1/keys/usage?key=X 追蹤用量）— 升級請見定價頁面。

兩者皆可,只要 geo_precision 允許即可。您自己的 IP（GET /v1/ip）一律能從您所連線的邊緣網路取得城市級資料。明確指定 IP 的查詢（GET /v1/ip/:ip）則在該 IP 落在城市級資料集涵蓋範圍內時,才會取得城市級資料;否則 geo_precision 會降為 country,城市／州省／經緯度欄位則回傳 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.

會 — GET /v1/email/:email 會檢查語法、即時查詢 MX 記錄,並比對同步更新的黑名單以偵測一次性／臨時網域。免費使用,無需註冊。歡迎試用Email 檢查工具。

會 — GET /v1/phone/:number 可解析任何 E.164 或國內格式的號碼,依據同步更新的 MCC/MNC 電信業者資料集,判斷其有效性、國家、地區與號碼類型（行動、市話或 VoIP）。歡迎試用電話號碼檢查工具。

GET /v1/fraud-score 將 IP 威脅訊號、Email 可送達性、電話有效性,以及 User-Agent 機器人偵測整合成單一融合的 0–100 風險分數 — 這是主要獨立 IP 情資 API 都沒有提供的功能。四項輸入皆為選填;未提供的訊號會直接視為缺席,而不會被計為乾淨。歡迎試用詐騙分數檢查工具。

可以 — GET /v1/language 透過本機三連字元頻率分析,辨識任意文字屬於 76 種語言中的哪一種。文字不會傳送給任何第三方廠商或 AI 模型,也不會留下任何紀錄。歡迎試用語言偵測工具。

有 — GET /v1/currency/convert 與 GET /v1/currency/rates 提供與每次 IP／國家查詢中 exchange_rate_usd 相同的每日匯率資料,涵蓋 154 種貨幣,另有 GET /v1/currency/history 提供 90 天歷史匯率。歡迎試用貨幣換算工具。

提供 — GET /v1/weather 可回傳任何地名、郵遞區號或座標的目前天氣狀況;加上 &detail=1 可取得每小時展望與 3 天預報。首頁的自身 IP 天氣小工具,以及天氣查詢工具都使用這個端點。

能 — GET /v1/trademark/:serial 會代理 USPTO 的 TSDR API,依 8 位數序號即時查詢案件狀態。案件狀態文字屬於美國政府著作,為公共領域,因此每次回應都會附上 source／attribution 欄位;商標圖樣／圖片資料則刻意不在範圍內。目前不支援依註冊號碼查詢 — USPTO 目前只公開記錄序號路徑。歡迎試用商標查詢工具。

能 — GET /v1/patent/:number 會代理 USPTO 即時的 Patent File Wrapper API,依 7 至 8 位數的發明專利號碼查詢核准狀態。涵蓋範圍從 2001 年提出申請的案件開始,資料屬於審查／書目性質（申請日期、狀態、發明人、登記代理律師）— 並非 Lens.org、Espacenet 或 Google Patents 所提供的引證圖、專利家族或法律狀態欄位。目前尚不支援設計專利、植物專利與再領證專利。歡迎試用專利查詢工具。

單一請求 — GET /v1/search/:query。它會偵測您輸入的是 IP、ASN、國碼、Email 還是電話號碼,然後在伺服器端平行展開所有相關檢查（IP 查詢、RPKI、公司、whois、電信業者、託管網域、周邊地點）。一次搜尋只會佔用您每日額度中的一次請求,而不是每項功能各算一次。

會 — GET /v1/ip/:ip/rpki（或明確指定的 GET /v1/rpki?asn=&prefix= 形式）會透過 RIPEstat 即時解析路由來源驗證結果,而 RIPEstat 彙整了全部五個 RIR 的 ROA 資料。狀態只會是 valid、invalid 或 unknown 其中之一 — 絕不會從其他訊號推斷得出。歡迎試用RPKI 驗證工具。

GET /v1/ip/:ip/company 會結合 RDAP 註冊人資料與該 IP 自身的 ASN 組織名稱,得出一個分級信心結果（高／中／低／無）— 也就是單一的「這是誰的」結論。GET /v1/ip/:ip/whois 則是回傳底層的 RDAP 記錄本身:網段、配發類型、註冊日期,以及登記在案的每個註冊人／管理／濫用通報聯絡窗口,更接近傳統 WHOIS 的輸出格式。歡迎試用IP 對應公司或IP Whois。

這是盡力而為的估算,且僅限已歸類為行動網路的 IP。GET /v1/ip/:ip/carrier 會將該 ASN 的組織名稱,與限定在該 IP 所屬國家的 MCC/MNC 業者名錄進行模糊比對。刻意不提供單一的 carrier: "X" 欄位 — 單純一個名稱會讓人誤以為是針對個別用戶的即時確定結論,而資料無法誠實支持這種說法。歡迎試用IP 對應電信業者工具。

GET /v1/ip/:ip/hosted-domains 會透過該 IP 的反向 DNS 主機名稱,加上憑證透明度日誌（crt.sh）來找出網域 — 這並非通用的反向 IP 查詢。回應本身的 limitations 欄位會明確說明其結構上看不到的部分:沒有 PTR 記錄的 IP、共享主機上的不相關網域,以及從未被 CT 記錄過的網域。歡迎試用託管網域。

GET /v1/places/:ip 會將某 IP 現有的城市級位置進行反向地理編碼,接著回傳附近的興趣點（餐廳、公園、學校、大眾運輸）、知名地標、當地治安資料（僅限有資料來源的英國與美國）,以及在您提供目的地時可額外提供的開車通勤時間估算。歡迎試用周邊地點。

GET /v1/ip/:ip 中的 connection_type 是單一的盡力而為標籤 — mobile、datacenter 或 unknown — 來自與 flags 物件相同的 ASN 分類。它取代了以裝置數量／NAT 為基礎的連線偵測,因為這類偵測不是 Cloudflare Worker 能觀察到的（無法存取原始 TCP/IP 封包）— 因此與其假造結果,未分類的 ASN 會誠實地回傳 unknown。

可以,做為一律免費的本機檢查之上的進階層級。GET /v1/phone/:number仍會先執行免費的本機驗證(格式、地區、線路類型 — 不變,請參閱上一題),額度允許時,還會從我們的即時電信業者查詢服務商取得即時的carrier、original_carrier、is_ported、phone_type分類,以及所在地層級的phone_region與country_prefix。完整的country_name顯示名稱不論方案一律會提供,並會透過?lang=/Accept-Language在地化,方式與其他端點的country_name欄位完全相同 — 可檢查回應中的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")。不會出錯,也不需要註冊即可繼續使用免費方案。

這是來自兩個不同引擎的兩種獨立分類,刻意保持分開。line_type來自一律免費的本機檢查(該檢查自身的列舉,例如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。若你將此服務用於詐騙偵測訊號,premium_rate特別值得留意 — 付費電話號碼(計費費率高於一般線路)是國際加值費率詐騙(IRSF)常見的手法之一,而此端點會直接標示出這項分類,不只是辨識 VoIP 而已。

只有在實際執行進階查詢時才會(也就是上一題所述的月度額度尚未用完時)— 免費的本機檢查絕不會離開 ipto.to 自己的 Cloudflare Workers。當進階查詢確實執行時,號碼只會被傳送給我們的電信業者查詢服務商,僅用於回應那一次請求;我們不會把服務商的 API 金鑰存放在任何公開可存取之處,而且依照 ipto.to 的標準記錄政策(請參閱關於我們),我們自己也不會記錄查詢歷史。

每天 00:00 UTC。超出額度的請求會回傳 HTTP 429,並附帶 Retry-After 標頭與 retry_after_seconds 欄位,準確告知距離重置還有多久。

呼叫 POST /v1/keys 即可立即取得免費方案金鑰,或者登入——登入會自動建立免費方案帳戶,並在儀表板中顯示您的金鑰與用量。升級至 Pro 與 Enterprise 請前往價格頁面。

透過 X-API-Key 標頭(建議,因為查詢字串可能出現在日誌中),或在 URL 中使用 ?api_key=。攜帶金鑰的請求會計入該金鑰的額度,而不是您 IP 的額度。可用 GET /v1/keys/usage?key=X 查看金鑰用量。

大致如此。透過搜尋列搜尋或一次 MCP 工具呼叫,即使在伺服器端展開為多項檢查,也只算一次請求。批次呼叫依項目計費——POST /v1/ip/bulk 中的每個 IP 以及批次電話查詢中的每個號碼都會個別計數。附近地點與進階電話查詢在一般額度之外,另有各自獨立的額度。

不會。ipto 不會記錄您查詢的 IP 位址,不儲存查詢紀錄,也不建立使用者輪廓;僅為容量規劃保留彙總的請求數。首頁的搜尋紀錄與加星號的查詢只儲存在您自己的瀏覽器中。詳情請見隱私權頁面。

可以。API 支援 CORS,在 /v1/ 下進行版本管理,並回傳穩定的 JSON。免費方案適合個人與輕量使用(每天 1,000 次請求);正式環境流量請使用 Pro 金鑰(每天 100,000 次)或 Enterprise(無限制,含客製 SLA)。請參閱價格以及可查看即時健康狀態的狀態頁面。