Echtzeit-Daten-APIs
für jeden Geschäftsbedarf

Datenfeed-APIs sind RESTful-APIs, mit denen Sie Datensätze filtern und Snapshots nur mit den Daten erstellen können, die Sie benötigen. Der Endpunkt „Filter Dataset API” startet einen asynchronen Job, der den von Ihnen ausgewählten Datensatz filtert und einen Snapshot basierend auf Ihren Kriterien erstellt, den Sie dann herunterladen oder programmgesteuert aufrufen können.

Wenn Sie die Filter Dataset API aufrufen, wird ein asynchroner Job erstellt, der Ihre Filter anwendet und einen Snapshot generiert. Der Vorgang hat eine maximale Zeitüberschreitung von 5 Minuten. Nach Abschluss erhalten Sie eine snapshot_id, mit der Sie auf Ihre gefilterten Daten zugreifen können. Ihnen wird nur die Snapshot-Größe auf Basis des Datensatzpreises in Rechnung gestellt.

Die API unterstützt eine Vielzahl von Operatoren: = (gleich), != (ungleich), < und > (kleiner/größer als), <= und >= (kleiner/größer oder gleich), „in” und „not_in” (Wertabgleich), „includes” und „not_includes” (Teilzeichenfolge/Array enthält), „array_includes” und „not_array_includes” (exakter Array-Abgleich) sowie „is_null” / „is_not_null” zur Überprüfung leerer Werte. Für verschiedene Feldtypen (Text, Zahl, Datum, Array) gelten unterschiedliche Operatoren.

Ja. Sie können mehrere Filter mithilfe der logischen Operatoren „and“ oder „or“ in Filtergruppen kombinieren. Die API unterstützt eine maximale Verschachtelungstiefe von 3 Ebenen. Bei Arrays von Objekten können Sie den Parameter „combine_nested_fields“ verwenden, um sicherzustellen, dass alle Filter innerhalb eines einzelnen Objekts und nicht über das gesamte Array hinweg übereinstimmen.

Die API unterstützt zwei Modi: den JSON-Modus für die Standardfilterung und den Multipart/Form-Data-Modus zum Hochladen von CSV- oder JSON-Dateien, die Filterwerte enthalten. Im Multipart-Modus senden Sie dataset_id und records_limit als Abfrageparameter und fügen Sie dann Ihre Filterdefinition und Dateien in den Form-Data-Body ein. Dies ist ideal für die Filterung nach Hunderten oder Tausenden von Werten.

Sie benötigen nur zwei Dinge: Ihre Datensatz-ID (zu finden auf der Detailseite des Datensatzes) und Ihren Bright Data API-Schlüssel. Fügen Sie Ihren API-Schlüssel als Bearer-Token in den Authorization-Header ein. Für die Filterung von Datensätzen sind keine Proxy-Zonen, Passwörter oder zusätzliche Anmeldedaten erforderlich.

Gefilterte Snapshots sind in den Formaten JSON, NDJSON, CSV und Parquet verfügbar. Sie können Ihr bevorzugtes Format beim Herunterladen des Snapshots oder beim Konfigurieren Ihrer Liefermethode angeben.

Nachdem die API eine snapshot_id zurückgegeben hat, können Sie Ihre gefilterten Daten per Direktdownload, API-Antwort, Webhook-Callbacks, Amazon S3, Google Cloud Storage, Snowflake, Azure, SFTP oder E-Mail abrufen. Wählen Sie die Liefermethode, die am besten zu Ihrem Workflow passt.

Die API gibt einen 422-Fehler mit der Meldung „Der angegebene Filter passte zu keinem Datensatz“ zurück. Überprüfen Sie die Syntax und die Werte Ihres Filters, um sicherzustellen, dass sie mit den Daten in den Datensätzen übereinstimmen. Sie können vor dem Filtern eine Vorschau der Datensatzfelder und Beispieldaten im Control Panel anzeigen.

Ja. Jeder Datensatz hat eine maximale Grenze von 100 parallelen Aufträgen. Wenn Sie diese Grenze überschreiten, erhalten Sie einen 429-Fehler. Warten Sie, bis bestehende Aufträge abgeschlossen sind, bevor Sie neue starten, oder kontaktieren Sie den Vertrieb, wenn Sie aufgrund hoher Nutzungsvolumina eine Erhöhung der Grenzen benötigen.

Wenn Ihr Kontostand nicht ausreicht, um den gefilterten Snapshot zu verarbeiten, erhalten Sie einen 402-Fehler, der den erforderlichen Betrag angibt. Laden Sie Ihr Konto auf oder passen Sie Ihren Filter an, um die Anzahl der Datensätze zu reduzieren, bevor Sie es erneut versuchen.

Vollständige Code-Beispiele finden Sie in der API-Dokumentation für cURL, Python, JavaScript und Java. Jedes Beispiel zeigt, wie Sie sich authentifizieren, Ihre Filteranfrage strukturieren und die Antwort verarbeiten. Sie können die Filtersyntax auch direkt über das Control Panel generieren, indem Sie Filter in der Benutzeroberfläche anwenden und auf „Filter-API” klicken.