FlowData

Wie frage ich bis zu 100 IP-Adressen auf einmal ab?

Veröffentlicht am 05. November 2026

Wenn du viele IP-Adressen auf einmal verorten willst, zum Beispiel die Zugriffe eines Tages aus deinem Server-Log, musst du nicht jede Adresse einzeln abfragen. Mit der Batch-Abfrage schickst du bis zu 100 Einträge in einer einzigen Anfrage.

So sieht die Anfrage aus

Die Batch-Abfrage ist ein POST an https://api.flowdata.one/v1/geolocation/batch. Der Body ist direkt ein JSON-Array, ohne umschließendes Objekt.

curl -X POST "https://api.flowdata.one/v1/geolocation/batch?lang=de" \
  -H "Authorization: Bearer fd_DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '["8.8.8.8", "1.1.1.1", "example.com"]'

Jeder Eintrag ist entweder eine IP-Adresse oder Domain als Text oder ein Objekt mit eigenen Einstellungen:

[
  "8.8.8.8",
  {"query": "1.1.1.1", "lang": "en"},
  {"query": "example.com", "fields": "status,country,city,query"}
]
  • query: die IP-Adresse oder Domain.
  • lang: die Sprache nur für diesen Eintrag.
  • fields: durch Komma getrennte Feldnamen. Die Antwort zu diesem Eintrag enthält dann nur diese Felder. Nimm status mit, wenn du prüfen willst, ob die Ortung geklappt hat.

Der Parameter lang in der Adresse legt die Sprache für alle Einträge fest, die keine eigene haben. Ohne Angabe kommen die Namen auf Deutsch. Welche Sprachen es gibt, steht in Wie frage ich den Standort zu einer IP-Adresse oder Domain ab?. Anders als bei der Einzelabfrage führt ein unbekannter Sprachcode hier nicht zu einem Fehler, der Eintrag bekommt einfach die Standardsprache.

Die Antwort

Du bekommst ein JSON-Array zurück, mit einem Objekt je Eintrag und in derselben Reihenfolge wie deine Einträge. Jedes Objekt hat dieselben Felder wie eine Einzelabfrage. Ordne die Ergebnisse am sichersten über ihre Position deinen Daten zu, denn bei einer Domain steht in query die aufgelöste IP-Adresse und nicht der Domainname.

Ein einzelner Eintrag kann auch "status": "fail" mit einer kurzen Begründung in message haben, etwa private range oder invalid query. Die übrigen Einträge sind davon nicht betroffen. Prüfe den Status deshalb für jedes Objekt einzeln. Auch ein Eintrag, der weder Text noch ein Objekt mit query ist, endet so, mit invalid query und leerem query.

Domains müssen zuerst aufgelöst werden. Dafür hat eine Batch-Abfrage insgesamt zehn Sekunden Zeit. Ist die Zeit um, enden die restlichen Domains mit invalid query, IP-Adressen werden weiter verortet. Hast du viele Domains, schick sie in kleineren Paketen.

Fehlermeldungen der Batch-Abfrage

Bevor die Abfrage startet, prüft FlowData den Body. Diese Fehler haben die Form {"status":"fail","message":"..."}:

HTTP message Ursache
400 Empty request body Der Body ist leer.
400 Invalid JSON format Der Body ist kein gültiges JSON, oft fehlt ein Anführungszeichen oder ein Komma.
400 Request body must be a JSON array Der Body ist ein Objekt wie {"ips": [...]} statt eines Arrays.
400 At least one query required Das Array ist leer.
422 Maximum 100 queries allowed per batch request Das Array hat mehr als 100 Einträge.
503 Geolocation database unavailable Die Ortung ist gerade nicht verfügbar. Versuch es nach einer kurzen Pause erneut.

Hast du mehr als 100 Adressen, teile sie in Pakete zu höchstens 100 auf und schick sie nacheinander.

Im Protokoll des Bereichs findest du alle abgelehnten Batch-Abfragen, wenn du den Filter auf Fehlgeschlagen stellst. Das Augensymbol in der Zeile zeigt die genaue Fehlerantwort. Mehr dazu in Statistik und Protokoll eines FlowData-Bereichs.

Was kostet eine Batch-Abfrage?

Berechnet wird jeder Eintrag mit status: success. Einträge mit fail sind kostenlos, und eine abgelehnte Abfrage kostet nichts. Der Preis je 1.000 erfolgreiche Abfragen ist derselbe wie bei der Einzelabfrage und steht auf der Preisseite.

Vor dem Start hält FlowData den Betrag für alle Einträge zurück und rechnet danach nur die erfolgreichen ab. Reicht dein Guthaben nicht für alle Einträge, antwortet die API mit HTTP 402, auch wenn am Ende nicht alle erfolgreich gewesen wären.

Gut zu wissen

  • Eine Batch-Abfrage zählt in der Statistik als eine Anfrage und steht als eine Zeile im Protokoll, egal wie viele Einträge sie enthält.
  • Entferne doppelte Adressen vor dem Senden, dann passen mehr verschiedene Adressen in ein Paket.
  • Wie für alle FlowData-Aufrufe gilt: Schick die Anfrage von deinem Server, damit dein Schlüssel nicht im Browser landet.

War dieser Artikel hilfreich?

Zurück zu IP Geolocation & Client Info