API-Dokumentation

Greifen Sie programmatisch auf IP-Geolokalisierungs- und ASN-Daten zu.

Authentifizierung erforderlich

Alle API-Anfragen erfordern einen gültigen API-Schlüssel.

Über Authorization-Header (empfohlen)

Authorization: Bearer YOUR_API_KEY

Über Query-Parameter

https://ipmeu.ro/api/lookup?key=YOUR_API_KEY&ip=8.8.8.8

Erstellen Sie ein kostenloses Konto für Ihren API-Schlüssel: Konto erstellen

Basis-URL

https://ipmeu.ro/api

Alle Endpunkte sind relativ zu dieser Basis-URL. HTTPS ist erforderlich.

GET /api/lookup

Geolokalisierungs- und Netzwerkinformationen für jede IP-Adresse nachschlagen.

Parameter

Parameter Typ Pflicht Beschreibung
key string Pflicht Ihr API-Schlüssel.
ip string Optional IP-Adresse zum Nachschlagen.

Beispielanfrage

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://ipmeu.ro/api/lookup?ip=8.8.8.8"

Beispielantwort

{
  "status": "success",
  "data": {
    "ip":       "8.8.8.8",
    "version":  4,
    "hostname": "dns.google",

    "geo": {
      "country":        "United States",
      "country_code":   "US",
      "region":         "California",
      "region_code":    "CA",
      "city":           "Mountain View",
      "postal_code":    "94043",
      "latitude":       37.386,
      "longitude":      -122.0838,
      "timezone":       "America/Los_Angeles",
      "continent":      "North America",
      "continent_code": "NA"
    },

    "asn": {
      "number":       15169,
      "name":         "Google LLC",
      "description":  "Google LLC - AS15169",
      "country":      "United States",
      "country_code": "US",
      "registry":     "ARIN",
      "allocated":    "2000-03-30",
      "total_ips":    16777216
    },

    "whois": {
      "net_range":    "8.8.8.0/24",
      "net_name":     "GOGL",
      "org_name":     "Google LLC",
      "org_id":       "GOGL",
      "country":      "US",
      "abuse_email":  "network-abuse@google.com",
      "registered":   "2000-03-30",
      "updated":      "2014-12-01"
    },

    "security": {
      "vpn":           false,
      "proxy":         false,
      "tor":           false,
      "threat_score":  0
    }
  }
}

Antwortfelder

Alle Felder und ihre Typen, die von der API zurückgegeben werden.

ip string Die abgefragte IP-Adresse (IPv4 oder IPv6).
version integer IP-Version: 4 für IPv4, 6 für IPv6.
hostname string Reverse-DNS-Hostname. Leere Zeichenfolge, wenn kein PTR-Eintrag vorhanden ist.

geo object

country string Vollständiger Ländername.
country_code string ISO 3166-1 Alpha-2-Ländercode (z. B. "US", "RO").
region string Regions- oder Bundesstaatsname.
region_code string ISO-Regionscode (z. B. "CA", "AB").
city string Stadtname.
postal_code string Postleitzahl.
latitude float Breitengradkoordinate (ungefähr).
longitude float Längengradkoordinate (ungefähr).
timezone string IANA-Zeitzonenkennung (z. B. "America/Los_Angeles").
continent string Kontinentname.
continent_code string Zweistelliger Kontinentcode (z. B. "EU", "NA").

asn object

number integer Autonome Systemnummer (Integer).
name string ASN-Organisationsname.
description string Vollständige ASN-Beschreibungszeichenfolge.
country string|null Land, in dem die ASN registriert ist. null wenn unbekannt.
country_code string|null ISO-Ländercode der ASN. null wenn unbekannt.
registry string|null Regionales Internetregister: ARIN, RIPE NCC, APNIC, LACNIC oder AFRINIC. null wenn unbekannt.
allocated string|null Datum der ersten Zuweisung des Netzwerkblocks (JJJJ-MM-TT). Aus WHOIS abgeleitet, wenn verfügbar. null wenn unbekannt.
total_ips integer|null Gesamtzahl der IP-Adressen im Netzwerkblock. Berechnet aus dem CIDR-Präfix. null wenn unbekannt.

whois object

net_range string|null Netzwerkbereich oder CIDR-Block (z. B. "8.8.8.0/24" oder "2a04::/32").
net_name string|null Kurzer Netzwerkname, wie in der RIR-Datenbank registriert.
org_name string|null Vollständiger Organisationsname des Netzwerkeigentümers.
org_id string|null Organisations-ID oder Handle in der RIR-Datenbank.
country string|null ISO-Ländercode aus dem WHOIS-Eintrag.
abuse_email string|null Missbrauch-Kontakt-E-Mail-Adresse. Verwenden Sie diese, um Netzwerkmissbrauch zu melden.
registered string|null Netzwerkregistrierungsdatum (ISO 8601-Format).
updated string|null Datum der letzten Aktualisierung des WHOIS-Eintrags.

security object

vpn boolean true, wenn die IP einem bekannten VPN-Anbieter oder Hosting-Netzwerk zugeordnet ist.
proxy boolean true, wenn die IP als offener Proxy erkannt wird.
tor boolean true, wenn die IP ein bekannter Tor-Ausgangsknoten ist (nur IPv4).
threat_score integer Bedrohungswert von 0 (sauber) bis 100 (hohes Risiko). Kombiniert VPN-, Proxy- und Tor-Signale.

HTTP-Statuscodes

200 OK Anfrage erfolgreich. Daten befinden sich im Antworttext.
400 Bad Request Ungültiges IP-Adressformat angegeben.
401 Unauthorized API-Schlüssel erforderlich
403 Forbidden Ungültiger API-Schlüssel
404 Not Found IP-Adresse konnte nicht aufgelöst werden.
429 Too Many Requests Tägliches Anfragelimit überschritten
500 Internal Server Error Interner Serverfehler. Bitte versuchen Sie es später erneut.

Fehlerantwortformat

{
  "status": "error",
  "error":  "API key is required."
}

Ratenlimits

Die kostenlose API ist ratenbegrenzt für faire Nutzung.

30
Anfragen / Minute
1,000
Anfragen / Tag
Kostenloses Kontingent
Registrieren Sie sich für einen kostenlosen API-Schlüssel

Limits werden um Mitternacht UTC zurückgesetzt. Das Überschreiten des Limits gibt HTTP 429 zurück.

Code-Beispiele

$ cURL 

curl -s -H "Authorization: Bearer YOUR_API_KEY" \
     "https://ipmeu.ro/api/lookup?ip=8.8.8.8" | python3 -m json.tool

P PHP 

$response = file_get_contents('https://ipmeu.ro/api/lookup?ip=8.8.8.8&key=YOUR_API_KEY');
$data     = json_decode($response, true);

echo $data['data']['geo']['country'];   // "United States"
echo $data['data']['asn']['name'];      // "Google LLC"
echo $data['data']['security']['vpn'];   // false

Py Python 

import requests

resp = requests.get(
    "https://ipmeu.ro/api/lookup",
    params={"ip": "8.8.8.8"},
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = resp.json()["data"]

print(data["geo"]["country"])     # United States
print(data["asn"]["registry"])   # ARIN
print(data["whois"]["abuse_email"]) # network-abuse@google.com

JS JavaScript (fetch) 

const res  = await fetch(
  "https://ipmeu.ro/api/lookup?ip=8.8.8.8",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const { data } = await res.json();

console.log(data.geo.country);          // "United States"
console.log(data.asn.registry);         // "ARIN"
console.log(data.whois.abuse_email);    // "network-abuse@google.com"
console.log(data.security.threat_score); // 0