Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.hirebase.org/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
v2.3.0 — April 2026

Quality-of-life release focused on richer job metadata, better filter ergonomics, and a free-tier developer experience.

​
🔓 Authentication

  • Free first page. All search endpoints now return the first page of results without an API key. Page 2+ (and always-authed endpoints like Expired Jobs, Export Jobs, Resume Embed, Task Status) still require a key in the x-api-key header.

​
🧠 Richer Job Metadata

  • New scoring fields on every job object: coolness_score, flexibility_score, compensation_value_score, benefits_score, impact_autonomy_score, prestige_score, growth_score, meta_targetability, meta_completeness.
  • New parsed fields: experience_level, skills, technologies, benefits, education_level, team, language, contact_email, contact_phone, recruiter_agency, expired.
  • return_raw_description: "true" now returns a description_raw field with the full original HTML from the ATS source.

​
🔍 Search API Enhancements

  • company_count added to the response alongside total_count / total_pages for unique-company rollups.
  • New filter parameters: location_group, company_types, date_posted, month, currency, include_expired, include_no_salary, include_yoe, hide_seen_jobs, filter_incomplete_jobs, job_category.
  • sort_by now accepts company and yoe in addition to relevance / date_posted / salary.
  • Experience levels standardized to Entry, Junior, Mid, Senior, Executive.
  • job_types replaces the previous job_type parameter (plural, array-valued).

​
🧩 Reference Data Endpoints

  • GET /v2/jobs/data/categories — canonical list of job category tags.
  • GET /v2/jobs/data/industries — canonical list of industries.
  • GET /v2/jobs/data/subindustries — canonical list of subindustries.

​
📚 Docs

  • Migrated configuration from mint.json to docs.json.
  • Expanded response schemas, OpenAPI spec, and working cURL examples across every endpoint.
  • Added an Expired Jobs API reference page.

​
v2.2.0

Location and keyword matching overhaul, plus new filter parameters to improve job filtering.

​
🔧 API & Developer Experience

  • Updated Endpoints:
  • /v2/jobs/neural-search for semantic search
  • /v2/jobs/search for text search
  • /v2/jobs/export for CSV/JSON export
  • v2/hirebase/companies/search for Company Search

​
Job Exports

  • Job Exports have been made into a service which you can now track via your settings.
  • Export data will last 30 days before deletion, see User Settings to view your exports.
  • Job Exports is now available via API.

​
🔍 Job Search Enhancements

  • Location Filtering: Geographic, text, and area-based matching via geofilter_params.
  • Hide Recruiter Agencies: Removes recruiting-agency posts from the search and export feeds via hide_recruiting_agencies.
  • Company filtering: Filter for company-specific data using company_keywords such as goods and services.

​
📚 Docs & Guides

  • Multi-language code examples.
  • Guides for search, subscriptions, and integration.
Note: Please report any issues directly to spencer@hirebase.org. We release bug-fix updates based on severity. For full documentation and support, visit the Hirebase API docs.