Gusto Jobs API.

import requests

# The board token is the tenant slug plus its trailing UUID.
board = "birdies-lattes-4ba055ed-4bda-4873-bc68-b16b6bccaae9"
url = f"https://jobs.gusto.com/boards/{board}"

resp = requests.get(
    url,
    headers={"User-Agent": "Mozilla/5.0 (compatible; JoboBot/1.0)"},
    timeout=15,
)
resp.raise_for_status()
html = resp.text

import re
from bs4 import BeautifulSoup

UUID_RE = re.compile(
    r"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", re.I
)

soup = BeautifulSoup(html, "html.parser")
jobs, seen = [], set()

for a in soup.select('a[href^="/postings/"]'):
    slug = a["href"].split("/postings/")[-1].split("/")[0]
    match = UUID_RE.search(slug)
    if not match or slug in seen:
        continue
    seen.add(slug)

    paras = a.select("p")
    title = a.select_one("h3")
    location = paras[0].get_text(" ", strip=True) if paras else None
    # Second row is "{salary} · {employment_type}" joined by a middle dot.
    combined = paras[1].get_text(" ", strip=True) if len(paras) > 1 else ""
    parts = [p.strip() for p in combined.split("\u00b7") if p.strip()]
    salary = next((p for p in parts if "$" in p or any(c.isdigit() for c in p)), None)
    employment = next((p for p in parts if p != salary), None)

    jobs.append({
        "job_uuid": match.group(0).lower(),
        "posting_slug": slug,
        "url": f"https://jobs.gusto.com/postings/{slug}",
        "title": title.get_text(strip=True) if title else None,
        "location": location,
        "salary": salary,
        "employment_type": employment,
    })

print(f"Found {len(jobs)} postings")

from urllib.parse import urljoin

def fetch_detail(posting_url: str) -> dict:
    resp = requests.get(
        posting_url,
        headers={"User-Agent": "Mozilla/5.0 (compatible; JoboBot/1.0)"},
        timeout=15,
    )
    resp.raise_for_status()
    soup = BeautifulSoup(resp.text, "html.parser")

    spans = soup.select("h1 span")
    company = spans[0].get_text(strip=True) if len(spans) >= 1 else None
    title = spans[1].get_text(strip=True) if len(spans) >= 2 else None
    location_line = spans[2].get_text(" ", strip=True) if len(spans) >= 3 else None

    # Concatenate every rich-text section for the full description.
    description = "\n".join(
        c.decode_contents().strip() for c in soup.select(".rich-text-container")
    )

    salary = None
    for h4 in soup.select("h4"):
        if h4.get_text(strip=True).lower() == "salary":
            sibling = h4.find_next_sibling()
            salary = sibling.get_text(" ", strip=True) if sibling else None
            break

    apply_a = soup.select_one('a[href*="/applicants/new"]')
    apply_url = urljoin(posting_url, apply_a["href"]) if apply_a else posting_url

    return {
        "company": company,
        "title": title,
        "location_line": location_line,
        "description_html": description,
        "salary": salary,
        "apply_url": apply_url,
    }

def resolve_board(posting_url: str) -> str:
    resp = requests.get(
        posting_url,
        headers={"User-Agent": "Mozilla/5.0 (compatible; JoboBot/1.0)"},
        timeout=15,
    )
    resp.raise_for_status()
    soup = BeautifulSoup(resp.text, "html.parser")

    tenants = set()
    for a in soup.select('a[href*="/boards/"]'):
        tenant = a["href"].split("/boards/")[-1].split("/")[0]
        if UUID_RE.search(tenant):
            tenants.add(tenant)

    if len(tenants) != 1:
        raise ValueError(f"Expected one board breadcrumb, found {len(tenants)}")
    return tenants.pop()

import time

def polite_get(url: str) -> requests.Response:
    resp = requests.get(
        url,
        headers={"User-Agent": "Mozilla/5.0 (compatible; JoboBot/1.0)"},
        timeout=15,
    )
    if resp.status_code == 403:
        raise RuntimeError("Cloudflare challenge (HTTP 403) — slow down or rotate IP")
    if resp.status_code in (404, 410):
        raise RuntimeError(f"Board or posting removed (HTTP {resp.status_code})")
    resp.raise_for_status()
    time.sleep(2)  # one request at a time, ~2s apart
    return resp