A free IP intelligence API. Look up any IPv4 or IPv6 address and get country, ASN, ISP, hosting detection, VPN detection, Tor exit node identification, and abusive network scoring. One JSON response. No signup.

Do I need an API key?

No. The free tier needs no key and no signup — just call the endpoint (limits are tracked per IP address). If you want Pro or Enterprise limits, send your key in the X-API-Key header or as ?api_key=. You can issue a free key instantly with POST /v1/keys.

What is the base URL?

https://ipto.to. All endpoints are under /v1/. CORS is enabled on all endpoints.

How do I look up my own IP?

GET https://ipto.to/v1/ip — no parameter needed. Returns your IP along with city, state, timezone, and lat/lon. Or run curl ipto.to in a terminal.

Can I use this from the terminal?

Yes. curl ipto.to auto-detects the curl User-Agent and returns compact JSON for your own IP, including live weather. curl ipto.to/8.8.8.8 does the same for any IP — same compact field set, no weather. Wget and HTTPie also work. This shortcut returns fewer fields than the full GET /v1/ip and GET /v1/ip/:ip JSON endpoints.

Why does the location show the wrong city?

IP geolocation maps IP ranges to the physical location of the network infrastructure, not the end user. ISPs route traffic through regional exchange points that can be hundreds of miles away. Country accuracy is high. City-level precision degrades for residential and mobile IPs.

Why is the country wrong when I use a VPN?

When connected to a VPN, your traffic exits from the VPN server's IP address. ipto reports the location of that exit server, not your physical location. The is_vpn flag will be true in this case.

What does geolocation accuracy depend on?

Data quality depends on how accurately ISPs and organisations register their IP blocks in WHOIS and route registries. Large cloud providers and ISPs have highly accurate records. Smaller or older allocations can be imprecise.

Yes. IPv6 addresses return ASN, organisation, and IP-range data, plus city-level location (city, region, postal code, latitude/longitude) from the MaxMind dataset where the range is covered, and bogon/private ranges are identified. The one gap: the VPN, Tor, and abuse flags are IPv4-only for now, because those feeds are published as IPv4 ranges — on an IPv6 address they come back false rather than guessed.

A bogon (bogus) IP is any address that should not appear as a source on the public internet: loopback (127.x.x.x), RFC 1918 private ranges (10.x, 172.16-31.x, 192.168.x), link-local (169.254.x), multicast (224-239.x), and IANA reserved blocks. ipto detects these before any database lookup and returns bogon: true with a bogon_type reason. Check any address on the bogon IP checker.

How do you detect VPNs?

ipto maintains a database of known VPN server IP ranges, built from BGP routing analysis and active enumeration. Each IP is checked against this database on lookup. Provider attribution is derived from ASN ownership: when an ASN is registered exclusively to a VPN operator, the provider is identified. Test any IP on the VPN & proxy checker.

How do you detect Tor exit nodes?

The Tor exit node list is sourced from the official Tor Project bulk exit node list at check.torproject.org. This is the authoritative list of IPs currently able to originate Tor exit traffic. It is refreshed every 6 hours.

What does is_abuser mean?

The IP falls within a network range that has been flagged by multiple independent threat intelligence feeds as hosting abusive infrastructure: spam sources, malware command-and-control servers, botnet relays, or mass-exploitation tooling. A higher abuse score means more feeds agreed independently.

What is the difference between is_datacenter and is_residential?

is_datacenter means the IP belongs to a hosting provider, cloud platform, or CDN. is_residential means the IP is classified as a consumer broadband connection. Most IPs are neither — they belong to ISP infrastructure that is neither hosting nor residential.

Flags known proxy exit points not categorised as VPN or Tor. Currently limited to data from the threat feed pipeline. Coverage is lower than VPN and Tor detection.

An Autonomous System Number (ASN) is a unique identifier for a network that independently manages its own IP routing policies on the internet. Examples: Google is AS15169, Amazon is AS16509. Every IP block is announced by exactly one ASN. Look any ASN up directly on the ASN lookup tool.

What does asn_type mean?

The category of the organisation that operates the ASN. Values: hosting (cloud or server hosting), isp (internet service provider), business (enterprise network), education (university or research), government, mobile (carrier), residential.

What does is_mobile mean?

The IP block is registered to a mobile carrier. Mobile IPs are commonly reassigned between users and often appear in different geographic locations than the carrier's headquarters.

What is the rate limit?

The free tier allows 1,000 requests/day per IP address, no signup or key required. Pro keys get 100,000/day; Enterprise is unlimited. Exceeding your limit returns HTTP 429. See /pricing for details.

How do I do a bulk lookup?

POST a JSON array of IP strings to /v1/ip/bulk — up to 100 per request, Pro/Enterprise only (see /pricing). The response is an object keyed by IP. Parallel cache reads make this faster than sequential calls. Each IP counts against your daily budget, same as an individual lookup.

How do I filter the response fields?

Add ?fields=field1,field2 to any single-IP request. Example: /v1/ip/1.1.1.1?fields=ip,country_code,is_vpn,is_tor. The ip field is always included.

What output formats are available?

JSON (default), CSV, plain text, XML, and YAML. Add ?format=csv, ?format=text, ?format=xml, or ?format=yaml to any single-IP request. CSV and text return flat key/value pairs; XML and YAML preserve nested objects like flags.

No official SDK yet. The API is a standard HTTP JSON endpoint — any HTTP client works. See the docs for curl, JavaScript, Python, PHP, and Go examples.

How often is the data updated?

The ASN/IP-range dataset is refreshed daily at 04:00 UTC. City-level geolocation merges two independent sources on their own schedules — IP2Location monthly, MaxMind weekly — so precision can improve between ASN refreshes. Threat feeds (VPN, Tor, abuse) sync every 6 hours. The edge cache TTL is 5 minutes.

What data sources do you use?

We gather info from several key industry data providers, updated daily. VPN detection uses BGP-derived range intelligence. Tor node data comes from the official Tor Project registry and verified relay lists. Abuse networks use cross-corroborated multi-source blacklist intelligence.

How accurate is the threat intelligence?

VPN and Tor detection has high recall for major providers and all confirmed exit nodes. Smaller or newer VPN services that lease IP space from generic hosting ASNs may not be identified by provider name. Abuse scoring uses cross-feed corroboration — a network requires 3+ independent sources to appear at Medium tier, and 8+ sources for Critical.

What do abuse_score and threat_type mean?

abuse_score is a 1-10 severity score based on cross-feed corroboration: how many independent threat sources flag the same network. threat_type names which category triggered the flag — tor_exit, vpn, or abuser. risk_tier groups the score into critical (8-10), high (5-7), or medium (3-4). Try a live check on the IP abuse checker.

Does ipto return currency exchange rates?

Yes. Any response with a resolved country includes currency_code and exchange_rate_usd — a daily reference rate covering 154 world currencies. Currencies outside that list return null for the rate.

What locale data is included in a response?

Each response with country data includes languages (official languages spoken), tld (country-code top-level domains), capital, and borders (ISO codes of neighboring countries) — useful for localizing content or building country-aware forms without a second API call.

How do I do a reverse DNS / hostname lookup?

GET /v1/ip/:ip/hostname performs a live PTR lookup over DNS-over-HTTPS and returns { ip, hostname }. It's a single on-demand lookup, not a cached domain-enumeration database — hostname is null if no PTR record exists. There's also a browser tool at /reverse-dns-lookup.

Can I download the raw datasets?

Yes. GET /v1/datasets/:kind returns CSV exports for asn, ranges, and geo-city — the same datasets the API queries internally, refreshed on the same schedule. geo-city takes an optional ?source=primary (default) or ?source=secondary, since city-level data is merged from two independent sources with different coverage.

What do I get from a Pro or Enterprise API key?

A Pro key unlocks a 100,000 requests/day limit and bulk lookup (POST /v1/ip/bulk, up to 100 IPs per request) — bulk isn't available on Free at all. Enterprise (unlimited requests) adds a custom SLA and dedicated support. City/postal/lat-lon precision is included at every tier, including Free. Free-tier keys (POST /v1/keys, 1,000 requests/day) — see GET /v1/keys/usage?key=X.

Does city-level geolocation work for any IP, or just my own?

Both, when geo_precision allows it. Your own IP (GET /v1/ip) always gets city-level data from the edge network you're connecting through. Explicit IP lookups (GET /v1/ip/:ip) get city-level data when that IP falls inside the city-level dataset's coverage; otherwise geo_precision drops to country and city/state/lat/lon return null.

When does my daily limit reset?

Every day at 00:00 UTC. A request over the limit returns HTTP 429 with a Retry-After header and a retry_after_seconds field telling you exactly how long until the window resets.

How do I get an API key?

Call POST /v1/keys for an instant Free-tier key, or sign in — signing in creates an account on the Free tier automatically and shows your key and usage on the dashboard. Pro and Enterprise are upgrades from pricing.

How do I send my API key?

In the X-API-Key header (preferred, since query strings can end up in logs) or as ?api_key= on the URL. Requests that carry a key are counted against that key's budget instead of your IP's. Check a key's usage with GET /v1/keys/usage?key=X.

Does one request always count as one request?

Mostly. A search-bar search or an MCP tool call is one request even when it fans out to several checks server-side. Bulk calls are charged per item — each IP in POST /v1/ip/bulk and each number in a bulk phone lookup counts individually. Nearby (places) and premium phone lookups also have their own separate budgets on top of the general one.

Do you log the IPs or queries I look up?

No. ipto doesn't log the IP addresses you look up, store query history, or build profiles; only aggregate request counts are kept for capacity planning. Your homepage search history and starred lookups live only in your own browser. Details are on the privacy page.

Can I use ipto in a production app?

Yes. The API is CORS-enabled, versioned under /v1/, and returns stable JSON. The Free tier is meant for individuals and light use (1,000 requests/day); for production traffic use a Pro key (100,000/day) or Enterprise (unlimited, with a custom SLA). See pricing and the status page for live health.

अक्सर पूछे जाने वाले सवाल

IP जियोलोकेशन, VPN डिटेक्शन, ASN लुकअप, रेट लिमिट, और API कैसे काम करता है — इससे जुड़ी हर चीज़।

शुरुआत करें

ipto क्या है?

एक फ्री IP इंटेलिजेंस API। किसी भी IPv4 या IPv6 एड्रेस को लुकअप करें और देश, ASN, ISP, होस्टिंग डिटेक्शन, VPN डिटेक्शन, Tor एग्ज़िट नोड आइडेंटिफ़िकेशन, और एब्यूज़िव नेटवर्क स्कोरिंग पाएं। एक JSON रिस्पॉन्स। कोई साइनअप नहीं।

क्या मुझे एक API की चाहिए?

नहीं। फ्री टियर में न कोई key चाहिए, न साइनअप — बस endpoint को सीधे कॉल करें (limits हर IP address के हिसाब से गिनी जाती हैं)। Pro या Enterprise limits चाहिए तो अपनी key X-API-Key header में या ?api_key= के रूप में भेजें। फ्री key आप POST /v1/keys से तुरंत बना सकते हैं।

बेस URL क्या है?

https://ipto.to। सभी एंडपॉइंट्स /v1/ के तहत आते हैं। सभी एंडपॉइंट्स पर CORS इनेबल्ड है।

मैं अपना खुद का IP कैसे लुकअप करूं?

GET https://ipto.to/v1/ip — किसी पैरामीटर की ज़रूरत नहीं। यह आपका IP शहर, राज्य, टाइमज़ोन, और lat/lon के साथ रिटर्न करता है। या टर्मिनल में curl ipto.to चलाएं।

क्या मैं इसे टर्मिनल से इस्तेमाल कर सकता हूं?

हां। curl ipto.to curl के User-Agent को अपने आप डिटेक्ट कर लेता है और आपके अपने IP के लिए कॉम्पैक्ट JSON रिटर्न करता है, जिसमें देश, शहर, ASN, और लाइव मौसम जैसे फ़ील्ड शामिल हैं। curl ipto.to/8.8.8.8 किसी भी IP के लिए वही करता है (मौसम के बिना)। Wget और HTTPie भी काम करते हैं।

IP जियोलोकेशन

लोकेशन गलत शहर क्यों दिखाती है?

IP जियोलोकेशन IP रेंज को नेटवर्क इंफ्रास्ट्रक्चर की फिज़िकल लोकेशन से मैप करती है, एंड-यूज़र से नहीं। ISPs ट्रैफ़िक को ऐसे रीजनल एक्सचेंज पॉइंट्स के ज़रिए रूट करते हैं जो सैकड़ों मील दूर हो सकते हैं। कंट्री एक्यूरेसी ज़्यादा है। रेजिडेंशियल और मोबाइल IPs के लिए सिटी-लेवल प्रिसीज़न कम हो जाती है।

VPN इस्तेमाल करने पर देश गलत क्यों दिखता है?

जब आप किसी VPN से कनेक्टेड होते हैं, तो आपका ट्रैफ़िक VPN सर्वर के IP एड्रेस से निकलता है। ipto उस एग्ज़िट सर्वर की लोकेशन बताता है, आपकी फिज़िकल लोकेशन नहीं। ऐसे में is_vpn फ़्लैग true होगा।

जियोलोकेशन एक्यूरेसी किस पर निर्भर करती है?

डेटा क्वालिटी इस पर निर्भर करती है कि ISPs और संस्थाएं अपने IP ब्लॉक्स को WHOIS और रूट रजिस्ट्रीज़ में कितनी सटीकता से रजिस्टर करती हैं। बड़े क्लाउड प्रोवाइडर्स और ISPs के रिकॉर्ड्स काफ़ी सटीक होते हैं। छोटे या पुराने अलोकेशन कम सटीक हो सकते हैं।

क्या आप IPv6 सपोर्ट करते हैं?

हाँ। IPv6 addresses के लिए ASN, organisation और IP range डेटा मिलता है, साथ ही जहाँ range कवर है वहाँ MaxMind dataset से city-level location (शहर, क्षेत्र, पोस्टल कोड, latitude/longitude) भी मिलती है, और bogon/private ranges की पहचान होती है। एक ही कमी है: VPN, Tor और abuse flags फिलहाल सिर्फ IPv4 के लिए हैं, क्योंकि ये feeds IPv4 ranges के रूप में प्रकाशित होते हैं — IPv6 address पर ये अनुमान लगाने के बजाय false लौटाते हैं।

बोगॉन IP क्या होता है?

बोगॉन (बोगस) 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_type वजह के साथ bogon: true रिटर्न करता है। बोगॉन IP चेकर पर कोई भी एड्रेस चेक करें।

थ्रेट इंटेलिजेंस

आप VPN कैसे डिटेक्ट करते हैं?

ipto जाने-पहचाने VPN सर्वर IP रेंज का एक डेटाबेस मेंटेन करता है, जो BGP रूटिंग एनालिसिस और एक्टिव एन्युमरेशन से बनाया गया है। लुकअप पर हर IP को इस डेटाबेस के विरुद्ध चेक किया जाता है। प्रोवाइडर एट्रिब्यूशन ASN ओनरशिप से निकाला जाता है: जब कोई ASN किसी VPN ऑपरेटर के नाम पर एक्सक्लूसिवली रजिस्टर्ड होता है, तो प्रोवाइडर की पहचान हो जाती है। VPN & प्रॉक्सी चेकर पर किसी भी IP को टेस्ट करें।

आप Tor एग्ज़िट नोड्स कैसे डिटेक्ट करते हैं?

Tor एग्ज़िट नोड लिस्ट check.torproject.org पर मौजूद ऑफ़िशियल Tor Project की बल्क एग्ज़िट नोड लिस्ट से ली जाती है। यह उन IPs की अथॉरिटेटिव लिस्ट है जो अभी Tor एग्ज़िट ट्रैफ़िक शुरू कर सकते हैं। यह हर 6 घंटे में रिफ्रेश होती है।

is_abuser का क्या मतलब है?

यह IP एक ऐसी नेटवर्क रेंज के अंदर आता है जिसे कई इंडिपेंडेंट थ्रेट इंटेलिजेंस फ़ीड्स ने एब्यूज़िव इंफ्रास्ट्रक्चर होस्ट करने के लिए फ़्लैग किया है: स्पैम सोर्स, मालवेयर कमांड-एंड-कंट्रोल सर्वर्स, बॉटनेट रिले, या मास-एक्सप्लॉइटेशन टूलिंग। ज़्यादा एब्यूज़ स्कोर का मतलब है कि ज़्यादा फ़ीड्स इंडिपेंडेंटली सहमत हुईं।

is_datacenter और is_residential में क्या फ़र्क़ है?

is_datacenter का मतलब है कि IP किसी होस्टिंग प्रोवाइडर, क्लाउड प्लेटफ़ॉर्म, या CDN का है। is_residential का मतलब है कि IP को एक कंज़्यूमर ब्रॉडबैंड कनेक्शन के तौर पर क्लासीफाई किया गया है। ज़्यादातर IPs न तो एक हैं न दूसरे — वे ISP इंफ्रास्ट्रक्चर के हैं जो न होस्टिंग है न रेजिडेंशियल।

is_proxy क्या है?

यह जाने-पहचाने प्रॉक्सी एग्ज़िट पॉइंट्स को फ़्लैग करता है जो VPN या Tor के तौर पर कैटेगराइज़ नहीं हैं। फ़िलहाल यह थ्रेट फ़ीड पाइपलाइन के डेटा तक सीमित है। कवरेज VPN और Tor डिटेक्शन से कम है।

ASN और नेटवर्क

ASN क्या है?

एक Autonomous System Number (ASN) किसी ऐसे नेटवर्क का यूनीक आइडेंटिफ़ायर है जो इंटरनेट पर अपनी IP रूटिंग पॉलिसीज़ खुद इंडिपेंडेंटली मैनेज करता है। उदाहरण: Google AS15169 है, Amazon AS16509 है। हर IP ब्लॉक ठीक एक ASN द्वारा अनाउंस किया जाता है। किसी भी ASN को सीधे ASN लुकअप टूल पर लुकअप करें।

asn_type का क्या मतलब है?

यह उस संस्था की कैटेगरी है जो ASN ऑपरेट करती है। वैल्यूज़: hosting (क्लाउड या सर्वर होस्टिंग), isp (इंटरनेट सर्विस प्रोवाइडर), business (एंटरप्राइज़ नेटवर्क), education (यूनिवर्सिटी या रिसर्च), government, mobile (कैरियर), residential।

is_mobile का क्या मतलब है?

यह IP ब्लॉक किसी मोबाइल कैरियर के नाम रजिस्टर्ड है। मोबाइल IPs आमतौर पर यूज़र्स के बीच दोबारा असाइन होते रहते हैं और अक्सर कैरियर के हेडक्वार्टर से अलग भौगोलिक लोकेशंस में दिखते हैं।

क्या मैं किसी 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 डेटासेट से जाने-माने peers, अपस्ट्रीम प्रोवाइडर्स, और डाउनस्ट्रीम कस्टमर्स रिटर्न करता है; वहीं GET /v1/asn/:asn/related ऐसे दूसरे ASNs ढूंढता है जो संभवतः उसी संगठन द्वारा चलाए जाते हैं। ये तीनों ASN लुकअप पेज पर एक साथ दिखते हैं।

क्या पूरे पब्लिक IPv4 एड्रेस स्पेस की कोई डायरेक्टरी है, न कि एक बार में सिर्फ़ एक ASN की?

हां — All IP Ranges (GET /v1/ip-ranges) सभी 256 संभावित /8 ब्लॉक्स की एक ब्राउज़ करने लायक डायरेक्टरी है, जो /16 तक ड्रिल-डाउन करके असल में असाइन की गई रेंज और हर एक जिस ASN से जुड़ी है, वो दिखाती है।

API इस्तेमाल

रेट लिमिट क्या है?

फ्री टियर हर IP एड्रेस के लिए रोज़ाना 1,000 रिक्वेस्ट की इजाज़त देता है, कोई साइनअप या की नहीं चाहिए। Pro की से यह 100,000/दिन हो जाती है; Enterprise असीमित है। अपनी लिमिट पार करने पर HTTP 429 मिलता है। पूरी जानकारी के लिए प्राइसिंग देखें।

बल्क लुकअप कैसे करूं?

/v1/ip/bulk पर IP स्ट्रिंग्स का एक JSON ऐरे 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 एक Model Context Protocol (MCP) server है जो वही lookups JSON-RPC के ज़रिए callable tools के रूप में देता है — IP (सिंगल और bulk), ASN (ranges/whois/relationships के साथ), IP whois, RPKI, company, carrier, hosted domains, unified search, nearby places, country, reverse DNS, user-agent, phone, email, fraud score, language, currency, weather, trademark और patent — ताकि कोई भी MCP-सक्षम client सीधे raw HTTP requests बनाए बिना इन्हें कॉल कर सके। यह REST API जैसी ही X-API-Key और rate-limit नियमों का उपयोग करता है।

डेटा

डेटा कितनी बार अपडेट होता है?

ASN/IP-रेंज डेटासेट रोज़ाना 04:00 UTC पर रिफ्रेश होता है। सिटी-लेवल जियोलोकेशन दो इंडिपेंडेंट सोर्सेज़ को उनके अपने शेड्यूल पर मर्ज करती है — IP2Location महीने में एक बार, MaxMind हर हफ़्ते — इसलिए ASN रिफ्रेश के बीच प्रिसीज़न बेहतर हो सकती है। थ्रेट फ़ीड्स (VPN, Tor, एब्यूज़) हर 6 घंटे में सिंक होती हैं। एज कैश का TTL 5 मिनट है।

आप कौन-से डेटा सोर्स इस्तेमाल करते हैं?

हम कई प्रमुख इंडस्ट्री डेटा प्रोवाइडर्स से जानकारी जुटाते हैं, जो रोज़ाना अपडेट होती है। VPN डिटेक्शन BGP-डिराइव्ड रेंज इंटेलिजेंस इस्तेमाल करता है। Tor नोड डेटा ऑफ़िशियल Tor Project रजिस्ट्री और वेरीफ़ाइड रिले लिस्ट से आता है। एब्यूज़ नेटवर्क्स क्रॉस-कोरोबोरेटेड मल्टी-सोर्स ब्लैकलिस्ट इंटेलिजेंस इस्तेमाल करते हैं।

थ्रेट इंटेलिजेंस कितनी सटीक है?

बड़े प्रोवाइडर्स और सभी कन्फ़र्म्ड एग्ज़िट नोड्स के लिए VPN और Tor डिटेक्शन की रीकॉल ज़्यादा है। जेनेरिक होस्टिंग ASNs से 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 तक) अनलॉक करती है — Free पर बल्क बिल्कुल उपलब्ध नहीं है। Enterprise (असीमित रिक्वेस्ट) में एक कस्टम SLA और डेडिकेटेड सपोर्ट जुड़ जाता है। सिटी/पिन कोड/lat-lon प्रिसीज़न हर टियर में शामिल है, Free सहित। POST /v1/keys एक Free-टियर की जारी करती है (1,000 रिक्वेस्ट/दिन, GET /v1/keys/usage?key=X के ज़रिए यूसेज ट्रैकिंग) — अपग्रेड के लिए प्राइसिंग देखें।

क्या सिटी-लेवल जियोलोकेशन किसी भी 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 भाषाओं में किसी भी टेक्स्ट की भाषा पहचानता है। कोई टेक्स्ट किसी थर्ड-पार्टी वेंडर या 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 को प्रॉक्सी करता है। केस-स्टेटस टेक्स्ट एक U.S. गवर्नमेंट वर्क और पब्लिक डोमेन है, इसलिए हर रिस्पॉन्स पर एक 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= फ़ॉर्म) RIPEstat के ज़रिए लाइव रूट-ओरिजिन वैलिडेशन रिज़ॉल्व करता है, जो पांचों RIRs से ROA डेटा को एग्रीगेट करता है। स्टेटस सिर्फ़ valid, invalid, या unknown हो सकता है — कभी भी किसी और सिग्नल से अंदाज़ा नहीं लगाया जाता। RPKI वैलिडेटर आज़माएं।

IP से कंपनी कैसे काम करता है, और यह WHOIS से कैसे अलग है?

GET /v1/ip/:ip/company, RDAP रजिस्ट्रेंट डेटा को IP के अपने ASN संस्था नाम के साथ मिलाकर एक कैटेगोरिकल कॉन्फिडेंस (high/medium/low/none) में बदल देता है — एक सिंगल "यह किसका है" वाला फ़ैसला। GET /v1/ip/:ip/whois इसकी बजाय अंदरूनी RDAP रिकॉर्ड को ही रिटर्न करता है: नेटवर्क ब्लॉक, अलोकेशन टाइप, रजिस्ट्रेशन डेट्स, और फ़ाइल में मौजूद हर रजिस्ट्रेंट/एडमिन/एब्यूज़ कॉन्टैक्ट, जो क्लासिक WHOIS आउटपुट के ज़्यादा करीब है। IP से कंपनी या IP Whois आज़माएं।

क्या मैं किसी IP के पीछे के मोबाइल कैरियर की पहचान कर सकता हूं?

बेस्ट-एफर्ट, और सिर्फ़ उन IPs के लिए जो पहले से मोबाइल नेटवर्क्स के तौर पर क्लासीफाई हैं। 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 रिकॉर्ड वाले IPs, शेयर्ड होस्टिंग पर मौजूद असंबंधित डोमेन, और वे डोमेन जो कभी CT-लॉग्ड नहीं हुए। होस्टेड डोमेन आज़माएं।

जगहें फ़ीचर क्या है?

GET /v1/places/:ip, IP की मौजूदा सिटी-लेवल लोकेशन को रिवर्स-जियोकोड करता है, फिर नज़दीकी पॉइंट्स ऑफ़ इंटरेस्ट (रेस्टोरेंट, पार्क, स्कूल, ट्रांज़िट), उल्लेखनीय लैंडमार्क्स, जहां सोर्स मौजूद हो वहां लोकल क्राइम डेटा (सिर्फ़ UK और US), और डेस्टिनेशन देने पर एक ऑप्शनल ऑन-डिमांड ड्राइविंग कम्यूट अनुमान रिटर्न करता है। जगहें आज़माएं।

connection_type का क्या मतलब है, और यह is_mobile से कैसे अलग है?

GET /v1/ip/:ip पर connection_type एक सिंगल बेस्ट-एफर्ट लेबल है — mobile, datacenter, या unknown — जो flags ऑब्जेक्ट जैसे ही ASN क्लासिफ़िकेशन से निकाला जाता है। यह डिवाइस-काउंट/NAT-आधारित कनेक्शन डिटेक्शन की जगह लेता है, जो कोई ऐसी चीज़ नहीं है जिसे Cloudflare Worker देख सके (कोई रॉ TCP/IP पैकेट एक्सेस नहीं) — इसलिए इसे नकली तरीके से दिखाने की बजाय, अनक्लासीफ़ाइड ASNs ईमानदारी से unknown रिटर्न करते हैं।

प्रीमियम फोन इंटेलिजेंस (carrier और porting lookup)

क्या मैं किसी फ़ोन नंबर का असली carrier पता कर सकता हूं, सिर्फ़ फ़ॉर्मैट/रीजन नहीं?

हां, हमेशा-फ्री लोकल चेक के ऊपर एक प्रीमियम लेयर के तौर पर। GET /v1/phone/:number अब भी पहले फ्री लोकल validation चलाता है (फ़ॉर्मैट, रीजन, line type — अनचेंज्ड, पिछला सवाल देखें) और, budget मौजूद होने पर, लाइव carrier, original_carrier, is_ported, एक phone_type क्लासिफ़िकेशन, और हमारे रियल-टाइम carrier-lookup प्रोवाइडर से एक locality-level phone_region और country_prefix जोड़ता है। एक पूरा country_name डिस्प्ले नाम टियर की परवाह किए बिना शामिल होता है, और ?lang=/Accept-Language के ज़रिए बिल्कुल वैसे ही लोकलाइज़ होता है जैसे किसी भी दूसरे endpoint का country_name फ़ील्ड — यह देखने के लिए कि असल में कौन सी भाषा लागू हुई, रिस्पॉन्स का lang/lang_source देखें। रिस्पॉन्स का source फ़ील्ड बताता है कि किस टियर ने जवाब दिया: "premium" या "local"।

मुझे कितने फ्री प्रीमियम (carrier/porting) फ़ोन lookups मिलते हैं?

Free टियर पर 100 प्रीमियम lookups प्रति IP प्रति महीना, Pro पर 1,000/महीना प्रति API key, और Enterprise पर 5,000/महीना — देखें pricing। यह मौजूदा फ्री लोकल फ़ोन-lookup budget (Free पर 100/दिन) के अतिरिक्त है, जिसकी अपनी कोई मंथली कैप नहीं है।

महीने के लिए मेरे प्रीमियम फ़ोन lookups ख़त्म हो जाने पर क्या होता है?

कुछ भी नहीं टूटता। GET /v1/phone/:number बाक़ी महीने के लिए फ्री लोकल इंजन पर सहजता से fall back कर जाता है — आपको अब भी फ़ॉर्मैट, रीजन, और line-type डेटा के साथ पूरा 200 रिस्पॉन्स मिलता है, बस लाइव carrier/is_ported फ़ील्ड्स के बिना (जो तब null और source: "local" रिटर्न करते हैं)। कोई एरर नहीं, फ्री टियर इस्तेमाल जारी रखने के लिए कोई साइनअप ज़रूरी नहीं।

रिस्पॉन्स में phone_type और line_type में क्या फ़र्क़ है?

ये दो अलग इंजनों से आने वाले दो स्वतंत्र क्लासिफ़िकेशन हैं, जिन्हें जानबूझकर अलग रखा गया है। line_type हमेशा-फ्री लोकल चेक से आता है (इस चेक का अपना enum, जैसे MOBILE, FIXED_LINE, PREMIUM_RATE)। phone_type तभी दिखता है जब source "premium" हो, और carrier-lookup प्रोवाइडर की अपनी categories इस्तेमाल करता है: mobile, fixed_line, voip, toll_free, premium_rate, shared_cost, personal_number, pager, uan, voicemail, या unknown। अगर आप इसे fraud सिग्नल्स के लिए इस्तेमाल कर रहे हैं तो premium_rate पर ख़ास ध्यान देने लायक़ है — premium-rate नंबर्स (जो सामान्य लाइन से ज़्यादा per-minute रेट पर बिल होते हैं) international revenue-share fraud (IRSF) का एक आम ज़रिया हैं, और यह endpoint सिर्फ़ VoIP फ़्लैग करने के बजाय उस classification को सीधे सामने लाता है।

चेकर इस्तेमाल करते समय क्या मेरा फ़ोन नंबर किसी थर्ड पार्टी को भेजा जाता है?

सिर्फ़ तब जब कोई प्रीमियम lookup वाक़ई चलता है (यानी पिछले सवाल वाला आपका मंथली budget ख़त्म नहीं हुआ है) — फ्री लोकल चेक कभी भी ipto.to के अपने Cloudflare Workers से बाहर नहीं जाता। जब कोई प्रीमियम lookup चलता है, तो नंबर सिर्फ़ उस एक रिक्वेस्ट का जवाब देने के लिए हमारे carrier-lookup प्रोवाइडर को भेजा जाता है; हम प्रोवाइडर की API key को कहीं भी पब्लिकली एक्सेसिबल जगह पर स्टोर नहीं करते, और ipto.to की स्टैंडर्ड लॉगिंग पॉलिसी के अनुसार (देखें About) हम ख़ुद भी query history लॉग नहीं करते।

अकाउंट, limits और प्राइवेसी

मेरी दैनिक limit कब रीसेट होती है?

हर दिन 00:00 UTC पर। limit से ऊपर की request पर HTTP 429 लौटता है, साथ में Retry-After header और retry_after_seconds फ़ील्ड होती है जो बताती है कि रीसेट में ठीक कितना समय बचा है।

API key कैसे मिलेगी?

तुरंत फ्री-टियर key के लिए POST /v1/keys कॉल करें, या साइन इन करें — साइन इन करने पर फ्री टियर में अकाउंट अपने-आप बन जाता है और डैशबोर्ड पर आपकी key और usage दिखता है। Pro और Enterprise में अपग्रेड प्राइसिंग से करें।

API key कैसे भेजूँ?

X-API-Key header में (बेहतर, क्योंकि query strings logs में दिख सकती हैं) या URL पर ?api_key= के रूप में। key वाली requests आपके IP के बजाय उस key के budget में गिनी जाती हैं। किसी key का usage GET /v1/keys/usage?key=X से देखें।

क्या एक request हमेशा एक ही request गिनी जाती है?

ज़्यादातर हाँ। सर्च बार की एक search या एक MCP tool call एक ही request गिनी जाती है, भले ही सर्वर पर वह कई checks में फैल जाए। Bulk calls हर आइटम पर गिनी जाती हैं — POST /v1/ip/bulk का हर IP और bulk phone lookup का हर नंबर अलग गिना जाता है। Nearby places और premium phone lookups के अपने अलग budgets भी हैं, सामान्य budget के ऊपर।

क्या आप मेरे लुकअप किए IPs या queries लॉग करते हैं?

नहीं। ipto आपके लुकअप किए IP addresses लॉग नहीं करता, query history नहीं रखता और प्रोफ़ाइल नहीं बनाता; capacity planning के लिए सिर्फ़ aggregate request counts रखे जाते हैं। होमपेज की search history और star किए गए lookups सिर्फ़ आपके अपने ब्राउज़र में रहते हैं। विवरण प्राइवेसी पेज पर।

क्या मैं ipto को प्रोडक्शन ऐप में इस्तेमाल कर सकता हूँ?

हाँ। API में CORS चालू है, यह /v1/ के तहत versioned है और स्थिर JSON लौटाती है। फ्री टियर व्यक्तिगत और हल्के उपयोग (1,000 requests/दिन) के लिए है; प्रोडक्शन ट्रैफ़िक के लिए Pro key (100,000/दिन) या Enterprise (असीमित, कस्टम SLA के साथ) लें। लाइव स्थिति के लिए प्राइसिंग और स्टेटस पेज देखें।