Join.com Jobs API.

import requests
import json
from bs4 import BeautifulSoup

company_slug = "marswalk"
url = f"https://join.com/companies/{company_slug}"

response = requests.get(url, headers={"Accept": "text/html"})
soup = BeautifulSoup(response.text, "html.parser")

# The company ID is embedded in the Next.js __NEXT_DATA__ payload
script_tag = soup.find("script", id="__NEXT_DATA__")
next_data = json.loads(script_tag.string)

company_id = next_data["props"]["pageProps"]["initialState"]["company"]["id"]
print(f"Company ID: {company_id}")

import requests

company_id = 98520  # From step 1
url = f"https://join.com/api/public/companies/{company_id}/jobs"

params = {
    "locale": "en-us",
    "page": 1,
    "pageSize": 5,  # join.com rejects pageSize >= 6 with HTTP 422
}

response = requests.get(url, params=params)
data = response.json()

jobs = data["items"]
pagination = data["pagination"]
print(f"Found {pagination['rowCount']} total jobs across {pagination['pageCount']} pages")

for job in jobs:
    # Salary values are returned in cents
    salary_from = job.get("salaryAmountFrom", {}).get("amount", 0) / 100
    salary_to = job.get("salaryAmountTo", {}).get("amount", 0) / 100
    currency = job.get("salaryAmountFrom", {}).get("currency", "EUR")

    job_info = {
        "id": job["id"],
        "idParam": job.get("idParam"),
        "title": job["title"],
        "location": job.get("city", {}).get("cityName"),
        "region": job.get("city", {}).get("regionName"),
        "country": job.get("city", {}).get("countryName"),
        "workplace_type": job.get("workplaceType"),  # ONSITE, REMOTE, HYBRID
        "category": job.get("category", {}).get("name"),
        "employment_type": job.get("employmentType", {}).get("name"),
        "salary_range": f"{salary_from:,.0f} - {salary_to:,.0f} {currency}" if salary_from else None,
        "created_at": job.get("createdAt"),
    }
    print(job_info)

import requests

job_id = 15565770  # A listing's numeric "id" from step 2
url = f"https://join.com/api/public/jobs/{job_id}"

response = requests.get(url)
job = response.json()

# description may be null — assemble it from the section fields when it is
description = job.get("description")
if not description:
    sections = []
    if job.get("intro"): sections.append(job["intro"])
    if job.get("tasks"): sections.append(f"## Tasks\n\n{job['tasks']}")
    if job.get("requirements"): sections.append(f"## Requirements\n\n{job['requirements']}")
    if job.get("benefits"): sections.append(f"## Benefits\n\n{job['benefits']}")
    if job.get("outro"): sections.append(job["outro"])
    description = "\n\n".join(sections)

full_job = {
    "id": job["id"],
    "title": job["title"],
    "description": description,  # markdown
    "contact_name": job.get("contactName"),
    "contact_email": job.get("contactEmail"),
    "status": job.get("status"),  # ONLINE, OFFLINE, ARCHIVED
}
print(f"{full_job['title']} — {full_job['status']}")

import requests

def fetch_all_jobs(company_id: int, company_slug: str, page_size: int = 5) -> list:
    all_jobs = []
    page = 1

    while True:
        url = f"https://join.com/api/public/companies/{company_id}/jobs"
        params = {"locale": "en-us", "page": page, "pageSize": page_size}

        data = requests.get(url, params=params).json()
        for item in data["items"]:
            if not item.get("idParam"):
                continue
            item["job_url"] = f"https://join.com/companies/{company_slug}/jobs/{item['idParam']}"
            all_jobs.append(item)

        if page >= data["pagination"]["pageCount"]:
            break
        page += 1

    return all_jobs

jobs = fetch_all_jobs(98520, "marswalk")
print(f"Retrieved {len(jobs)} total jobs")