Bitrix24-Daten per API exportieren und Felder auslesen

Sie möchten Auswertungen bauen, eine Migration vorbereiten oder einfach nur einen sauberen Datenabzug für ein BI-Tool erzeugen – und stoßen schnell an die Grenzen der eingebauten Export-Buttons. Genau hier hilft Ihnen die Bitrix24-Daten exportieren API: Sie liefert strukturierte, vollständige Daten statt einer abgeschnittenen CSV-Datei aus der Listenansicht.

Dieser Artikel richtet sich an Analysten und Entwickler, die wissen wollen, wie sie Kontakte, Deals und vor allem benutzerdefinierte Felder zuverlässig herausholen. Wir gehen es so an, wie wir es auch in Kundenprojekten tun: erst klären, welche Entitäten überhaupt erreichbar sind, dann Felder auslesen, Paginierung sauber lösen und am Ende die typischen Stolperfallen vermeiden.

Eine ehrliche Vorbemerkung: Der Bordmittel-Export von Bitrix24 ist für Ad-hoc-Listen okay, aber sobald es um vollständige Datensätze inklusive aller Custom Fields, Verknüpfungen und Historie geht, führt an der API kein Weg vorbei.

Welche Entitäten abrufbar sind

Über die REST-API erreichen Sie praktisch alle zentralen CRM-Objekte: Kontakte, Unternehmen, Leads, Deals und – seit dem Umstieg auf das einheitliche CRM-Modell – die Smart-Process-Elemente. Dazu kommen Aktivitäten, Aufgaben, Kalendereinträge sowie Stammdaten wie Benutzer und Statuslisten.

Der saubere Einstieg führt über die Listen-Methoden je Entität (etwa crm.contact.list, crm.deal.list oder die generischen crm.item.*-Methoden für Smart Processes). Diese geben Ihnen die Datensätze gefiltert, sortiert und seitenweise zurück. Für einen vollständigen Export kombinieren Sie sie mit den passenden *.fields-Methoden, die das komplette Feldschema liefern.

Wenn Sie mit der Mechanik von Webhooks und Methodenaufrufen noch nicht vertraut sind, lohnt vorab ein Blick in unseren Einstieg in die Bitrix24-API. Dort klären wir die Grundlagen, auf denen dieser Export-Artikel aufbaut.

Felder und benutzerdefinierte Felder auslesen

Die häufigste Frustration in der Praxis: Der Export enthält nur die Standardfelder, aber genau die wichtigen, selbst angelegten Felder fehlen. Der Grund ist, dass benutzerdefinierte Felder (User Fields) in Bitrix24 technische Codes wie UF_CRM_... tragen und nicht automatisch mit dem von Ihnen vergebenen Klartext-Namen ausgegeben werden.

Der verlässliche Weg, Bitrix24-Felder auszulesen, läuft in zwei Schritten:

1. Zuerst rufen Sie die *.fields-Methode der jeweiligen Entität auf (z. B. crm.deal.fields). Sie erhalten eine vollständige Landkarte aller Felder – inklusive der technischen Codes, des Feldtyps und der Anzeigebezeichnung.
2. Dann fragen Sie in der Listen-Methode gezielt die gewünschten Felder über den select-Parameter ab. Geben Sie die UF_CRM_...-Codes explizit an, sonst liefert die API sie nicht mit.

Besonders bei Auswahllisten (Dropdowns) gilt: Die API gibt oft nur die interne ID des Listenwerts zurück, nicht den lesbaren Text. Für ein verständliches Reporting müssen Sie diese IDs über das Feldschema oder die entsprechende Enum-Methode in Klartext übersetzen. Wer diesen Schritt überspringt, sitzt später vor einer Tabelle voller anonymer Zahlen.

Paginierung und Limits

Listen-Methoden liefern niemals alle Datensätze auf einmal. Bitrix24 gibt pro Aufruf ein begrenztes Paket zurück (in der Größenordnung von einigen Dutzend Datensätzen) und reicht über den Parameter start einen Zeiger auf die nächste Seite weiter. Für einen vollständigen Export iterieren Sie also so lange, bis keine weiteren Datensätze mehr kommen.

Zwei Dinge erleichtern das spürbar:

• Sortierung festlegen: Sortieren Sie konsistent (etwa nach ID aufsteigend), damit Sie keine Datensätze doppelt ziehen oder überspringen, während im Hintergrund neue entstehen.
• Batch nutzen: Mit der batch-Methode bündeln Sie mehrere Aufrufe in eine Anfrage und reduzieren so die Zahl der HTTP-Roundtrips deutlich – gerade bei großen Exporten ein echter Geschwindigkeitsgewinn.

Zu den Rate-Limits: Bitrix24 begrenzt die Aufrufrate, um die Plattform zu schützen. Konkrete Limits hängen vom Tarif ab und können sich ändern – verlassen Sie sich daher nicht auf fest verdrahtete Zahlen, sondern bauen Sie Ihren Export von vornherein höflich (Stand: Juni 2026; bitte aktuelle Konditionen in der offiziellen Bitrix24-Dokumentation prüfen). In der Praxis heißt das: nicht hunderte Aufrufe pro Sekunde abfeuern, sondern Pausen einplanen und auf Drosselungs-Antworten reagieren.

Export für Reporting und BI

Sobald die Daten strukturiert herauskommen, wird der eigentliche Mehrwert sichtbar. Für ein wiederkehrendes Reporting empfiehlt sich ein Zwischenschritt: Die API-Daten landen zunächst in einem neutralen Format – etwa JSON oder einer Datenbanktabelle – und werden von dort an Ihr BI-Werkzeug (Power BI, Looker Studio, ein Data Warehouse) übergeben.

Dieser Umweg lohnt sich aus drei Gründen. Erstens entkoppeln Sie Ihr Reporting von der API-Verfügbarkeit. Zweitens können Sie die UF_CRM_...-Codes einmal zentral in sprechende Spaltennamen übersetzen. Drittens lassen sich Verknüpfungen – etwa Deal zu Kontakt zu Unternehmen – sauber zusammenführen, statt sie in jedem Bericht neu zu verknüpfen.

Wenn der reine Datenabzug nicht ausreicht und Sie eine dauerhaft laufende, bidirektionale Kopplung brauchen, ist irgendwann der Punkt erreicht, an dem sich eine individuelle Schnittstelle gegenüber einer Bastellösung rechnet. Für einfache, ereignisgesteuerte Übergaben reicht hingegen oft schon ein ausgehender Webhook.

Häufige Fehler

Drei Muster sehen wir in Kundenprojekten immer wieder:

• Vergessene Custom Fields: Der select-Parameter wird nicht gesetzt oder enthält die UF_CRM_...-Codes nicht – der Export wirkt vollständig, ist es aber nicht.
• Abbruch bei der Paginierung: Der Abzug stoppt nach der ersten Seite, weil der start-Zeiger nicht weitergereicht wird. Ergebnis: ein Bruchteil der Daten, ohne dass es auffällt.
• Rate-Limits ignoriert: Ein zu aggressives Skript wird gedrosselt, einzelne Seiten fehlen, und der Export ist still und leise unvollständig.

Der gemeinsame Nenner: Unvollständige Exporte fallen oft erst auf, wenn das Reporting bereits Entscheidungen beeinflusst hat. Deshalb gehört zu jedem Export eine Plausibilitätsprüfung – etwa ein Abgleich der Datensatzzahl gegen die Listenansicht im CRM.

Häufige Fragen

Wie lese ich benutzerdefinierte Felder aus?

Rufen Sie zuerst die *.fields-Methode der Entität auf, um die technischen Feldcodes (UF_CRM_...) und Feldtypen zu ermitteln. Anschließend geben Sie diese Codes im select-Parameter der Listen-Methode explizit an. Bei Auswahllisten übersetzen Sie die zurückgelieferten IDs über das Feldschema in lesbaren Klartext.

Wie umgehe ich Rate-Limits?

Umgehen sollten Sie sie nicht – arbeiten Sie höflich mit ihnen. Bündeln Sie Aufrufe über die batch-Methode, paginieren Sie konsistent sortiert und planen Sie kurze Pausen ein. Reagiert die API mit einer Drosselung, warten Sie kurz und wiederholen den Aufruf, statt stur weiterzufeuern. Die konkreten Limits hängen vom Tarif ab (Stand: Juni 2026; bitte aktuelle Konditionen prüfen).

Sie wollen Ihren Datenexport oder Ihr Reporting sauber und zuverlässig aufsetzen, statt mit halben Exporten zu arbeiten? Buchen Sie ein unverbindliches Erstgespräch – wir schauen gemeinsam, wie Sie Ihre Bitrix24-Daten strukturiert herausholen.