Stellenanzeigenauswertungen
5 endpoints
Kennzahlen zu Anzeigen und Kampagnen — je Tag und je Kanal aufgeschlüsselt.
Zwei Statistikarten, die sich in genau einer Kennzahl unterscheiden: die organische Statistik führt Klicks und Bewerbungen, die Performance-Statistik zusätzlich die Kosten.
Der ergiebigste Einstieg ist GET /reports/performance/jobs — der Monatsbericht über alle Anzeigen. Er liefert trotz des Namens tagesgenaue Zeilen und enthält zusätzlich Kampagnennamen und Schlagworte.
Achtung beim Auswerten: Die Statistik-Endpunkte antworten mit einem Umschlag (Nutzdaten unter data), der Monatsbericht dagegen mit einem nackten Array.
Organische Statistik (Stichtag)
GET /jobads/statistics/organic/{date}
Dieser Endpunkt gibt die organischen Statistikkennzahlen aller Stellenanzeigen für den im Pfad angegebenen Tag (date, Format: YYYY-MM-DD) zurück. Die Kennzahlen sind je Kanal aufgeschlüsselt.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
date |
path | string | yes | Stichtag im Format YYYY-MM-DD |
Responses
200 — OK
| Property | Type | Required | Description |
|---|---|---|---|
isFaulty |
boolean | no | Gibt an, ob die Verarbeitung fehlerhaft war |
data |
ReadOrganicStatisticsResponse[] | no | Nutzdaten der Antwort |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |
serviceAlerts |
ServiceAlertDto[] | no | Liste der Service-Hinweise |
statusCode |
integer (int32) | no | HTTP-Statuscode der Antwort |
messageGuid |
string (uuid) | null | no |
404 — Stellenanzeige nicht gefunden
| Property | Type | Required | Description |
|---|---|---|---|
messageGuid |
string (uuid) | null | no |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |
Organische Statistik einer Anzeige
GET /jobads/{id}/statistics/organic
Dieser Endpunkt gibt die organischen Statistikkennzahlen einer einzelnen Stellenanzeige zurück. Die Kennzahlen sind je Kanal aufgeschlüsselt.
Über die optionalen Query-Parameter startDate und endDate (Format: YYYY-MM-DD) kann die Ausgabe auf einen Zeitraum eingegrenzt werden.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
endDate |
query | string | no | Ende des Zeitraums im Format YYYY-MM-DD |
id |
path | string | yes | Identifikation der Stellenanzeige |
startDate |
query | string | no | Beginn des Zeitraums im Format YYYY-MM-DD |
Responses
200 — OK
| Property | Type | Required | Description |
|---|---|---|---|
isFaulty |
boolean | no | Gibt an, ob die Verarbeitung fehlerhaft war |
data |
ReadOrganicStatisticsResponse[] | no | Nutzdaten der Antwort |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |
serviceAlerts |
ServiceAlertDto[] | no | Liste der Service-Hinweise |
statusCode |
integer (int32) | no | HTTP-Statuscode der Antwort |
messageGuid |
string (uuid) | null | no |
404 — Stellenanzeige nicht gefunden
| Property | Type | Required | Description |
|---|---|---|---|
messageGuid |
string (uuid) | null | no |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |
Performance-Statistik (Stichtag)
GET /jobads/statistics/performance/{date}
Dieser Endpunkt gibt die Performance-Statistikkennzahlen aller Stellenanzeigen für den im Pfad angegebenen Tag (date, Format: YYYY-MM-DD) zurück. Die Kennzahlen sind je Kanal aufgeschlüsselt.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
date |
path | string | yes | Stichtag im Format YYYY-MM-DD |
Responses
200 — OK
| Property | Type | Required | Description |
|---|---|---|---|
isFaulty |
boolean | no | Gibt an, ob die Verarbeitung fehlerhaft war |
data |
ReadPerformanceStatisticsResponse[] | no | Nutzdaten der Antwort |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |
serviceAlerts |
ServiceAlertDto[] | no | Liste der Service-Hinweise |
statusCode |
integer (int32) | no | HTTP-Statuscode der Antwort |
messageGuid |
string (uuid) | null | no |
404 — Stellenanzeige nicht gefunden
| Property | Type | Required | Description |
|---|---|---|---|
messageGuid |
string (uuid) | null | no |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |
Performance-Statistik einer Anzeige
GET /jobads/{id}/statistics/performance
Dieser Endpunkt gibt die Performance-Statistikkennzahlen einer einzelnen Stellenanzeige zurück. Die Kennzahlen sind je Kanal aufgeschlüsselt.
Über die optionalen Query-Parameter startDate und endDate (Format: YYYY-MM-DD) kann die Ausgabe auf einen Zeitraum eingegrenzt werden.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
endDate |
query | string | no | Ende des Zeitraums im Format YYYY-MM-DD |
id |
path | string | yes | Identifikation der Stellenanzeige |
startDate |
query | string | no | Beginn des Zeitraums im Format YYYY-MM-DD |
Responses
200 — OK
| Property | Type | Required | Description |
|---|---|---|---|
isFaulty |
boolean | no | Gibt an, ob die Verarbeitung fehlerhaft war |
data |
ReadPerformanceStatisticsResponse[] | no | Nutzdaten der Antwort |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |
serviceAlerts |
ServiceAlertDto[] | no | Liste der Service-Hinweise |
statusCode |
integer (int32) | no | HTTP-Statuscode der Antwort |
messageGuid |
string (uuid) | null | no |
404 — Stellenanzeige nicht gefunden
| Property | Type | Required | Description |
|---|---|---|---|
messageGuid |
string (uuid) | null | no |
message |
string | null | no |
validationErrors |
ValidationError[] | no | Liste der Validierungsfehler |
Stellenanzeigen Statistiken pro Monat
GET /reports/performance/jobs
Dieser Endpunkt gibt die Statistiken der Stellenanzeigen pro Monat in einem Jahr zurück.
Optional lässt sich das Ergebnis mit page und pageSize seitenweise abrufen. Ohne pageSize wird der ganze Monat zurückgegeben. Beim seitenweisen Abruf ist die Reihenfolge stabil: nach Tag, Stellenanzeige, ReferenceId und Kanal. Die Antwort enthält keine Gesamtanzahl; die letzte Seite ist erreicht, wenn weniger als pageSize Einträge zurückkommen.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
month |
query | integer | no | Monat (1–12) |
year |
query | integer | no | Jahr (vierstellig) |
page |
query | integer (int32) | no | Seite, beginnt bei 1. Wirkt nur zusammen mit pageSize; ohne pageSize wird der ganze Monat zurückgegeben. Werte kleiner 1 werden mit 400 abgelehnt. |
pageSize |
query | integer (int32) | no | Anzahl der Einträge pro Seite, keine Obergrenze. Ohne Angabe wird der ganze Monat zurückgegeben. Werte kleiner 1 werden mit 400 abgelehnt. |
Responses
200 — OK
Array of:
| Property | Type | Required | Description |
|---|---|---|---|
day |
string (date) | no | Tag |
jobAdId |
integer (int32) | no | Id der Stellenanzeige |
referenceId |
string | null | no |
workingTitle |
string | null | no |
dkzId |
string | null | no |
channel |
string | null | no |
campaignNames |
string[] | no | Name der Kampagne |
campaignKeywords |
string[] | no | Kampagnenschlagworte |
costs |
number (double) | no | Kosten |
clicks |
integer (int32) | no | Klicks |
applies |
integer (int32) | no | Bewerbungen |
applyStarts |
integer (int32) | no | Gestartete Bewerbungen (nur bei Kanal Indeed) |