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.

Try it free — no key needed

All search endpoints return the first page of results without an API key, so you can test the API immediately. To access page 2 and beyond, include your free API key in the x-api-key header.
curl -X POST https://api.hirebase.org/v2/jobs/search \
  -H "Content-Type: application/json" \
  -d '{"job_titles": ["Software Engineer"], "limit": 10}'

Getting Your API Key

  1. Create an account at hirebase.org/signup.
  2. Find your key under Profile → API Key at hirebase.org.
  3. Include it in the x-api-key header on any request.
All requests should be made to the base URL:
https://api.hirebase.org/

Endpoints That Always Require a Key

Some endpoints require authentication on every request — even for the first page of results:
  • GET /v2/jobs/expired-jobs
  • POST /v2/jobs/export
  • All resume/embedding, task, and paid-feature endpoints

Error Responses

401
Unauthorized
Missing key on page 2+ or on an endpoint that always requires auth:
{ "detail": "Missing authorization header" }
Invalid or revoked key:
{ "detail": "Invalid API key" }

Example Request with Authentication

const fetchJobs = async () => {
  const response = await fetch('https://api.hirebase.org/v2/jobs/search', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      job_titles: ['Software Engineer'],
      limit: 10,
      page: 2,
    }),
  });

  const data = await response.json();
  return data;
};