MHR iTrent Jobs API.

import re
import time
import requests

# A live iTrent board: host label and /{instance}_webrecruitment/ must match.
# Use the tenant's exact route (ETREC105GF or ETREC179GF).
BOARD = "https://ce0164li.webitrent.com/ce0164li_webrecruitment/wrd/run/ETREC105GF.open"
WVID, LANG = "8433573cTb", "USA"

http = requests.Session()
http.headers["User-Agent"] = "Mozilla/5.0"

def bootstrap_session(open_url, params):
    """The .open page embeds a fresh USESSION token in its response."""
    resp = http.get(open_url, params=params, timeout=30)
    resp.raise_for_status()
    match = re.search(r"[?&]USESSION=([A-F0-9]{16,})", resp.text, re.IGNORECASE)
    if not match:
        raise RuntimeError("iTrent bootstrap did not expose a USESSION - retry")
    return match.group(1), resp.url

usession, referer = bootstrap_session(BOARD, {"WVID": WVID, "LANG": LANG})

def endpoint(board_url, name):
    base = board_url.rsplit("/", 1)[0]   # .../wrd/run
    return f"{base}/{name}"

LISTINGS = endpoint(BOARD, "etrec106gf.json")

def fetch_listings(page=None):
    session_qs = f"WVID={WVID}&USESSION={usession}&LANG={LANG}"
    mhr_params = session_qs
    if page:  # (rec_from, rec_to, results_pp, total_rec) — only after page 1
        mhr_params += f"&RESULTS_PP={page[2]}&TOTAL_REC={page[3]}&REC_FROM={page[0]}&REC_TO={page[1]}"
    resp = http.get(
        LISTINGS,
        params={"WVID": WVID, "USESSION": usession, "LANG": LANG},
        headers={
            "Accept": "application/json, text/plain, */*",
            "X-Requested-With": "XMLHttpRequest",
            "Referer": referer,
            "mhrParams": mhr_params,   # required XHR header, else you get HTML
        },
        timeout=30,
    )
    resp.raise_for_status()
    if resp.text.lstrip().startswith("<"):
        raise RuntimeError("iTrent served HTML instead of JSON - refresh USESSION")
    return resp.json()

results, page = [], None
while True:
    payload = fetch_listings(page)
    search = payload["search"]
    results.extend(payload["results"])
    if search["rec_to"] >= search["total_rec"]:
        break
    nxt_from = search["rec_to"] + 1
    nxt_to = min(search["total_rec"], search["rec_to"] + search["results_pp"])
    page = (nxt_from, nxt_to, search["results_pp"], search["total_rec"])
    time.sleep(2)  # single in-flight request, ~2s apart

print(f"{len(results)} of {search['total_rec']} vacancies collected")

DETAIL = endpoint(BOARD, "etrec107gf.json")

def fetch_detail(vacancy_id):
    # USESSION is volatile — establish a new one per detail via the .open route.
    sess, ref = bootstrap_session(
        endpoint(BOARD, "ETREC107GF.open"),
        {"WVID": WVID, "LANG": LANG, "VACANCY_ID": vacancy_id})
    resp = http.get(
        DETAIL,
        params={"WVID": WVID, "USESSION": sess, "LANG": LANG, "VACANCY_ID": vacancy_id},
        headers={
            "Accept": "application/json, text/plain, */*",
            "X-Requested-With": "XMLHttpRequest",
            "Referer": ref,
        },
        timeout=30,
    )
    resp.raise_for_status()
    profile = resp.json()          # JSON array with exactly one object
    if len(profile) != 1 or profile[0].get("vacancy_id") != vacancy_id:
        raise RuntimeError("iTrent detail did not return the requested vacancy")
    job = profile[0]
    return {
        "vacancy_id": job["vacancy_id"],       # persistent job key
        "business_ref": job.get("vacancy_ref"),
        "title": job["job_titles"],
        "description": job["job_description"],  # HTML; expect 80+ chars of text
        "location": job.get("location"),
        "salary": job.get("salary"),
        "hours": job.get("con_hrs"),
        "posted": job.get("vacancy_d"),         # yyyyMMdd
        "closes": job.get("app_close_d"),       # yyyyMMdd
        "apply_url": job.get("apply_url"),
    }

for job in results:
    detail = fetch_detail(job["vacancy_id"])
    time.sleep(2)