Zum Hauptinhalt gehen

Finden Sie die Antworten, die Sie brauchen

Übersicht über die Personio Recruiting-API

In diesem Artikel wird erklärt, was eine öffentliche Programmierschnittstelle (Application Programming Interface, API) ist und wofür Sie die Recruiting-API verwenden können.

APIs ermöglichen den Datenaustausch zwischen Personio und einem anderen Dienst oder Tool. Auf diese Weise können Sie Verbindungen zwischen Personio und Ihren eigenen Datenbanken herstellen oder Integrationen mit Drittanbietern einrichten, die im Personio Marketplaceverfügbar sind. Erfahren Sie mehr über öffentlichen Personio-APIs.

Zusätzlich zur API können Sie Informationen zu Ihren veröffentlichten Stellen aus Ihrem XML-Feed abrufen und in Ihre Webseite einbinden. Erfahren Sie mehr darüber, wie Sie Stellen aus Personio per XML in Ihre Unternehmens-Webseite integrieren.

Bevor Sie beginnen

  • Um den Marketplace zu nutzen und Integrationen einzurichten, benötigen Sie Bearbeitungsrechte für die Marketplace-Integration und die API.
  • Zur Integration der Recruiting-API empfehlen wir Ihnen, sich an eine auf IT spezialisierte Person zu wenden.

Bewerbendendaten an Personio übermitteln

Sie benötigen die Recruiting-API, wenn Ihr Unternehmen bereits eine Karriereseite hat und Sie möchten, dass Ihre Bewerbenden dort direkt ein Bewerbungsformular ausfüllen können, ohne zu Personio weitergeleitet zu werden.

In diesem Fall werden die Bewerbendeninformationen über die API an Personio übermittelt. Erfahren Sie mehr über die Übermittlung von Bewerbendendaten an Ihren Personio Account.

Recruiting-Daten aus Personio abrufen

Personio bietet einen Recruiting-GET-Endpunkt. So können Sie Ihre Recruiting-Daten abrufen und Datenanalysen außerhalb von Personio durchführen.

In der folgenden Tabelle finden Sie eine Übersicht der verfügbaren Funktionen sowie die entsprechenden Links zum Developer Hub. Beachten Sie, dass Sie die in diesem Abschnitt beschriebenen Informationen nur über die v2 Recruiting-Endpunkte abrufen können.

Funktion Link zum Developer Hub
Bewerber
Bewerbungen
Stelle

Hinweis:
Die API ist eine Standard-REST-API. Diese Art von Schnittstelle unterscheidet sich von Webhooks. Webhooks benachrichtigen Sie automatisch über Änderungen an einer Bewerbung, einer sich bewerbenden Person oder einer Stelle. REST-APIs bieten diese Funktion nicht. Um bei einer Anbindung über eine REST-API Änderungen erkennen zu können, müssen Sie die ausgegebenen Ergebnisse auf Unterschiede überprüfen. Personio kann dies nicht für Sie prüfen.

Wichtige verfügbare Datenpunkte

Aus den oben beschriebenen Endpunkten können Sie die folgenden Datenpunkte abrufen:

Bewerbungsdaten

  • Bewerbungs-ID, Erstellungsdatum, Aktualisierungsdatum
  • Aktuelle Phase/Status
  • Positions-ID und Bezeichnung der Stelle
  • Bewerbenden-ID und -Informationen
  • Recruitingkanal-ID (falls erfasst)
  • Gültigkeitsdatum
  • Recruitingteam

Daten zu Phasenübergängen (entscheidend für zeitbasierte Metriken)

  • Übergangshistorie für jede Bewerbung
  • Von Phase → Zu Phase
  • Übergangszeitstempel

Diese Datenpunkte ermöglichen alle zeitbasierten Berechnungen.

Stellendaten

  • Job ID und Titel 
  • Abteilung und Unternehmen
  • Kategorie-ID
  • Erstellungs-/Aktualisierungsdatum
  • Recruitingteam

Bewerbendendaten

  • Bewerbenden-ID
  • Grundlegende Bewerbendendaten
  • Erstellungs-/Aktualisierungsdatum

Kategoriendaten

  • Kategorienamen und -IDs
  • Phasen in der Kategorie

Anwendungsfälle

Mithilfe der Recruiting-API können Sie nützliche Recruitingdaten abrufen. Die Anwendungsfälle in den folgenden Tabellen zeigen Ihnen die Möglichkeiten.

Zeitbasierte Metriken

Fallbeispiel Benötigte Datenpunkte
Time-to-Hire Möglich mithilfe der Endpunkte der Endpunkte Bewerbungsdatum und Phasenübergänge, um zu verfolgen, wann Bewerbende in die Phase Eingestellt wechseln.
Time-to-Offer Möglich durch Verfolgung der Phasenübergänge zur Angebotsphase.
Time-to-Fill Möglich durch Vergleich des Erstellungsdatums der Stelle mit dem endgültigen Anstelldatum aus den Bewerbungen.
In jeder Phase verbrachte Zeit Möglich über den Endpunkt Phasenübergänge.

Bewerbungsfluss und Konversionsmetriken

Fallbeispiel Benötigte Datenpunkte
Bewerbungen pro Phase Verfügbar über den aktuellen Status der Phase im Endpunkt Bewerbungen.
Konversionsraten nach Phase Berechnen Sie diese Raten anhand der Daten zum Phasenübergang. Zum Beispiel der Prozentsatz der Bewerbenden, die vom „Screening“ über „Interview“ bis „Angebot“ gelangen.
Bewerbungsvolumen im Zeitverlauf Verfolgen Sie diese Metrik anhand der Zeitstempel für Erstellungsdatum und Aktualisierungsdatum.
Bewerbungen pro Stelle Verfügbar über das Feld Stellen-ID im Endpunkt Bewerbungen.

Quellen- und Kanalmetriken

Fallbeispiel Benötigte Datenpunkte
Bewerbungen nach Einstellungskanal Verfügbar, wenn die ID des Recruitingkanals im Endpunkt Bewerbungen erfasst ist.
Konversionsraten nach Kanal Berechnen Sie diese Raten durch die Kombination von Kanaldaten mit Phasenübergängen.

Ablehnungs- und Ergebnismetriken

Fallbeispiel Benötigte Datenpunkte
Angebotsannahmequote Möglich durch Verfolgung von Bewerbungen, die die Phase Eingestellt erreichen.
Ablehnungen nach Phase Verfolgen Sie hierzu die Phasenübergänge zur Systemphase Abgelehnt.
Abgelehnte Angebote Möglich durch Verfolgung von Bewerbungen, die von der Phase Angebot in die Phase Abgelehnt übergehen.

Stellen- und Kategoriemetriken

Fallbeispiel Benötigte Datenpunkte
Bewerbungen nach Stellenkategorie Verfügbar über die Endpunkte Stellen und Kategorien.
Bewerbungen nach Abteilung, Arbeitsplatz oder Standort Verfügbar in den Stellendetails im Endpunkt Stellen.
Time-to-Fill (nach Kategorie) Kombinieren Sie hierzu Daten zu Stellenkategorien mit Zeitmetriken.

Bewerbendenmetriken

Fallbeispiel Benötigte Datenpunkte
Bewerbendenqualität Verfolgen Sie den Fortschritt der Bewerbenden aus jedem Kanal.
Bewerbungen pro sich bewerbende Person Verfügbar über den Endpunkt Bewerbende (eine sich bewerbende Person kann mehrere Bewerbungen haben).

 

Nächster Schritt

Helfen Sie uns, uns zu verbessern. Ist diese Seite hilfreich?