Things to build

// Server-side (Node, a serverless function, a build step), never in a browser bundle, because a real key is a secret.
const qs = new URLSearchParams({ country: 'NL', limit: '20' });
const { data } = await (
  await fetch(`https://api.jobopportunitiesapi.org/v1/jobs?${qs}`, {
    headers: { Authorization: `Bearer ${process.env.JOA_API_KEY}` },
  })
).json();

const verified = iso =>
  new Date(iso).toLocaleDateString('en-GB', { day: 'numeric', month: 'short' });

const html = data.map(j => `
  <article>
    <h3><a href="${j.apply_url}" rel="nofollow noopener">${j.title}</a></h3>
    <p>${j.company}${j.city ? `, ${j.city}` : ''}</p>
    ${j.remote ? `<span>${j.remote}${
        // Say which kind of fact this is. It is on the row for a reason.
        j.field_sources.remote === 'inferred' ? ' (inferred)' : ''
      }</span>` : ''}
    <small>Last verified ${verified(j.last_verified_at)}</small>
  </article>`).join('') +
  // Licence obligation: a visible credit wherever listings are shown publicly.
  '<p><small>Data: <a href="https://jobopportunitiesapi.org">Job Opportunities API</a></small></p>';
// ...return `html` from your own API route, or render it into the page server-side.

"""Report what changed for a watchlist of employers, by domain.

    export JOA_KEY=...
    python3 watch.py stripe.com figma.com linear.app
"""
import json, os, pathlib, sys, urllib.parse, urllib.request

API   = "https://api.jobopportunitiesapi.org"
KEY   = os.environ["JOA_KEY"]
STATE = pathlib.Path(".joa-watch.json")

def get(path, **params):
    req = urllib.request.Request(
        f"{API}{path}?" + urllib.parse.urlencode(params),
        headers={"Authorization": f"Bearer {KEY}"},
    )
    with urllib.request.urlopen(req, timeout=90) as r:
        return json.load(r)

domains = sys.argv[1:] or ["stripe.com"]
seen    = json.loads(STATE.read_text()) if STATE.exists() else {}

current = {}
for job in get("/v1/jobs", company_domain=",".join(domains), limit=200)["data"]:
    current[job["id"]] = {"company": job["company"], "title": job["title"]}

for jid, job in current.items():
    if jid not in seen:
        print(f"OPENED   {job['company']}\t{job['title']}")

# A role that vanished may be closed, withdrawn, or simply beyond page one.
# Ask, rather than assume: include_closed tells you which it was.
for jid, job in seen.items():
    if jid in current:
        continue
    row = get(f"/v1/jobs/{jid}", include_closed="true").get("data", {})
    if row.get("status") == "closed":
        print(f"CLOSED   {job['company']}\t{job['title']}\t({row.get('closed_reason')})")
    else:
        print(f"GONE     {job['company']}\t{job['title']}\t(withdrawn or off page one)")

STATE.write_text(json.dumps(current))

"""Enrich a list of company domains with hiring signal.

    export JOA_KEY=...
    python3 enrich.py < domains.txt > enriched.json
"""
import collections, json, os, sys, urllib.parse, urllib.request

API   = "https://api.jobopportunitiesapi.org"
KEY   = os.environ["JOA_KEY"]
BATCH = 20   # comma-separated domains per request

def get(path, **params):
    req = urllib.request.Request(
        f"{API}{path}?" + urllib.parse.urlencode(params),
        headers={"Authorization": f"Bearer {KEY}"},
    )
    with urllib.request.urlopen(req, timeout=90) as r:
        return json.load(r)

domains = [d.strip().lower() for d in sys.stdin if d.strip()]
out = {d: {"matched": False, "open_roles": 0, "titles": [], "categories": {}}
       for d in domains}

for i in range(0, len(domains), BATCH):
    chunk = domains[i:i + BATCH]
    page = get("/v1/jobs", company_domain=",".join(chunk), limit=200)
    by_company = collections.defaultdict(list)
    for job in page["data"]:
        by_company[job["company_slug"]].append(job)
    # Map rows back to the domain we asked about via the company record.
    for slug, jobs in by_company.items():
        company = get(f"/v1/companies/{slug}").get("data", {})
        domain = (company.get("website") or "").lower()
        if domain not in out:
            continue
        out[domain]["matched"] = True
        out[domain]["open_roles"] = company.get("open_roles", len(jobs))
        out[domain]["titles"] = [j["title"] for j in jobs[:5]]
        cats = collections.Counter(j.get("category") for j in jobs if j.get("category"))
        out[domain]["categories"] = dict(cats)

# A domain with no match is NOT a company that is not hiring: only ~37% of
# companies in the ledger carry a domain at all.
json.dump(out, sys.stdout, indent=2)

# Any OpenAPI generator works; the spec is 3.1.0 and keyless.
curl -s https://jobopportunitiesapi.org/openapi.json -o joa-openapi.json

# e.g. with openapi-generator (not a JOA product; use whatever you already have)
openapi-generator-cli generate \
  -i joa-openapi.json -g typescript-fetch -o ./joa-client