Betterteam Jobs API.

from urllib.parse import urlparse

SUFFIX = ".betterteam.com"
RESERVED = {"www", "support", "app"}

def parse_board(url: str):
    """Return (tenant, job_slug) for a Betterteam board or job URL."""
    host = urlparse(url).netloc.lower()
    if not host.endswith(SUFFIX):
        return None

    tenant = host[: -len(SUFFIX)]
    if not tenant or "." in tenant or tenant in RESERVED or len(tenant) > 63:
        return None

    segments = [s for s in urlparse(url).path.split("/") if s]
    job_slug = segments[0] if len(segments) == 1 else None
    return tenant, job_slug

print(parse_board("https://110grill.betterteam.com/general-manager-64"))
# ('110grill', 'general-manager-64')

import requests

UA = ("Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 "
      "(KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36")

def make_session(board_url: str) -> requests.Session:
    session = requests.Session()
    session.headers.update({
        "User-Agent": UA,
        "Accept": "text/html,application/xhtml+xml",
        "Accept-Language": "en-US,en;q=0.9",
        "Referer": board_url,
    })
    return session

board_url = "https://110grill.betterteam.com"
session = make_session(board_url)

from bs4 import BeautifulSoup
from urllib.parse import urljoin, urlparse

NAV_PAGES = {"about", "contact", "privacy", "terms", "favicon.ico"}

def fetch_board(session, board_url: str) -> list[dict]:
    resp = session.get(board_url, timeout=30)
    resp.raise_for_status()

    host = urlparse(board_url).netloc.lower()
    soup = BeautifulSoup(resp.text, "html.parser")
    listings, seen = [], set()
    for anchor in soup.select("a[href]"):
        absolute = urljoin(board_url, anchor["href"])
        parsed = urlparse(absolute)
        if parsed.netloc.lower() != host:
            continue

        segments = [s for s in parsed.path.split("/") if s]
        if len(segments) != 1:
            continue
        slug = segments[0]
        if slug.lower() in NAV_PAGES or slug in seen:
            continue

        seen.add(slug)
        listings.append({
            "id": slug,
            "title": " ".join(anchor.get_text().split()),
            "url": f"{parsed.scheme}://{parsed.netloc}{parsed.path}",
        })
    return listings

listings = fetch_board(session, board_url)
print(f"{len(listings)} open jobs")

import json
import time

def find_job_posting(html: str) -> dict | None:
    soup = BeautifulSoup(html, "html.parser")
    for tag in soup.find_all("script", type="application/ld+json"):
        try:
            data = json.loads(tag.string or "")
        except (json.JSONDecodeError, TypeError):
            continue
        for node in (data if isinstance(data, list) else [data]):
            if isinstance(node, dict) and node.get("@type") == "JobPosting":
                return node
    return None

def fetch_details(session, listings: list[dict]) -> list[dict]:
    out = []
    for listing in listings:
        resp = session.get(listing["url"], timeout=30)
        if resp.status_code in (404, 410):
            continue  # posting removed
        resp.raise_for_status()

        posting = find_job_posting(resp.text)
        if not posting:
            continue

        address = ((posting.get("jobLocation") or {}).get("address")) or {}
        out.append({
            "id": listing["id"],
            "title": posting.get("title") or listing["title"],
            "description_html": posting.get("description"),
            "employment_type": posting.get("employmentType"),
            "posted_at": posting.get("datePosted"),
            "closes_at": posting.get("validThrough"),
            "company": (posting.get("hiringOrganization") or {}).get("name"),
            "city": address.get("addressLocality"),
            "state": address.get("addressRegion"),
            "url": listing["url"],
        })
        time.sleep(1.0)  # one request at a time, ~1s apart
    return out

jobs = fetch_details(session, listings[:3])