curl -X POST 'https://api.hirebase.org/v2/jobs/historical/search' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "job_titles": ["sustainability", "ESG", "climate", "renewable", "\"clean energy\""],
    "geo_locations": [{"country": "United States"}],
    "date_posted_from": "2023-01-01",
    "sample_size": 20
  }'

import hirebase

client = hirebase.Client(api_key="YOUR_API_KEY")
res = client.jobs.historical_search(
    {
        "job_titles": ["sustainability", "ESG", "climate", "renewable", '"clean energy"'],
        "geo_locations": [{"country": "United States"}],
        "date_posted_from": "2023-01-01",
    },
    sample_size=20,
)
print(res["total_count"], res["export_quote"]["price_usd"])
for row in res["by_year_posted"]:
    print(row["year"], row["count"])

{
  "total_count": 3096,
  "by_year_posted": [
    {"year": 2023, "count": 69},
    {"year": 2024, "count": 154},
    {"year": 2025, "count": 2857},
    {"year": 2026, "count": 16}
  ],
  "top_companies": [
    {"company_name": "Turner & Townsend", "count": 300},
    {"company_name": "EDF Renewables", "count": 117},
    {"company_name": "NextEra Energy", "count": 52}
  ],
  "sample_titles": [
    {"job_title": "Director, Global Energy and Sustainability Policy", "year_posted": 2026},
    {"job_title": "ESG Reporting Analyst", "year_posted": 2025}
  ],
  "coverage": {
    "description_text_sample_pct": 85.0,
    "note": "Archive coverage grows with Hirebase's own crawl footprint: it is dense from 2025 and sparse before that..."
  },
  "export_quote": {
    "record_count": 3096,
    "price_usd": 182.88,
    "tiers": "$0.12/record for the first 1,000; $0.03 for the next 9,000; $0.01 for the next 90,000; $0.001 thereafter. $0.50 minimum."
  }
}