jobsearch does not return hashes so the jobdetails cannot be retrieved

[StoyanStAtanasov]

import requests
import json
from jobsearch_params import JobSearchParameters, WorkTime

url = "https://rest.arbeitsagentur.de/jobboerse/jobsuche-service/pc/v4/jobs"
headers = {
    "X-API-Key": "jobboerse-jobsuche"
}

# Create an instance of JobSearchParameters with desired parameters
search_params = JobSearchParameters(
    location="Berlin",
    radius="200",
    work_times=[WorkTime.FULL_TIME, WorkTime.PART_TIME],
    page=1,
    result_size=25,
    private_employment_agency=False
)

response = requests.get(url, headers=headers, params=search_params.to_params(), timeout=60)

partial response, not hashes for the offers, there are some other hashes but they don't work for jobdetials

{
    "stellenangebote": [
        {
            "beruf": "Lehrer/in - St\u00fctzunterricht",
            "titel": "Nachhilfelehrer/innen zur Erteilung von Einzelnachhilfe gesucht",
            "refnr": "10001-1001143291-S",
            "arbeitsort": {
                "plz": "10243",
                "ort": "Berlin",
                "region": "Berlin",
                "land": "Deutschland",
                "koordinaten": {
                    "lat": 52.512790935000055,
                    "lon": 13.440177475000041
                },
                "entfernung": "1"
            },
            "arbeitgeber": "Wissensexperten Marc Reimer",
            "aktuelleVeroeffentlichungsdatum": "2025-02-13",
            "modifikationsTimestamp": "2025-02-13T11:49:28.933",
            "eintrittsdatum": "2025-02-13",
            "kundennummerHash": "vvJ5VCS0p69GL--gSwp1980mxSqANWgiSuJwX-R9HBQ="
        },
        {
            "beruf": "Betreuungskraft / Alltagsbegleiter/in",
            "titel": "Betreuungskraft, Erzieher*in, Kinderbetreuer*in, Kinderpfleger*in, Student*in als Hilfskraft, Tagesm",
            "refnr": "12618-134343-S",
            "arbeitsort": {
                "plz": "10243",
                "ort": "Berlin",
                "region": "Berlin",
                "land": "Deutschland",
                "koordinaten": {
                    "lat": 52.512791,
                    "lon": 13.4401775
                },
                "entfernung": "1"
            },
            "arbeitgeber": "awo lifebalance GmbH",
            "aktuelleVeroeffentlichungsdatum": "2025-02-13",
            "modifikationsTimestamp": "2025-02-13T12:47:21.532",
            "eintrittsdatum": "2025-02-13",
            "externeUrl": "https://www.awo-jobs.de/index.php?id=114&uid=134343"
        },
        {
            "beruf": "Sachbearbeiter/in - Logistik",
            "titel": "Sachbearbeiter Abrechnung und Logistik (m/w/d)",
            "refnr": "15933-0053618006-S",
            "arbeitsort": {
                "plz": "10969",
                "ort": "Berlin",
                "strasse": "Kommandantenstra\u00dfe 18",
                "region": "Berlin",
                "land": "Deutschland",
                "koordinaten": {
                    "lat": 52.50834404182871,
                    "lon": 13.403017586546818
                },
                "entfernung": "2"
            },
            "arbeitgeber": "D-TRUST GmbH",
            "aktuelleVeroeffentlichungsdatum": "2025-02-13",
            "modifikationsTimestamp": "2025-02-13T14:45:55.982",
            "eintrittsdatum": "2025-02-14",
            "kundennummerHash": "0wF8uul_eaKKjkY1ShVCeQVSHEtVQ4NDvPv6EEO_wLA="
        },
        {
            "beruf": "Buchhalter/in",
            "titel": "Buchhalter/in",
            "refnr": "10001-1000316868-S",
            "arbeitsort": {
                "plz": "10969",
                "ort": "Berlin",
                "strasse": "Mehringplatz 5",
                "region": "Berlin",
                "land": "Deutschland",
                "koordinaten": {
                    "lat": 52.4986424,
                    "lon": 13.3936656
                },
                "entfernung": "3"
            },
            "arbeitgeber": "Hilal G\u00fcloglu LANIYA - H\u00e4usliche Gesundheitspflege",
            "aktuelleVeroeffentlichungsdatum": "2025-02-13",
            "modifikationsTimestamp": "2025-02-13T10:43:18.347",
            "eintrittsdatum": "2025-02-13",
            "kundennummerHash": "h67mYon71CzO5jCqgv1GuUIdu1wT4BgYcJAqhFPUkpQ="
        },
        {
            "beruf": "Rechtsanwalts- und Notarfachangestellte/r",
            "titel": "Einer der sch\u00f6nsten Arbeitspl\u00e4tze Berlins (m/w/d)",
            "refnr": "10000-1200481842-S",
            "arbeitsort": {
                "plz": "10117",
                "ort": "Berlin",
                "strasse": "Friedrichstr. 95",
                "region": "Berlin",
                "land": "Deutschland",
                "koordinaten": {
                    "lat": 52.5191887,
                    "lon": 13.3897052
                },
                "entfernung": "3"
            },
            "arbeitgeber": "Dr. Alexander Freiherr Knigge",
            "aktuelleVeroeffentlichungsdatum": "2025-02-13",
            "modifikationsTimestamp": "2025-02-13T09:06:43.473",
            "eintrittsdatum": "2025-02-13",
            "kundennummerHash": "a88PTO08qgnWronGv1BFgklNa9AdcK8MrESBj5xGJ6I="
        },

[webgefaehrten]

Die /v1-API wurde abgeschaltet. Verwende stattdessen /v3. Außerdem muss die refnr in Base64 kodiert werden.

Kleines Beispiel:
Basis-URL für Jobdetails in /v3
base_url = "https://rest.arbeitsagentur.de/jobboerse/jobsuche-service/pc/v3/jobdetails/"

Beispiel-Referenznummer (ersetzen mit einer echten refnr)
refnr = "DE123456789"

Base64-kodierte refnr erstellen
encoded_refnr = base64.b64encode(refnr.encode()).decode()

Endgültige URL für die Anfrage
jobdetails_url = f"{base_url}{encoded_refnr}"

API-Header
headers = { "X-API-Key": "jobboerse-jobsuche" }

Anfrage senden
response = requests.get(jobdetails_url, headers=headers, timeout=60)

Antwort prüfen und ausgeben

if response.status_code == 200:
    job_details = response.json()
    print(json.dumps(job_details, indent=4, ensure_ascii=False))
else:
    print(f"Fehler: {response.status_code}, {response.text}")

[StoyanStAtanasov]

@webgefaehrten Thanks for the thorough reply 👍It would be good for others if this information was written in some kind of documentation. I searched a lot and I could not find it anywhere.

Should I close this issue, or leave it open until this information is added to the docs?

[webgefaehrten]

I would leave it open - unfortunately I have nothing to do with the API. But I've also been searching for ages. Maybe it will still be included.

Kind regards