API-Referenz

Gibt nichts als die eigene öffentliche IP-Adresse des anfragenden Clients als reinen Text zurück (Content-Type: text/plain) — z. B. 73.9.114.155. Direktes Äquivalent zu ipinfo.io/ip: funktioniert identisch über curl, Wget, HTTPie oder einen einfachen Browser-Aufruf (keine User-Agent-Erkennung, anders als beim curl ipto.to-Shortcut oben), und zeigt im Browser geöffnet nur die reine IP ohne Seiten-Chrome an.

Keine Parameter, kein Query-String. Für das vollständige Geolokalisierungs-/Threat-Intelligence-Objekt verwenden Sie stattdessen GET /v1/ip unten. Diese Route liest die verbindende IP direkt aus (kein D1-/KV-Lookup) und wird nicht auf das tägliche Anfragebudget angerechnet — siehe Ratenlimits.

Liefert Geolokalisierung und Threat Intelligence für die anfragende IP, einschließlich Daten auf Stadtebene über das CF-Edge-Objekt.

Keine erforderlichen Parameter. Akzeptiert ?lang=, ?fields=, ?format= — siehe Lokalisierung und Ausgabeformate unten.

Beliebige IPv4-Adresse nachschlagen. Felder auf Stadtebene (city, state, postal_code, latitude, longitude, timezone) werden befüllt, wenn die IP in einem von zwei zusammengeführten Geo-Datensätzen liegt, IP2Location oder MaxMind — prüfen Sie geo_precision in der Antwort, um zu sehen, ob Sie Daten auf Stadt- oder Länderebene erhalten haben. Das Format von timezone hängt davon ab, welche Quelle den Treffer geliefert hat (ein UTC-Offset-String von IP2Location, ein IANA-Name von MaxMind). IPv6-Abfragen liefern derzeit nur Daten auf Länderebene.

Der einheitliche Such-Endpunkt hinter der Suchleiste auf der Startseite. Erkennt, ob :query eine IP, eine ASN (AS15169 oder 15169), ein zweistelliger Ländercode, eine E-Mail-Adresse oder eine Telefonnummer ist, und fasst dann alle relevanten Prüfungen in einer Antwort zusammen. Bei einer IP-Abfrage wird dies serverseitig parallel auf die primäre IP-Abfrage plus RPKI, IP-zu-Unternehmen, Mobilfunkanbieter, Hosted-Domains und Orte aufgefächert, sodass eine einzelne Suche nur eine Anfrage gegen Ihr tägliches Ratenlimit-Budget zählt statt eine pro Funktion.

Jedes Teilfeld degradiert unabhängig — ein langsamer oder fehlgeschlagener Upstream (RIPEstat, ein RDAP-Server, crt.sh) äußert sich darin, dass genau dieses Feld null ist, niemals darin, dass die gesamte Suche fehlschlägt. Nur eine ungültige primäre Abfrage (z. B. eine fehlerhafte IP) liefert einen Fehlerstatus für die gesamte Anfrage.

Reverse-DNS — eine einzelne Live-PTR-Abfrage über DNS-over-HTTPS, keine Domain-Enumerationsdatenbank. Gibt null zurück, wenn die IP keinen PTR-Eintrag hat.

RPKI-Route-Origin-Validierung für die aktuell angekündigte Route einer IP, live über RIPEstat aufgelöst (keine ROA-Datenbank wird lokal eingelesen oder synchron gehalten). status ist ausschließlich "valid", "invalid" oder "unknown" — niemals aus einem anderen Signal abgeleitet; jeder RIPEstat-Fehler oder Timeout liefert "unknown" mit einem Grund-String, keinen Fehler.

Explizite (ASN, Präfix) RPKI-Validierung — für den Fall, dass Sie bereits die genaue zu prüfende Route kennen, statt der oben beschriebenen, aus der IP abgeleiteten Komfortvariante.

Identifiziert die Organisation, auf die eine IP registriert ist, indem RDAP-Registrant-Daten (strukturiertes WHOIS) mit dem eigenen Organisationsnamen der ASN zu einer kategorialen Confidence kombiniert werden — nie ein numerischer Score.

Der zugrunde liegende RDAP-Registrierungsdatensatz selbst — Netzblock, Registrierungs-/letztes-Änderungsdatum und jeder bei RDAP hinterlegte Kontakt. Zu unterscheiden von /company oben, das dieselben Registrant-Daten mit dem Organisationsnamen der ASN zu einer Confidence-bewerteten Antwort abgleicht; dieser Endpunkt liefert den Rohdatensatz unverändert, näher an klassischer WHOIS-Ausgabe. IPv6-Adressen werden ebenfalls unterstützt.

Bestmögliche Identifikation des Mobilfunkanbieters für als Mobilfunknetze klassifizierte IPs, abgeglichen mit einem MCC/MNC-Betreiberverzeichnis. Es gibt bewusst kein einzelnes carrier-Feld — siehe matched_carrier_entries und note unten —, da ein einzelner Anbietername als Live-Aussage pro Teilnehmer gelesen würde, was diese Daten ehrlicherweise nicht belegen können.

Findet Domains, die mit einer IP über ihren Reverse-DNS-(PTR)-Hostnamen und Certificate-Transparency-Logs (crt.sh) verknüpft sind — keine allgemeine Reverse-IP-Abfrage. Das eigene limitations-Feld der Antwort erläutert genau, was hiermit gefunden werden kann und was nicht.

Batch-Abfrage — bis zu 100 IPs pro Anfrage, nur Pro/Enterprise. Liefert ein Objekt mit jeder IP als Schlüssel. Schneller als sequenzielle Aufrufe dank paralleler Cache- und Datenbankzugriffe. Jede IP im Batch zählt gegen Ihr tägliches Anfragebudget, genau wie eine einzelne Abfrage. Anfragen im kostenlosen Tarif erhalten einen 403 — siehe Preise.

Ein autonomes System anhand seiner Nummer nachschlagen. Liefert den Organisationsnamen, Land, Kontinent, Anzahl der IP-Bereiche, Klassifizierungstyp, Wechselkurs und Locale-Referenzdaten (Sprachen, TLD, Hauptstadt, Nachbarländer).

Führt ein Reverse-Geocoding des vorhandenen Standorts einer IP auf Stadtebene durch und liefert dann nahegelegene Points of Interest (Restaurants, Parks, Schulen, Verkehrsmittel, bekannte Sehenswürdigkeiten), lokale Kriminalitätsdaten, sofern eine Quelle existiert (nur Großbritannien und USA), sowie eine optionale, auf Anfrage berechnete Pendel-Schätzung mit dem Auto.

Aggregierte Statistiken auf Länderebene plus Locale-Referenzdaten (Währung, Wechselkurs, Sprachen, TLD, Hauptstadt, Nachbarländer).

Analysiert einen User-Agent-String. Liefert Browser, Betriebssystem, Gerätetyp und Bot-Erkennung. Liest standardmäßig den User-Agent-Header des Aufrufers, oder übergeben Sie einen beliebigen String über ?ua=.

Validiert und formatiert eine Telefonnummer stets kostenlos: Region, Anschlussart sowie E.164-/nationale/internationale Formatierung über einen selbst gehosteten Parser, kein Anbieteraufruf. Wenn ein monatliches Premium-Budget pro IP/Schlüssel verfügbar ist (100/Monat im Free-Tarif, mehr in bezahlten Tarifen — siehe Preise), liefert dieselbe Anfrage zusätzlich einen aktuellen Anbieternamen, den Portierungsstatus und eine anbieterklassifizierte Telefonart von einem Echtzeit-Anbieterabfrage-Dienst — siehe source und die Felder unten. Ein lokalisierter country_name sowie lang/lang_source sind unabhängig von der Stufe immer enthalten — siehe Lokalisierung. Ist das Premium-Budget aufgebraucht oder liegt ein Problem beim Dienst vor, fällt die Anfrage nahtlos auf die kostenlosen Felder oben zurück; sie schlägt dadurch nie fehl. Für eine länderweite Netzbetreiber-Referenz statt einer Abfrage pro Nummer siehe stattdessen GET /v1/carriers.

Batch-Validierung. Jeder Tarif erhält Bulk-Zugriff (anders als /v1/ip/bulk) — die Obergrenze pro Tarif hält den kostenlosen Tarif in Grenzen, nicht ein 403. Free: 10/Anfrage, 100/Tag. Pro: 100/Anfrage, 1.000/Tag. Enterprise: 1.000/Anfrage, 10.000/Tag. Dieses Budget ist getrennt von Ihrem allgemeinen täglichen Anfragelimit — siehe Ratenlimits.

Referenzabfrage: welche Mobilfunknetzbetreiber (MCC/MNC) für ein bestimmtes Land bekannt sind — nicht an eine konkrete Telefonnummer gebunden. Stammt aus einer community-gepflegten MCC/MNC-Zusammenstellung (MIT-lizenziert, zuletzt 2026 synchronisiert — Details siehe docs-Repo); eine statische Referenztabelle, kein Live-Feed, da sich Nummerierungsplan-Zuweisungen nicht oft genug ändern, um einen solchen zu rechtfertigen.

Validierung der E-Mail-Syntax, eine Live-Prüfung des MX-Eintrags über DNS-over-HTTPS sowie die Erkennung von Wegwerf-/temporären Domains anhand einer community-gepflegten Blockliste (CC0-lizenziert, täglich synchronisiert). Prüft nicht, ob das Postfach selbst existiert — das würde einen SMTP-Handshake erfordern, den diese API nicht durchführt (siehe die Feldreferenz unten für genau das, was has_mx beweist und was nicht).

Kombiniert je nachdem, welche von IP, E-Mail, Telefon und User-Agent Sie angeben, zu einem einzigen Score von 0–100 — das eine, was weder ip-api.com, ipapi.co, ipgeolocation.io, ipify.org, ipregistry.co, ip2location.io, AbstractAPI, IPLocate.io noch BigDataCloud als ein einziges fusioniertes Signal anbieten (direkt geprüft). Alle vier Eingaben sind optional und unabhängig — übergeben Sie eine beliebige Teilmenge. ip verwendet standardmäßig Ihre eigene IP und ua Ihren eigenen User-Agent-Header, falls weggelassen, dieselbe Konvention wie bei GET /v1/ip und GET /v1/ua. Ein Signal, das Sie nicht übergeben, fehlt schlicht in der Antwort und wird nicht als unauffällig bewertet — sein Gewicht wird auf die von Ihnen tatsächlich angegebenen Signale umverteilt.

Rendert eine URL in einer echten Headless-Chrome-Instanz (Cloudflare Browser Rendering, kein Screenshot-Anbieter eines Drittanbieters) und liefert ein PNG zurück. Interne/private Ziele (localhost, RFC-1918-Bereiche, Link-Local-/Cloud-Metadata-Adressen) werden abgelehnt, bevor der Browser überhaupt gestartet wird. Unterliegt den eigenen Plattform-Limits von Browser Rendering, die deutlich enger sind als beim Rest dieser API — rechnen Sie damit, dass hier auf niedrigeren Cloudflare-Plänen bereits weit vor Ihrem regulären täglichen Anfragebudget gedrosselt wird.

Identifiziert die Sprache eines Textausschnitts über eine lokale Trigramm-Häufigkeitsanalyse — kein externer Anbieteraufruf, keine KI-Modell-Inferenz, kein Logging. Eingaben unter 10 Zeichen liefern language als null zurück; unter ca. 30 Zeichen kann noch eine beste Schätzung geliefert werden, aber reliable ist dann false.

Rechnet einen Betrag zwischen zwei Währungen um (154 unterstützt), unter Verwendung desselben täglichen Referenzkurs-Feeds, der bereits currency_code/exchange_rate_usd bei jeder IP-, ASN- und Länderabfrage speist — hier als eigenständiger Umrechnungs-Endpunkt bereitgestellt, statt in eine Geolokalisierungsantwort eingebettet.

Vollständige Wechselkurstabelle (154 Währungen), neu berechnet auf Basis einer beliebigen unterstützten Währung, nicht nur USD.

Tägliche Referenzkurs-Historie für ein Währungspaar, bis zu 90 Tage zurück — die Daten hinter dem Kursverlaufsdiagramm im Währungsrechner-Tool. Einmalig rückwirkend befüllt, danach täglich durch denselben Cronjob ergänzt, der auch GET /v1/currency/convert aktualisiert. Dies ist ein einzelner täglicher Referenzkurs über die Zeit, kein Geld-/Brief-Handelsspread.

Aktuelle Bedingungen — und mit detail=1 zusätzlich eine stündliche Vorschau und eine mehrtägige Vorhersage — für einen Ortsnamen, eine Postleitzahl oder ein "lat,lon"-Paar oder für lat + lon bzw. eine ip. Orte in den USA beantwortet der National Weather Service, alle anderen MET Norway. Fügen Sie include= hinzu, um das vollständige Dokument mit Einheiten, bis zu 9 Tagen, Sonne und Mond, amtlichen Warnungen und mehr zu erhalten — siehe die include-Karte weiter unten. Das Weather-Lookup-Tool erkennt zudem den eigenen Standort des Aufrufers clientseitig, bevor es diesen Endpunkt explizit aufruft.

Live-Proxy zum Trademark Status & Document Retrieval (TSDR)-System des USPTO für den Fallstatus anhand einer 8-stelligen Seriennummer — ein direkter Aufruf pro Anfrage, keine zwischengespeicherte oder weiterverkaufte Kopie. Fallstatus-Daten sind ein Werk der US-Regierung und laut den eigenen Nutzungsbedingungen des USPTO gemeinfrei, daher trägt jede Antwort ein source-/attribution-Feld, statt sie stillschweigend zu cachen oder weiterzuverkaufen. Marken-Logo-/Bilddaten sind bewusst nicht enthalten — die Nutzungsbedingungen des USPTO grenzen die Bildlizenzierung getrennt von den Fallstatus-Textdaten ab, die dieser Endpunkt liefert. Die Suche per Registrierungsnummer wird noch nicht unterstützt; derzeit dokumentiert das USPTO nur den Weg über die Seriennummer. Probieren Sie es im Trademark-Lookup-Tool aus.

Live-Proxy zur Patent File Wrapper API (Open Data Portal) des USPTO für den Erteilungsstatus anhand einer 7- bis 8-stelligen Gebrauchspatentnummer — ein direkter Aufruf pro Anfrage, keine zwischengespeicherte oder weiterverkaufte Kopie. Die ursprünglich vorgesehene Quelle (die Search API von PatentsView) wurde nachweislich am 2026-03-20 abgeschaltet; dieser Endpunkt ist stattdessen ein Proxy zu deren aktivem Nachfolger. Patent-File-Wrapper-Daten sind ein Werk der US-Regierung und laut den eigenen Nutzungsbedingungen des USPTO gemeinfrei, daher trägt jede Antwort ein source-/attribution-Feld. Der Umfang ist anmelde-/verfahrenszentriert — kein Zitationsgraph, keine Patentfamilie, kein Rechtsstatus-Feld und keine Bilder, wie sie Lens.org, Espacenet oder Google Patents zeigen. Die Abdeckung beginnt bei Anmeldungen aus dem Jahr 2001. Geschmacksmuster-, Pflanzen- und Reissue-Patente werden noch nicht unterstützt; nur Gebrauchspatente anhand der erteilten Patentnummer. Probieren Sie es im Patent-Lookup-Tool aus.

Paginierter VPN-, Tor- und Threat-Intelligence-Feed. 200 Einträge pro Seite. Jeder Eintrag enthält IP/CIDR, Anbieterzuordnung, ISP, Land und Klassifizierungstyp.

Nur Metadaten — Gesamtzahl der Einträge, Anzahl je Quelle und letzter Synchronisierungszeitpunkt. Liefert keine IP-Daten.

Paginierte missbräuchliche Netzwerkbereiche. Bewertet von 1-10 anhand feedübergreifender Bestätigung. Risikostufen: critical (8-10), high (5-7), medium (3-4).

Nur Metadaten — Gesamtzahl der Netzwerke, Anzahl je Quelle, Aufschlüsselung nach Risikostufe und letzter Synchronisierungszeitpunkt.

Herunterladbarer CSV-Export der offenen Datensätze, auf denen die API bereits aufbaut — dieselben Daten, keine neue Lizenz. asn und ranges sind immer verfügbar; geo-city liefert 503, bis der Datensatz dieser Quelle auf einem gegebenen Deployment aktiv ist. geo-city exportiert jeweils die Rohdaten einer Geo-Quelle, keine zusammengeführte Ansicht — geben Sie ?source=primary (Standard) oder ?source=secondary an.

Stellt sofort einen API-Schlüssel aus — keine E-Mail, keine Anmeldung. Jeder Schlüssel startet im kostenlosen Tarif (1.000 Anfragen/Tag; Massensuche nicht enthalten). Pro- und Enterprise-Schlüssel schalten höhere Tageslimits und Massensuche frei (bis zu 100 IPs/Anfrage) — siehe Preise. Speichern Sie den Schlüssel — er kann später nicht wieder abgerufen werden.

Prüfen Sie, wie viele Anfragen ein Schlüssel gemacht hat. Übergeben Sie den Schlüssel bei jeder /v1/*-Anfrage über den X-API-Key-Header oder ?api_key=, damit sie gezählt wird.

Abuse-Meldekontakt des Netzes, dem eine IP gehört, aus RDAP: das RIR, das Netzwerk-Handle, das umfassende CIDR und die Abuse-Mailbox(en). Zeigt, wohin eine Meldung geschickt werden soll.

available ist false (mit einem Grund in failure), wenn die Registry nicht erreichbar war.

Die tatsächlich von einem ASN angekündigten IP-Bereiche, seitenweise, jeweils mit Land und den Flags Hosting / Mobil / Privatkunden / Bot / Sperrliste.

Registry-Eintrag (RDAP) eines ASN: Handle, Name, Land, Zuteilungsart, Registrierungsdaten, das RIR und seine Kontakte.

available ist false mit einem reason, wenn die Registry nicht erreichbar ist.

Andere ASNs, die wahrscheinlich zu diesem gehören: zuerst dieselbe registrierte Organisation, dann dasselbe Land und derselbe Typ.

Wo ein ASN tatsächlich sitzt: Punkte auf Stadtebene, geolokalisiert aus einer Stichprobe seiner größten Bereiche, plus die häufigsten Städte. Speist die Verteilungskarte auf der ASN-Seite.

Eine Stichprobe, nicht die vollständige Bereichsliste. Für alle Bereiche /v1/asn/:asn/ranges verwenden.

In einem ASN gehostete Domains, per Reverse-DNS (PTR) auf einer Stichprobe seiner Adressen ermittelt. Jeder Eintrag enthält die Root-Domain, den PTR-Hostnamen und die abgefragte IP.

Stichprobenbasiert, also ein Hinweis darauf, was der ASN hostet, keine vollständige Liste. Für eine einzelne IP /v1/ip/:ip/hosted-domains verwenden.

BGP-Beziehungen eines ASN: Peers, Upstream-Provider und Downstream-Kunden, mit Anzahlen.

available ist false, wenn die BGP-Datenquelle nicht erreichbar war. Leere Arrays mit available: true bedeuten, dass für diesen ASN nichts gemeldet wurde.

Verzeichnis des IPv4-Raums: ein Eintrag pro /8-Block mit der Zahl der Bereiche, Länder und ASNs sowie dem häufigsten Land. Hier beginnen und dann mit /v1/ip-ranges/:a und /v1/ip-ranges/:a/:b weiter hineinzoomen.

Die /16-Blöcke innerhalb eines /8 (z. B. 8.0.0.0/8) mit denselben Zahlen zu Bereichen, Ländern und ASNs pro Block.

Die vergebenen Bereiche innerhalb eines /16 (z. B. 8.8.0.0/16), jeweils mit dem zugehörigen ASN, plus die Zahlen pro Block.

Ein Teil der Nearby-Nutzdaten für eine Koordinate, damit ein Client jeden Teil rendern kann, sobald er eintrifft: Reverse-Geocoding, Points of Interest oder lokale Kriminalitätsstatistik.

Fahrzeit und Entfernung zwischen zwei Punkten. Ein Schnellpfad: er überspringt das Reverse-Geocoding und die POI-Abfragen, die /v1/places/:ip durchführt.

Lässt sich kein Ziel auflösen, enthält die Antwort to: null, commute: null und einen reason-String.

Die Nutzdaten von /v1/places/:ip, verankert an einer eingegebenen Adresse statt an einer IP: Geocode, Ortsangaben und eine optionale Pendelzeit-Schätzung.

found ist false, wenn die Adresse nicht geocodiert werden konnte.

Adress-Autovervollständigung: einige passende Orte zu einer Teiladresse, optional zu einem Punkt hin gewichtet.

Das vollständige Wetterdokument für einen Ortsnamen, eine Postleitzahl, Koordinaten oder eine IP. Wählen Sie die benötigten Blöcke mit include: current, hourly, daily, astro (Sonne und Mond), solar, indicators, alerts, marine, air_quality, nowcast oder all. Orte in den USA stammen vom National Weather Service, alle anderen von MET Norway; meta.source nennt die Quelle. Ohne include erhalten Sie das oben beschriebene einfache Format { query, weather }.

meta.coverage zeigt, welche Felder für den Ort existieren: Regenwahrscheinlichkeit, Böen und Gewitterwahrscheinlichkeit gibt es nur in den USA und im Norden Europas und sind anderswo null (nie 0). alerts sind amtliche Warnungen für die USA und Norwegen; marine, air_quality und nowcast decken nur Norwegen und angrenzende Gewässer ab und melden anderswo available: false. Alles in meta.derived ist eine Schätzung von ipto.to, und indicators sind abgeleitete Hinweise, keine amtlichen Warnungen. Behalten Sie meta.attribution bei, wenn Sie die Daten anzeigen (MET-Norway-Daten stehen unter CC BY 4.0).

Die eigene Tagesaufzeichnung von ipto.to für bereits abgefragte Orte: der höchste Höchstwert, der niedrigste Tiefstwert und der größte Niederschlag aus den Vorhersage-Schnappschüssen des Tages. Nur bereits angefragte Orte haben Daten, die sich mit der Zeit ansammeln.

Es sind Vorhersage-Schnappschüsse, keine Stationsbeobachtungen oder Reanalysen – verwenden Sie sie nicht als beobachtete Historie. 404 bedeutet, dass für diesen Ort noch keine Schnappschüsse aufgezeichnet wurden.

Die verfügbaren Radar-Animationsbilder, älteste zuerst, jeweils mit Unix-Zeitstempel und der Bild-ID für die Radar-Kachel-URL.

Eine Radar-Kartenkachel (PNG) für ein Bild an einer üblichen z/x/y-Position einer Webkarte. Über dieselbe Origin ausgeliefert, damit eine Karte sie ohne Drittanbieter-Anfrage laden kann.

Eine Satellitenbild-Kartenkachel für eine übliche z/x/y-Position einer Webkarte, über dieselbe Origin ausgeliefert.

Maschinenlesbarer OpenAPI-3.1-Vertrag für /v1/email/:email, geschrieben, damit LLM- und MCP-Agenten den E-Mail-Endpunkt aufrufen können, ohne diese Dokumentation zu lesen.