Kostenlose Geolocation-API
API für Entwickler zur Abfrage von Geolokalisierung und IP-Informationen.
Laden...
Routen
https://geo.cmds.media/ip?ip={ip}
Nützlich für allgemeine Informationen.
Codebeispiele
import requests
response = requests.get("https://geo.cmds.media/ip?ip=8.8.8.8")
data = response.json()
print(data)
curl "https://geo.cmds.media/ip?ip=8.8.8.8"
const response = await fetch("https://geo.cmds.media/ip?ip=8.8.8.8");
const data = await response.json();
console.log(data);
Beispielantwort
{
"accuracy": 1000,
"asn": 15169,
"asn_org": "GOOGLE",
"city": null,
"continent": "North America",
"continent_code": "NA",
"country": "United States",
"country_iso": "US",
"currency": "usd",
"currency_symbol": "$",
"ip": "8.8.8.8",
"latitude": 37.751,
"longitude": -97.822,
"postal": null,
"region": null,
"region_iso": null,
"success": true,
"timezone": "America/Chicago",
"tz_offset": -4.0
}
https://geo.cmds.media/currency?ip={ip}
Nützlich für Online-Shops mit lokalisierter Währung.
Codebeispiele
import requests
response = requests.get("https://geo.cmds.media/currency?ip=8.8.8.8")
data = response.json()
print(data)
curl "https://geo.cmds.media/currency?ip=8.8.8.8"
const response = await fetch("https://geo.cmds.media/currency?ip=8.8.8.8");
const data = await response.json();
console.log(data);
Beispielantwort
{
"country": "United States",
"country_iso": "US",
"currency": "usd",
"currency_symbol": "$",
"ip": "8.8.8.8",
"success": true
}
https://geo.cmds.media/client?ip={ip}&ua={user_agent}
Gibt Geolokalisierung sowie Geräte-, Browser- und OS-Informationen zurück. Nutzt den User-Agent-Header.
Codebeispiele
import requests
headers = {
"User-Agent": "Mozilla/5.0"
}
response = requests.get(
"https://geo.cmds.media/client?ip=8.8.8.8",
headers=headers
)
data = response.json()
print(data)
curl "https://geo.cmds.media/client?ip=8.8.8.8" \
-H "User-Agent: Mozilla/5.0"
const response = await fetch("https://geo.cmds.media/client?ip=8.8.8.8", {
headers: {
"User-Agent": navigator.userAgent
}
});
const data = await response.json();
console.log(data);
Beispielantwort
{
"asn": 15169,
"asn_org": "GOOGLE",
"browser": {
"name": "Chrome",
"version": "145.0.0"
},
"city": "Mountain View",
"continent": "North America",
"continent_code": "NA",
"country": "United States",
"country_iso": "US",
"device": {
"brand": null,
"model": null
},
"device_type": "desktop",
"ip": "8.8.8.8",
"latitude": 37.4056,
"longitude": -122.0775,
"os": {
"name": "Windows",
"version": "10"
},
"postal": "94043",
"region": "California",
"region_iso": "CA",
"success": true,
"timezone": "America/Los_Angeles",
"accuracy": 1000
}
https://geo.cmds.media/geo?ip={ip}
Detaillierte Geolokalisierungsinformationen einschließlich Koordinaten und ASN.
Codebeispiele
import requests
response = requests.get("https://geo.cmds.media/geo?ip=8.8.8.8")
data = response.json()
print(data)
curl "https://geo.cmds.media/geo?ip=8.8.8.8"
const response = await fetch("https://geo.cmds.media/geo?ip=8.8.8.8");
const data = await response.json();
console.log(data);
Beispielantwort
{
"accuracy": 1000,
"asn": 15169,
"asn_org": "GOOGLE",
"city": "Mountain View",
"continent": "North America",
"continent_code": "NA",
"country": "United States",
"country_iso": "US",
"ip": "8.8.8.8",
"latitude": 37.4056,
"longitude": -122.0775,
"postal": "94043",
"region": "California",
"region_iso": "CA",
"success": true,
"timezone": "America/Los_Angeles",
"tz_offset": -7.0
}
https://geo.cmds.media/country?ip={ip}
Minimaler Länder-Level-Check für Compliance-Prüfungen und Geo-Einschränkungen.
Codebeispiele
import requests
response = requests.get("https://geo.cmds.media/country?ip=8.8.8.8")
data = response.json()
print(data)
curl "https://geo.cmds.media/country?ip=8.8.8.8"
const response = await fetch("https://geo.cmds.media/country?ip=8.8.8.8");
const data = await response.json();
console.log(data);
Beispielantwort
{
"country": "United States",
"country_iso": "US",
"continent": "NA",
"in_eu": false,
"ip": "8.8.8.8",
"success": true
}
Wie funktioniert das Ratenlimit?
Unsere API verwendet einen Token-Bucket-Algorithmus zur Ratenbegrenzung. Jeder Endpunkt hat eine bestimmte Anzahl an Tokens, die in festen Intervallen nachgefüllt werden. Bei einer Anfrage wird ein Token aus dem entsprechenden Bucket verbraucht. Wenn keine Tokens mehr verfügbar sind, erhältst du eine 429 Too Many Requests-Antwort mit einem Retry-After-Header, der angibt, wann du es erneut versuchen kannst.
Wie werden Fehler behandelt?
Wenn eine Anfrage fehlschlägt, geben wir eine JSON-Antwort zurück mit dem Feld "success" auf false und dem Feld "error", das eine Beschreibung des Problems enthält. Prüfe immer das Feld "success", bevor du die Antwortdaten verarbeitest.
Wenn ein Feld für eine bestimmte IP-Adresse nicht zutrifft (z. B. "city" für eine IP, die nur auf Länderebene aufgelöst wird), wird es als null zurückgegeben.
FAQ
Ist diese API wirklich kostenlos?
Natürlich! Unsere API ist komplett kostenlos mit großzügigen Ratenlimits. Wir benötigen keinen API-Schlüssel oder eine Authentifizierung.
Woher stammen eure Geolokalisierungsdaten?
Wir nutzen eine Kombination aus öffentlichen und privaten Datenquellen, einschließlich der GeoIP2-Datenbanken von MaxMind, um die größtmögliche Abdeckung zu gewährleisten.
Kann ich diese API für kommerzielle Zwecke nutzen?
Ja, du kannst unsere API sowohl für private als auch für kommerzielle Projekte ohne Einschränkungen verwenden.
Was soll ich tun, wenn ich einen Fehler erhalte?
Wenn du auf Probleme stößt oder Fragen hast, kontaktiere uns über unser Support-Formular.
Gibt es einen kostenpflichtigen Plan oder höhere Ratenlimits?
Derzeit bieten wir keinen kostenpflichtigen Plan an. Wir könnten dies in Zukunft in Betracht ziehen, wenn genügend Nachfrage besteht, aber aktuell wollen wir diese API für alle kostenlos halten. Für Ratenlimit-Erhöhungen kannst du uns Details zu deiner Nutzung über unser Support-Formular senden.
Ich habe einen Vorschlag für eine neue Funktion oder einen Endpunkt. Wie kann ich diesen teilen?
Wir freuen uns über Feedback und Vorschläge. Bitte teile deine Ideen über unser Feedback-Formular.
Wie oft werden eure Geolokalisierungsdaten aktualisiert?
Wir aktualisieren unsere Geolokalisierungsdaten, sobald neue Daten verfügbar sind.
Kann jede andere Programmiersprache verwendet werden?
Ja, du kannst jede Programmiersprache verwenden, die HTTP-Anfragen senden kann, um mit unserer API zu interagieren. Die bereitgestellten Beispiele sind nur einige gängige Sprachen, um den Einstieg zu erleichtern.
Ich habe eine weitere Frage, die hier nicht aufgeführt ist.
Wenn du weitere Fragen hast, wende dich gerne über unser Support-Formular an uns. Wir helfen dir gerne.