Nimble Jobs API.

import re
from urllib.parse import urlparse, parse_qs

import requests

HOST = "app.hirenimble.com"
SLUG = re.compile(r"^[a-z0-9](?:[a-z0-9_-]{0,61}[a-z0-9])?$", re.IGNORECASE)

def parse_board(url: str) -> str | None:
    parsed = urlparse(url)
    if parsed.netloc.lower() != HOST:
        return None
    parts = parsed.path.strip("/").split("/")
    if len(parts) != 2 or parts[0].lower() != "jobs" or not SLUG.match(parts[1]):
        return None
    return parts[1].lower()

def resolve_board(session: requests.Session, slug: str) -> dict:
    response = session.get(
        f"https://{HOST}/api/jobboards/{slug}/",
        headers={"Accept": "application/json"},
        timeout=30,
    )
    response.raise_for_status()
    board = response.json()
    # The endpoint is keyed by the slug and does not echo it back, so carry the
    # slug yourself and treat the numeric id as the durable board identity.
    if not str(board.get("id", "")).isdigit() or not str(board.get("district_id", "")).isdigit():
        raise RuntimeError("Nimble board endpoint did not prove a numeric board identity")
    return {"id": str(board["id"]), "district_id": str(board["district_id"]),
            "title": board.get("title"), "slug": slug}

session = requests.Session()
slug = parse_board("https://app.hirenimble.com/jobs/adelante?jobboard_id=196")
board = resolve_board(session, slug)
print(board["id"], board["district_id"], board["title"])

def fetch_roles(session: requests.Session, board: dict) -> list[dict]:
    response = session.get(
        f"https://{HOST}/api/search/roles/",
        params={"district": board["district_id"], "jobboard": board["id"]},
        headers={"Accept": "application/json"},
        timeout=60,
    )
    response.raise_for_status()
    rows = response.json()
    if not isinstance(rows, list):
        raise RuntimeError("Nimble listings endpoint did not return an array")
    return rows

rows = fetch_roles(session, board)
public_rows = [r for r in rows if not r.get("internal_only")]
print(f"{len(public_rows)} public roles of {len(rows)} returned")

def map_row(row: dict, board: dict) -> dict | None:
    job_id = str(row.get("id") or "")
    title = (row.get("title") or "").strip()
    if not job_id.isdigit() or not title:
        return None

    schools = [
        (s.get("name") or "").strip()
        for s in (row.get("schools") or [])
        if (s.get("name") or "").strip()
    ]
    url = f"https://{HOST}/jobview/{job_id}"
    return {
        "id": job_id,
        "title": title,
        "company": board["title"],
        "listing_url": url,
        "apply_url": url,
        "locations": sorted(set(schools)),
        "closes_at": row.get("deadline"),
        "salary_min": row.get("salary_min"),
        "salary_max": row.get("salary_max"),
        "full_time_equivalent": row.get("fulltime"),
        "jobboard_id": board["id"],
    }

listings = [m for m in (map_row(r, board) for r in public_rows) if m]
print(f"{len(listings)} roles mapped")

def fetch_role(session: requests.Session, listing: dict, board: dict) -> dict | None:
    response = session.get(
        f"https://{HOST}/api/role/{listing['id']}/",
        params={"jobview": "true"},
        headers={"Accept": "application/json"},
        timeout=30,
    )
    if response.status_code in (404, 410):
        return None  # canonical removal
    response.raise_for_status()

    role = response.json()
    boards = {str(b.get("id")) for b in (role.get("jobboards") or [])}
    if str(role.get("id")) != listing["id"] or board["id"] not in boards:
        raise RuntimeError("Nimble role did not prove the requested board and job identity")

    # Nimble's own active state: anything else means the role left the board.
    if role.get("status") != 20 or role.get("active_status") != 1:
        return None

    description = (role.get("description") or "").strip()
    benefits = (role.get("benefits") or "").strip()
    if not description:
        raise RuntimeError("Nimble role omitted its description")
    if benefits:
        description = f"{description}\n<h2>Benefits</h2>{benefits}"

    placements = [
        ((r.get("school") or {}).get("location") or (r.get("school") or {}).get("name") or "").strip()
        for r in (role.get("schoolroles") or [])
    ]
    return {
        **listing,
        "title": (role.get("title") or listing["title"]).strip(),
        "description_html": description,
        "posted_at": role.get("date_posted") or role.get("created"),
        "closes_at": role.get("deadline") or listing["closes_at"],
        "locations": sorted({p for p in placements if p}) or listing["locations"],
    }

for listing in listings[:3]:
    job = fetch_role(session, listing, board)
    print(job["title"] if job else f"{listing['id']} is no longer active")