Häufig gestellte Fragen
Alles zu IP-Geolokalisierung, VPN-Erkennung, ASN-Suchen, Ratenlimits und der Funktionsweise der API.
Erste Schritte
Was ist ipto?
Eine kostenlose IP-Intelligence-API. Schlagen Sie jede IPv4- oder IPv6-Adresse nach und erhalten Sie Land, ASN, ISP, Hosting-Erkennung, VPN-Erkennung, Tor-Exit-Node-Identifikation und eine Bewertung missbräuchlicher Netzwerke. Eine JSON-Antwort. Keine Anmeldung.
Brauche ich einen API-Schlüssel?
Nein. Der kostenlose Tarif braucht weder Schlüssel noch Anmeldung – rufen Sie den Endpunkt einfach auf (Limits werden pro IP-Adresse gezählt). Für Pro- oder Enterprise-Limits senden Sie Ihren Schlüssel im Header
X-API-Key oder als ?api_key=. Einen kostenlosen Schlüssel erhalten Sie sofort über POST /v1/keys.Wie lautet die Basis-URL?
https://ipto.to. Alle Endpunkte liegen unter /v1/. CORS ist auf allen Endpunkten aktiviert.Wie schaue ich meine eigene IP nach?
GET https://ipto.to/v1/ip — kein Parameter nötig. Liefert Ihre IP zusammen mit Stadt, Bundesland/Region, Zeitzone und Breiten-/Längengrad. Oder führen Sie curl ipto.to in einem Terminal aus.Kann ich das über das Terminal nutzen?
Ja.
curl ipto.to erkennt automatisch den curl-User-Agent und liefert kompaktes JSON für Ihre eigene IP, mit Feldern wie Land, Stadt, ASN und aktuellem Wetter. curl ipto.to/8.8.8.8 macht dasselbe für jede beliebige IP (ohne Wetter). Wget und HTTPie funktionieren ebenfalls.IP-Geolokalisierung
Warum zeigt der Standort die falsche Stadt?
IP-Geolokalisierung ordnet IP-Bereiche dem physischen Standort der Netzwerkinfrastruktur zu, nicht dem Endnutzer. ISPs leiten Datenverkehr über regionale Knotenpunkte, die Hunderte von Kilometern entfernt sein können. Die Genauigkeit auf Länderebene ist hoch. Die Präzision auf Stadtebene nimmt bei privaten und mobilen IPs ab.
Warum ist das Land falsch, wenn ich ein VPN nutze?
Bei einer VPN-Verbindung verlässt Ihr Datenverkehr das Netz über die IP-Adresse des VPN-Servers. ipto meldet den Standort dieses Exit-Servers, nicht Ihren physischen Standort. Das Flag
is_vpn ist in diesem Fall true.Wovon hängt die Genauigkeit der Geolokalisierung ab?
Die Datenqualität hängt davon ab, wie genau ISPs und Organisationen ihre IP-Blöcke in WHOIS- und Routing-Registern eintragen. Große Cloud-Anbieter und ISPs führen sehr genaue Einträge. Kleinere oder ältere Zuteilungen können ungenau sein.
Unterstützen Sie IPv6?
Ja. IPv6-Adressen liefern ASN-, Organisations- und IP-Bereichsdaten sowie Standortdaten auf Stadtebene (Stadt, Region, Postleitzahl, Breiten-/Längengrad) aus dem MaxMind-Datensatz, sofern der Bereich abgedeckt ist; Bogon-/private Bereiche werden erkannt. Die einzige Lücke: VPN-, Tor- und Missbrauchs-Flags gibt es vorerst nur für IPv4, da diese Feeds als IPv4-Bereiche veröffentlicht werden – bei IPv6-Adressen lautet der Wert false statt geraten.
Was ist eine Bogon-IP?
Eine Bogon-(unechte)-IP ist jede Adresse, die im öffentlichen Internet nicht als Quelle auftauchen sollte: Loopback (127.x.x.x), private RFC-1918-Bereiche (10.x, 172.16–31.x, 192.168.x), Link-Local (169.254.x), Multicast (224–239.x) und von der IANA reservierte Blöcke. ipto erkennt diese noch vor jeder Datenbankabfrage und liefert
bogon: true mit einer bogon_type-Begründung. Prüfen Sie jede Adresse mit der Bogon-IP-Prüfung.Bedrohungsdaten
Wie erkennen Sie VPNs?
ipto pflegt eine Datenbank bekannter VPN-Server-IP-Bereiche, aufgebaut aus BGP-Routing-Analyse und aktiver Enumeration. Jede IP wird bei der Suche gegen diese Datenbank geprüft. Die Anbieterzuordnung ergibt sich aus der ASN-Inhaberschaft: Ist eine ASN exklusiv auf einen VPN-Betreiber registriert, wird der Anbieter identifiziert. Testen Sie jede IP mit der VPN- & Proxy-Prüfung.
Wie erkennen Sie Tor-Exit-Knoten?
Die Liste der Tor-Exit-Knoten stammt aus der offiziellen Bulk-Exit-Node-Liste des Tor-Projekts unter check.torproject.org. Das ist die maßgebliche Liste der IPs, die derzeit Tor-Exit-Verkehr erzeugen können. Sie wird alle 6 Stunden aktualisiert.
Was bedeutet is_abuser?
Die IP liegt in einem Netzwerkbereich, der von mehreren unabhängigen Bedrohungsdaten-Feeds als Träger missbräuchlicher Infrastruktur markiert wurde: Spam-Quellen, Malware-Command-and-Control-Server, Botnet-Relays oder Mass-Exploitation-Tools. Ein höherer Missbrauchswert bedeutet, dass mehr Feeds unabhängig voneinander übereinstimmen.
Was ist der Unterschied zwischen is_datacenter und is_residential?
is_datacenter bedeutet, dass die IP zu einem Hosting-Anbieter, einer Cloud-Plattform oder einem CDN gehört. is_residential bedeutet, dass die IP als privater Breitbandanschluss eingestuft wird. Die meisten IPs sind keines von beidem — sie gehören zu ISP-Infrastruktur, die weder Hosting noch Privatanschluss ist.Was ist is_proxy?
Markiert bekannte Proxy-Exit-Punkte, die nicht als VPN oder Tor kategorisiert sind. Derzeit beschränkt auf Daten aus der Threat-Feed-Pipeline. Die Abdeckung ist geringer als bei VPN- und Tor-Erkennung.
ASN und Netzwerk
Was ist eine ASN?
Eine Autonome Systemnummer (ASN) ist ein eindeutiger Bezeichner für ein Netzwerk, das seine IP-Routing-Richtlinien im Internet eigenständig verwaltet. Beispiele: Google ist AS15169, Amazon ist AS16509. Jeder IP-Block wird von genau einer ASN angekündigt. Schlagen Sie jede ASN direkt im ASN-Suchwerkzeug nach.
Was bedeutet asn_type?
Die Kategorie der Organisation, die die ASN betreibt. Werte:
hosting (Cloud- oder Server-Hosting), isp (Internetdienstanbieter), business (Unternehmensnetzwerk), education (Universität oder Forschung), government (Regierung), mobile (Mobilfunkanbieter), residential (Privatanschluss).Was bedeutet is_mobile?
Der IP-Block ist auf einen Mobilfunkanbieter registriert. Mobile IPs werden häufig zwischen Nutzern neu zugewiesen und tauchen oft an geografisch anderen Standorten auf als der Hauptsitz des Anbieters.
Kann ich die vollständige Liste der IP-Bereiche einer ASN sehen, nicht nur eine Anzahl?
Ja —
GET /v1/asn/:asn/ranges?limit=&offset= liefert die tatsächlichen Bereiche (jeweils mit Ländercode und Hosting-/Mobile-/Residential-/Bot-/Blacklist-Flags), paginiert mit bis zu 200 pro Anfrage. Die Haupt-Abfrage GET /v1/asn/:asn enthält außerdem ip_range_count und einen rank — den Größenrang der ASN innerhalb ihres Landes nach Anzahl der Bereiche — ganz ohne den Ranges-Endpunkt. Siehe das ASN-Suchwerkzeug.Wie finde ich WHOIS-Registrierungsdaten oder Peering-Beziehungen einer ASN?
GET /v1/asn/:asn/whois liefert den RIR-Registrierungsdatensatz (Name, Status, Land, Registrierungs-/Änderungsdatum, Kontakte) über RDAP. GET /v1/asn/:asn/relationships liefert bekannte Peers, vorgelagerte Provider und nachgelagerte Kunden aus CAIDAs AS-Relationships-Datensatz; GET /v1/asn/:asn/related findet stattdessen andere ASNs, die wahrscheinlich von derselben Organisation betrieben werden. Alle drei werden gemeinsam auf der ASN-Suchseite angezeigt.Gibt es ein Verzeichnis des gesamten öffentlichen IPv4-Adressraums, nicht nur einer ASN auf einmal?
Ja — Alle IP-Bereiche (
GET /v1/ip-ranges) ist ein durchsuchbares Verzeichnis aller 256 möglichen /8-Blöcke, das bis auf /16-Ebene und zu den tatsächlich zugewiesenen Bereichen samt zugehöriger ASN führt.API-Nutzung
Wie hoch ist das Anfragelimit?
Der kostenlose Tarif erlaubt 1.000 Anfragen/Tag pro IP-Adresse, ohne Anmeldung oder Schlüssel. Pro-Schlüssel erhalten 100.000/Tag; Enterprise ist unbegrenzt. Eine Überschreitung des Limits liefert HTTP 429. Details siehe Preise.
Wie führe ich eine Massensuche durch?
Senden Sie ein JSON-Array von IP-Strings per POST an
/v1/ip/bulk — bis zu 100 pro Anfrage, nur für Pro/Enterprise (siehe Preise). Die Antwort ist ein nach IP indiziertes Objekt. Parallele Cache-Zugriffe machen dies schneller als sequenzielle Aufrufe. Jede IP zählt gegen Ihr Tageskontingent, genau wie eine Einzelsuche.Wie filtere ich die Antwortfelder?
Fügen Sie
?fields=field1,field2 zu jeder Einzel-IP-Anfrage hinzu. Beispiel: /v1/ip/1.1.1.1?fields=ip,country_code,is_vpn,is_tor. Das Feld ip ist immer enthalten.Welche Ausgabeformate sind verfügbar?
JSON (Standard), CSV, Klartext, XML und YAML. Fügen Sie
?format=csv, ?format=text, ?format=xml oder ?format=yaml zu jeder Einzel-IP-Anfrage hinzu. CSV und Text liefern flache Schlüssel-Wert-Paare; XML und YAML erhalten verschachtelte Objekte wie flags.Gibt es ein SDK?
Noch kein offizielles SDK. Die API ist ein Standard-HTTP-JSON-Endpunkt — jeder HTTP-Client funktioniert. Beispiele für curl, JavaScript, Python, PHP und Go finden Sie in den Dokumenten.
Kann ein KI-Agent (Claude, Cursor usw.) ipto direkt nutzen?
Ja –
https://ipto.to/mcp ist ein Model-Context-Protocol-(MCP)-Server, der dieselben Abfragen als aufrufbare Tools über JSON-RPC bereitstellt – IP (einzeln und Bulk), ASN mit Bereichen/Whois/Beziehungen, IP-Whois, RPKI, Unternehmen, Mobilfunkanbieter, gehostete Domains, einheitliche Suche, Orte in der Nähe, Land, Reverse-DNS, User-Agent, Telefon, E-Mail, Betrugsscore, Sprache, Währung, Wetter, Marken und Patente –, sodass ein MCP-fähiger Client sie direkt aufrufen kann, statt rohe HTTP-Anfragen zu stellen. Es gelten derselbe X-API-Key und dieselben Rate-Limit-Regeln wie bei der REST-API.Daten
Wie oft werden die Daten aktualisiert?
Der ASN-/IP-Bereichsdatensatz wird täglich um 04:00 UTC aktualisiert. Die Geolokalisierung auf Stadtebene führt zwei unabhängige Quellen nach eigenem Zeitplan zusammen — IP2Location monatlich, MaxMind wöchentlich — sodass sich die Präzision zwischen den ASN-Aktualisierungen verbessern kann. Bedrohungs-Feeds (VPN, Tor, Missbrauch) synchronisieren alle 6 Stunden. Die Edge-Cache-TTL beträgt 5 Minuten.
Welche Datenquellen nutzen Sie?
Wir beziehen Informationen von mehreren wichtigen Branchen-Datenanbietern, täglich aktualisiert. Die VPN-Erkennung nutzt aus BGP abgeleitete Bereichsdaten. Tor-Node-Daten stammen aus dem offiziellen Register des Tor-Projekts und verifizierten Relay-Listen. Missbrauchsnetzwerke nutzen feedübergreifend bestätigte Multi-Source-Blacklist-Daten.
Wie genau sind die Bedrohungsdaten?
VPN- und Tor-Erkennung hat eine hohe Trefferquote bei großen Anbietern und allen bestätigten Exit-Knoten. Kleinere oder neuere VPN-Dienste, die IP-Raum von generischen Hosting-ASNs anmieten, werden möglicherweise nicht namentlich identifiziert. Die Missbrauchsbewertung nutzt feedübergreifende Bestätigung — ein Netzwerk benötigt mindestens 3 unabhängige Quellen für die Stufe „Mittel“ und mindestens 8 Quellen für „Kritisch“.
Neue Funktionen
Was bedeuten abuse_score und threat_type?
abuse_score ist ein Schweregrad-Score von 1–10 auf Basis feedübergreifender Bestätigung: wie viele unabhängige Bedrohungsquellen dasselbe Netzwerk markieren. threat_type benennt die Kategorie, die die Markierung ausgelöst hat — tor_exit, vpn oder abuser. risk_tier gruppiert den Score in kritisch (8–10), hoch (5–7) oder mittel (3–4). Testen Sie eine Live-Prüfung mit der IP-Missbrauchsprüfung.Liefert ipto auch Wechselkurse?
Ja. Jede Antwort mit ermitteltem Land enthält
currency_code und exchange_rate_usd — einen täglichen Referenzkurs für 154 Weltwährungen. Für Währungen außerhalb dieser Liste liefert der Kurs null.Welche Locale-Daten sind in einer Antwort enthalten?
Jede Antwort mit Länderdaten enthält
languages (gesprochene Amtssprachen), tld (länderspezifische Top-Level-Domains), capital (Hauptstadt) und borders (ISO-Codes benachbarter Länder) — nützlich zur Lokalisierung von Inhalten oder zum Aufbau länderabhängiger Formulare ohne einen zweiten API-Aufruf.Wie mache ich eine Reverse-DNS-/Hostname-Suche?
GET /v1/ip/:ip/hostname führt einen Live-PTR-Lookup über DNS-over-HTTPS durch und liefert { ip, hostname }. Es ist eine einzelne On-Demand-Suche, keine zwischengespeicherte Domain-Enumerationsdatenbank — hostname ist null, wenn kein PTR-Eintrag existiert. Es gibt auch ein Browser-Werkzeug unter /reverse-dns-lookup.Kann ich die Rohdatensätze herunterladen?
Ja.
GET /v1/datasets/:kind liefert CSV-Exporte für asn, ranges und geo-city — dieselben Datensätze, die die API intern abfragt, aktualisiert nach demselben Zeitplan. geo-city akzeptiert optional ?source=primary (Standard) oder ?source=secondary, da Daten auf Stadtebene aus zwei unabhängigen Quellen mit unterschiedlicher Abdeckung zusammengeführt werden.Was bekomme ich mit einem Pro- oder Enterprise-API-Schlüssel?
Ein Pro-Schlüssel schaltet ein Limit von 100.000 Anfragen/Tag sowie die Massensuche frei (
POST /v1/ip/bulk, bis zu 100 IPs pro Anfrage) — Massensuche ist im kostenlosen Tarif überhaupt nicht verfügbar. Enterprise (unbegrenzte Anfragen) ergänzt ein individuelles SLA und dedizierten Support. Stadt-/PLZ-/Breiten-/Längengrad-Präzision ist in jedem Tarif enthalten, auch im kostenlosen. POST /v1/keys stellt einen Schlüssel im kostenlosen Tarif aus (1.000 Anfragen/Tag, Nutzungsverfolgung über GET /v1/keys/usage?key=X) — ein Upgrade finden Sie unter Preise.Funktioniert die Geolokalisierung auf Stadtebene für jede IP oder nur für meine eigene?
Beides, sofern
geo_precision es zulässt. Ihre eigene IP (GET /v1/ip) erhält immer Daten auf Stadtebene vom Edge-Netzwerk, über das Sie verbunden sind. Explizite IP-Suchen (GET /v1/ip/:ip) erhalten Daten auf Stadtebene, wenn diese IP innerhalb der Abdeckung des Stadtebene-Datensatzes liegt; andernfalls sinkt geo_precision auf country, und Stadt/Bundesland/Breiten-/Längengrad liefern null.Wie erhalte ich die Antwort in einer anderen Sprache?
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.Über IP hinaus: Identität, Betrug und Referenzdaten
Validiert ipto E-Mail-Adressen?
Ja —
GET /v1/email/:email prüft Syntax, einen Live-MX-Eintrag-Lookup und die Erkennung von Wegwerf-/Temporär-Domains gegen eine synchronisierte Sperrliste. Kostenlos, ohne Anmeldung. Testen Sie die E-Mail-Prüfung.Validiert ipto Telefonnummern?
Ja —
GET /v1/phone/:number analysiert jede Nummer im E.164- oder nationalen Format auf Gültigkeit, Land, Region und Anschlussart (Mobil, Festnetz oder VoIP) gegen einen synchronisierten MCC/MNC-Anbieterdatensatz. Testen Sie die Telefonnummer-Prüfung.Was ist die Betrugsscore-Prüfung?
GET /v1/fraud-score kombiniert IP-Bedrohungssignale, E-Mail-Zustellbarkeit, Telefongültigkeit und Bot-Erkennung per User-Agent zu einem einzigen fusionierten Risikoscore von 0–100 — das eine Merkmal, das keine der großen eigenständigen IP-Intelligence-APIs bietet. Alle vier Eingaben sind optional; ein nicht übergebenes Signal fehlt einfach, statt als sauber bewertet zu werden. Testen Sie die Betrugsscore-Prüfung.Erkennt ipto die Sprache eines Textes?
Ja —
GET /v1/language erkennt die Sprache jedes Textes aus 76 Sprachen mittels lokaler Trigramm-Häufigkeitsanalyse. Kein Text wird an einen Drittanbieter oder ein KI-Modell gesendet, und nichts wird protokolliert. Testen Sie die Spracherkennung.Gibt es einen eigenständigen Endpunkt zur Währungsumrechnung?
Ja —
GET /v1/currency/convert und GET /v1/currency/rates stellen denselben täglichen Wechselkurs-Feed bereit, der bereits exchange_rate_usd bei jeder IP-/Länder-Suche versorgt, mit Abdeckung für 154 Währungen, plus GET /v1/currency/history für 90 Tage historische Kurse. Testen Sie den Währungsrechner.Liefert ipto Wetterdaten?
Ja —
GET /v1/weather liefert aktuelle Bedingungen für jeden Ortsnamen, jede Postleitzahl oder jedes Koordinatenpaar; fügen Sie &detail=1 für einen stündlichen Ausblick und eine 3-Tage-Vorhersage hinzu. Sowohl das Wetter-Widget der Startseite für die eigene IP als auch das Werkzeug Wetterabfrage nutzen diesen Endpunkt.Sucht ipto nach Marken?
Ja —
GET /v1/trademark/:serial leitet an die TSDR-API der USPTO weiter, für den Live-Fallstatus anhand der 8-stelligen Seriennummer. Der Fallstatus-Text ist ein Werk der US-Regierung und gemeinfrei, daher trägt jede Antwort ein Feld source/attribution; Marken-Logo-/Bilddaten sind bewusst außerhalb des Umfangs. Die Suche über die Registrierungsnummer wird nicht unterstützt — die USPTO dokumentiert derzeit nur den Pfad über die Seriennummer. Testen Sie das Werkzeug Markenrecherche.Sucht ipto nach Patenten?
Ja —
GET /v1/patent/:number leitet an die Live-API des Patent File Wrapper der USPTO weiter, für den Erteilungsstatus anhand der 7- bis 8-stelligen Gebrauchspatentnummer. Die Abdeckung beginnt bei 2001 eingereichten Anmeldungen, und die Daten sind Prosecution-/bibliografische Daten (Anmeldedatum, Status, Erfinder, zuständiger Anwalt) — kein Zitationsgraph, keine Patentfamilie und kein Rechtsstatus-Feld, wie sie Lens.org, Espacenet oder Google Patents zeigen. Design-, Pflanzen- und Reissue-Patente werden noch nicht unterstützt. Testen Sie das Werkzeug Patentrecherche.Inhaberschaft, Routing & Orte
Was ruft die Suchleiste eigentlich auf?
Eine einzelne Anfrage —
GET /v1/search/:query. Sie erkennt, ob Sie eine IP, ASN, einen Ländercode, eine E-Mail-Adresse oder eine Telefonnummer eingegeben haben, und fächert serverseitig parallel zu jeder relevanten Prüfung auf (IP-Suche, RPKI, Unternehmen, Whois, Mobilfunkanbieter, gehostete Domains, Orte). Eine Suche zieht nur eine Anfrage von Ihrem Tageskontingent ab, nicht eine pro Funktion.Validiert ipto RPKI / Route-Origin-Autorisierung?
Ja —
GET /v1/ip/:ip/rpki (und die explizite Form GET /v1/rpki?asn=&prefix=) löst die Route-Origin-Validierung live über RIPEstat auf, das ROA-Daten aller fünf RIRs zusammenführt. Der Status ist ausschließlich valid, invalid oder unknown — niemals aus einem anderen Signal abgeleitet. Testen Sie den RPKI-Validator.Wie funktioniert IP-zu-Unternehmen, und wie unterscheidet es sich von WHOIS?
GET /v1/ip/:ip/company kombiniert RDAP-Registrantendaten mit dem eigenen ASN-Organisationsnamen der IP zu einer kategorialen Konfidenz (hoch/mittel/niedrig/keine) — einem einzigen „Wem gehört das“-Urteil. GET /v1/ip/:ip/whois liefert stattdessen den zugrunde liegenden RDAP-Eintrag selbst: den Netzwerkblock, den Zuteilungstyp, die Registrierungsdaten sowie jeden hinterlegten Registrant-, Admin- und Abuse-Kontakt, näher an der klassischen WHOIS-Ausgabe. Testen Sie IP zu Unternehmen oder IP-Whois.Kann ich den Mobilfunkanbieter hinter einer IP identifizieren?
Bestmöglich, und nur für IPs, die bereits als Mobilfunknetze klassifiziert sind.
GET /v1/ip/:ip/carrier gleicht den Organisationsnamen der ASN unscharf mit einem auf das Land der IP eingegrenzten MCC/MNC-Betreiberverzeichnis ab. Es gibt bewusst kein einzelnes Feld carrier: "X" — ein bloßer Name würde wie eine Live-Aussage pro Teilnehmer wirken, die die Daten ehrlicherweise nicht stützen können. Testen Sie das Werkzeug IP zu Mobilfunkanbieter.Kann ich herausfinden, welche Domains auf einer IP gehostet werden?
GET /v1/ip/:ip/hosted-domains findet Domains über den Reverse-DNS-Hostnamen der IP sowie Certificate-Transparency-Protokolle (crt.sh) — es ist keine allgemeine Reverse-IP-Suche. Das Feld limitations in der Antwort selbst nennt genau, was strukturell nicht erfasst werden kann: IPs ohne PTR-Eintrag, unabhängige Domains auf geteiltem Hosting und Domains, die nie CT-geloggt wurden. Testen Sie Gehostete Domains.Was ist die Orte-Funktion?
GET /v1/places/:ip führt ein Reverse-Geocoding des bestehenden Stadtebene-Standorts einer IP durch und liefert dann nahegelegene Sehenswürdigkeiten (Restaurants, Parks, Schulen, Verkehrsmittel), bekannte Wahrzeichen, lokale Kriminalitätsdaten, sofern eine Quelle existiert (nur UK und USA), sowie eine optionale, bei Bedarf abrufbare Schätzung der Fahrzeit, wenn Sie ein Ziel angeben. Testen Sie Orte.Was bedeutet connection_type, und wie unterscheidet es sich von is_mobile?
connection_type bei GET /v1/ip/:ip ist ein einzelnes Bestmöglichkeits-Label — mobile, datacenter oder unknown — abgeleitet aus derselben ASN-Klassifikation wie das Objekt flags. Es ersetzt eine geräteanzahl-/NAT-basierte Verbindungserkennung, die ein Cloudflare Worker nicht beobachten kann (kein Zugriff auf rohe TCP/IP-Pakete) — statt das vorzutäuschen, liefern unklassifizierte ASNs ehrlich unknown.Premium-Telefonanalyse (Anbieter- & Portierungsabfrage)
Kann ich den tatsächlichen Anbieter einer Telefonnummer nachschlagen, nicht nur Format/Region?
Ja, als Premium-Schicht über der stets kostenlosen lokalen Prüfung.
GET /v1/phone/:number führt weiterhin zuerst die kostenlose lokale Validierung aus (Format, Region, Anschlussart — unverändert, siehe vorherige Frage) und fügt, sofern Budget verfügbar ist, live carrier, original_carrier, is_ported, eine phone_type-Klassifizierung sowie eine ortsbezogene phone_region und country_prefix von unserem Echtzeit-Anbieterabfrage-Dienst hinzu. Ein vollständiger Anzeigename country_name ist unabhängig von der Stufe immer enthalten und wird genau wie das country_name-Feld jedes anderen Endpunkts über ?lang=/Accept-Language lokalisiert — anhand von lang/lang_source in der Antwort sehen Sie, welche Sprache tatsächlich verwendet wurde. Das Feld source der Antwort zeigt an, welche Stufe geantwortet hat: "premium" oder "local".Wie viele kostenlose Premium-Abfragen (Anbieter/Portierung) erhalte ich?
100 Premium-Abfragen pro IP-Adresse und Monat im Free-Tarif, 1.000/Monat pro API-Schlüssel bei Pro und 5.000/Monat bei Enterprise — siehe Preise. Dies ist zusätzlich zum bestehenden kostenlosen lokalen Telefonabfrage-Budget (100/Tag im Free-Tarif), das kein eigenes monatliches Limit hat.
Was passiert, wenn ich meine Premium-Telefonabfragen für den Monat aufgebraucht habe?
Nichts geht kaputt.
GET /v1/phone/:number fällt für den Rest des Monats nahtlos auf die kostenlose lokale Engine zurück — Sie erhalten weiterhin eine vollständige 200-Antwort mit Format-, Regions- und Anschlussart-Daten, nur ohne die Live-Felder carrier/is_ported (die dann null und source: "local" zurückgeben). Keine Fehler, keine Anmeldung erforderlich, um den kostenlosen Tarif weiter zu nutzen.Was ist der Unterschied zwischen phone_type und line_type in der Antwort?
Das sind zwei unabhängige Klassifizierungen aus zwei verschiedenen Engines, die absichtlich getrennt gehalten werden.
line_type stammt aus der stets kostenlosen lokalen Prüfung (das eigene Enum dieser Prüfung, z. B. MOBILE, FIXED_LINE, PREMIUM_RATE). phone_type erscheint nur, wenn source "premium" ist, und verwendet die eigenen Kategorien des Anbieterabfrage-Dienstes: mobile, fixed_line, voip, toll_free, premium_rate, shared_cost, personal_number, pager, uan, voicemail oder unknown. premium_rate lohnt sich besonders zu beobachten, wenn Sie dies für Betrugssignale nutzen — Mehrwertnummern (die zu einem höheren Preis pro Minute abgerechnet werden als eine normale Leitung) sind ein gängiger Vektor für internationalen Einnahmenbetrug (International Revenue Share Fraud, IRSF), und dieser Endpunkt macht diese Klassifizierung direkt sichtbar, statt nur VoIP zu kennzeichnen.Wird meine Telefonnummer an Dritte gesendet, wenn ich den Checker nutze?
Nur wenn tatsächlich eine Premium-Abfrage ausgeführt wird (d. h. Ihr monatliches Budget aus der vorherigen Frage ist nicht aufgebraucht) — die kostenlose lokale Prüfung verlässt niemals die eigenen Cloudflare Workers von ipto.to. Wenn eine Premium-Abfrage ausgeführt wird, wird die Nummer ausschließlich zur Beantwortung dieser einen Anfrage an unseren Anbieterabfrage-Dienst gesendet; wir speichern dessen API-Schlüssel nirgendwo öffentlich erreichbar, und gemäß der Standard-Protokollierungsrichtlinie von ipto.to (siehe Über uns) protokollieren wir auch selbst keinen Abfrageverlauf.
Konto, Limits & Datenschutz
Wann wird mein Tageslimit zurückgesetzt?
Jeden Tag um 00:00 UTC. Eine Anfrage über dem Limit liefert HTTP 429 mit einem
Retry-After-Header und einem Feld retry_after_seconds, das genau angibt, wie lange es bis zum Zurücksetzen dauert.Wie bekomme ich einen API-Schlüssel?
Rufen Sie
POST /v1/keys für einen sofortigen Schlüssel im kostenlosen Tarif auf oder melden Sie sich an – die Anmeldung legt automatisch ein Konto im kostenlosen Tarif an und zeigt Schlüssel und Nutzung im Dashboard. Pro und Enterprise buchen Sie über Preise.Wie sende ich meinen API-Schlüssel mit?
Im Header
X-API-Key (empfohlen, da Query-Strings in Logs landen können) oder als ?api_key= in der URL. Anfragen mit Schlüssel werden auf das Budget dieses Schlüssels statt auf das Ihrer IP angerechnet. Die Nutzung prüfen Sie mit GET /v1/keys/usage?key=X.Zählt eine Anfrage immer als eine Anfrage?
Meistens. Eine Suche über die Suchleiste oder ein MCP-Tool-Aufruf zählt als eine Anfrage, auch wenn serverseitig mehrere Prüfungen laufen. Bulk-Aufrufe werden pro Element berechnet – jede IP in
POST /v1/ip/bulk und jede Nummer in einer Bulk-Telefonabfrage zählt einzeln. „In der Nähe“ (Orte) und Premium-Telefonabfragen haben zusätzlich eigene Budgets.Protokollieren Sie die IPs oder Abfragen, die ich nachschlage?
Nein. ipto protokolliert weder die nachgeschlagenen IP-Adressen noch speichert es einen Abfrageverlauf oder erstellt Profile; für die Kapazitätsplanung werden nur aggregierte Anfragezahlen erfasst. Ihr Suchverlauf und markierte Abfragen auf der Startseite bleiben ausschließlich in Ihrem Browser. Details auf der Datenschutzseite.
Kann ich ipto in einer Produktions-App einsetzen?
Ja. Die API ist CORS-fähig, unter
/v1/ versioniert und liefert stabiles JSON. Der kostenlose Tarif ist für Privatpersonen und leichte Nutzung gedacht (1.000 Anfragen/Tag); für Produktionslast nutzen Sie einen Pro-Schlüssel (100.000/Tag) oder Enterprise (unbegrenzt, mit individuellem SLA). Siehe Preise und die Statusseite für den aktuellen Zustand.