HireTrue Jobs API.

import re
from urllib.parse import urlparse

HOST = "hiretrue-prod.com"
APP_ROOT = "/hiretrue/ce3"
API_ROOT = "/hiretrue/api/ce3"
GUID = re.compile(
    r"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
    re.IGNORECASE,
)
ROUTES = {"job-board", "job-board-welcome", "job-application"}

def parse_route(url: str) -> tuple[str, str | None] | None:
    parsed = urlparse(url)
    if parsed.netloc.lower().removeprefix("www.") != HOST:
        return None
    parts = parsed.path.strip("/").split("/")
    if len(parts) < 4 or parts[0] != "hiretrue" or parts[1] != "ce3":
        return None
    if parts[2] not in ROUTES or not GUID.match(parts[3]):
        return None
    requisition = parts[4].lower() if len(parts) == 5 and GUID.match(parts[4]) else None
    return parts[3].lower(), requisition

board_id, requisition_id = parse_route(
    "https://hiretrue-prod.com/hiretrue/ce3/job-board/"
    "a9a97c37-cc24-43d0-a7c3-6a931bc18276?jb=1"
)
print(board_id)

import requests

def board_api_url(board_id: str) -> str:
    return f"https://{HOST}{API_ROOT}/job-board?externalId={board_id}"

def resolve_board(session: requests.Session, board_id: str) -> dict:
    response = session.get(
        board_api_url(board_id),
        headers={"Accept": "application/json"},
        timeout=30,
    )
    response.raise_for_status()

    # An unrecognised GUID returns 200 with an EMPTY body. That is "board not
    # found", never "board with no jobs".
    if not response.text.strip():
        raise RuntimeError(f"HireTrue does not recognise board {board_id}")

    board = response.json()
    if int(board.get("primaryKey") or 0) <= 0:
        raise RuntimeError(f"HireTrue does not recognise board {board_id}")
    if (board.get("externalId") or "").lower() != board_id:
        raise RuntimeError("HireTrue answered with a different board than requested")
    if board.get("permissioned") or board.get("requiresInvitation"):
        raise RuntimeError("HireTrue board is gated behind a password or invitation")
    return board

session = requests.Session()
board = resolve_board(session, "a9a97c37-cc24-43d0-a7c3-6a931bc18276")
print(board["name"], board["primaryKey"], "internal:", board.get("internal"))

from datetime import datetime, timezone

def epoch_ms(value) -> str | None:
    if not value or value <= 0:
        return None
    return datetime.fromtimestamp(value / 1000, tz=timezone.utc).isoformat()

def fetch_requisitions(session: requests.Session, board: dict) -> list[dict]:
    response = session.get(
        f"https://{HOST}{API_ROOT}/job-board/requisitions",
        params={"jobBoardPrimaryKey": board["primaryKey"]},
        headers={"Accept": "application/json"},
        timeout=60,
    )
    response.raise_for_status()
    rows = response.json()
    if not isinstance(rows, list):
        raise RuntimeError("HireTrue requisitions API omitted its collection")
    return rows

def map_row(row: dict, board_id: str, board: dict) -> dict | None:
    requisition_id = (row.get("externalId") or "").lower()
    if int(row.get("primaryKey") or 0) <= 0 or not GUID.match(requisition_id):
        return None
    title = (row.get("title") or row.get("position") or "").strip()
    if not title:
        return None
    return {
        "primary_key": str(row["primaryKey"]),
        "requisition_id": requisition_id,
        "requisition_number": row.get("requisitionNumber"),
        "title": title,
        "company": board.get("companyName"),
        "location": row.get("location"),
        "department": row.get("department"),
        "division": row.get("division"),
        "position_type": row.get("positionType"),
        "opened_at": epoch_ms(row.get("openTimestamp")),
        "closes_at": epoch_ms(row.get("closeTimestamp")),
        "listing_url": f"https://{HOST}{APP_ROOT}/job-board/{board_id}/{requisition_id}",
        "apply_url": f"https://{HOST}{APP_ROOT}/job-application/{board_id}/{requisition_id}",
    }

rows = fetch_requisitions(session, board)
listings = [m for m in (map_row(r, board_id, board) for r in rows) if m]
print(f"{len(listings)} requisitions mapped of {len(rows)} returned")

MISSING = "Incorrect result size: expected 1, actual 0"

def fetch_detail(session: requests.Session, listing: dict) -> dict | None:
    response = session.get(
        f"https://{HOST}{API_ROOT}/job-board/requisitions/{listing['primary_key']}",
        headers={"Accept": "application/json"},
        timeout=30,
    )
    if response.status_code in (404, 410):
        return None  # canonical removal
    # The endpoint answers an unknown key with 400 and this exact message. Any
    # other 400 (for example "Invalid UUID string") is a transport bug, not removal.
    if response.status_code == 400 and MISSING in response.text:
        return None
    response.raise_for_status()

    detail = response.json()
    sections = [
        (detail.get(f"descriptionSection{n}") or "").strip()
        for n in range(1, 6)
    ]
    description = "\n".join(s for s in sections if s)
    if not description:
        raise RuntimeError("HireTrue requisition omitted every description section")

    return {
        **listing,
        "description_html": description,
        "salary": detail.get("salary"),
        "salary_type": detail.get("salaryType"),
        "scheduled_hours": (detail.get("scheduledStartHour"), detail.get("scheduledEndHour")),
        "posted_at": epoch_ms(detail.get("openDate")) or listing["opened_at"],
    }

for listing in listings[:3]:
    job = fetch_detail(session, listing)
    if job:
        print(job["title"], "-", job["salary"])