Tyler Portico Jobs API.

from urllib.parse import urlparse

ROOT_DOMAIN = "tylerportico.com"
API_BASE = "/tess/citizen/api"
BOARD_PATH = "/tess/citizen/jobs/job-list"

def parse_portico(url: str) -> dict:
    parsed = urlparse(url)
    host = parsed.netloc.lower()
    if not host.endswith("." + ROOT_DOMAIN):
        raise ValueError("not a Tyler Portico host")
    if not parsed.path.startswith(BOARD_PATH):
        raise ValueError("not a Portico job-list route")

    tenant = host[: -len("." + ROOT_DOMAIN)]
    return {"tenant": tenant, "origin": f"https://{host}"}

board = parse_portico("https://cityofhelenamt.tylerportico.com/tess/citizen/jobs/job-list")
print(board)
# {'tenant': 'cityofhelenamt', 'origin': 'https://cityofhelenamt.tylerportico.com'}

import requests

session = requests.Session()
session.headers["Accept"] = "application/json"

def verify_tenant(board: dict) -> dict:
    resp = session.get(f"{board['origin']}{API_BASE}/AppConfig", timeout=30)
    resp.raise_for_status()
    config = resp.json()

    context = ((config.get("datadogRum") or {}).get("config") or {}).get("globalContext") or {}
    if (context.get("tenantName") != board["tenant"]
            or (context.get("division") or "").lower() != "erp"
            or (context.get("product") or "").lower() != "employee-access"):
        raise RuntimeError("AppConfig omitted or contradicted its first-party tenant proof")

    return {
        "tenant": board["tenant"],
        "agency_name": config.get("agencyName"),
        "portal_title": config.get("portalAgencyTitle"),
    }

print(verify_tenant(board))

def fetch_positions(board: dict) -> list[dict]:
    resp = session.get(f"{board['origin']}{API_BASE}/Positions", timeout=60)
    resp.raise_for_status()
    payload = resp.json()

    # The collection is returned whole; there is no paging envelope to follow.
    positions = payload if isinstance(payload, list) else payload.get("positions") or []
    if not isinstance(positions, list):
        raise RuntimeError("Positions did not return a collection")
    return positions

positions = fetch_positions(board)
print(f"{len(positions)} open positions")

import re

GUID = re.compile(r"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$")
REQ_PAIR = re.compile(r"^\d+\|\d+$")

def to_job(board: dict, record: dict) -> dict:
    native_id = (record.get("id") or "").strip()
    if not (GUID.match(native_id) or REQ_PAIR.match(native_id)):
        raise ValueError(f"unrecognised Portico native id: {native_id!r}")

    return {
        "id": native_id,
        "title": record.get("title"),
        "description_html": record.get("description"),
        "code": record.get("code"),
        "job_family": record.get("jobFamily"),
        "job_class": record.get("jobClass"),
        "job_type": record.get("jobType"),
        "bargaining_unit": record.get("groupBargainingUnit"),
        "salary_range": record.get("salaryRange"),
        "location": record.get("locationDescription"),
        "posted_at": record.get("postingStartDate"),
        "closes_at": record.get("postingEndDate"),
        "listing_url": f"{board['origin']}{BOARD_PATH}/{native_id}",
    }

for record in positions[:3]:
    job = to_job(board, record)
    print(job["title"], "|", job["salary_range"])

IMAGE_ONLY = re.compile(r"^\s*(<[^>]+>\s*)*<img[^>]+src=[\"']data:image", re.IGNORECASE)

def collect(board: dict, positions: list[dict]) -> tuple[list[dict], int]:
    jobs, rejected = [], 0
    for record in positions:
        description = record.get("description") or ""
        if not description.strip() or IMAGE_ONLY.match(description):
            rejected += 1
            continue
        jobs.append(to_job(board, record))
    return jobs, rejected

jobs, rejected = collect(board, positions)
if rejected:
    print(f"snapshot incomplete: {rejected} image-only descriptions rejected")
print(f"{len(jobs)} usable jobs")