Climatebase APIclimatebase.org ↗

"""Climatebase SDK walkthrough — search climate jobs, drill into details, explore similar roles."""
from parse_apis.climatebase_jobs_api import (
    Climatebase, DatePosted, WorkplacePreference, ExperienceLevel, JobNotFound
)

client = Climatebase()

# Search for remote solar jobs — limit caps total items fetched across all pages.
for job in client.jobsummaries.search(q="solar", workplace_preference=WorkplacePreference.REMOTE, limit=5):
    print(job.title, "|", job.name_of_employer, "|", job.activation_date)

# Drill into the first result for full details (separate network call).
summary = client.jobsummaries.search(q="engineer", date=DatePosted.WEEK, limit=1).first()
if summary:
    detail = summary.details()
    print(detail.title, detail.how_to_apply, detail.employer_name)

    # Walk similar jobs offered on the detail page.
    for similar in detail.similar_jobs.list(limit=3):
        print(similar.title, similar.employer_name)

    # Fetch full employer info from the job detail.
    employer = detail.get_employer()
    print(employer.company_name, employer.website)

# List remote jobs posted today using convenience filter.
for remote_job in client.jobsummaries.list_remote(date=DatePosted.TODAY, limit=3):
    print(remote_job.title, remote_job.remote_preferences)

# Typed error handling: catch JobNotFound for an invalid ID.
try:
    bad_summary = client.jobsummaries.search(q="nonexistent_xyz_99999", limit=1).first()
    if bad_summary:
        bad_summary.details()
except JobNotFound as exc:
    print(f"Job not found: {exc.job_id}")

print("exercised: search / details / similar_jobs.list / get_employer / list_remote / JobNotFound")