Authentication

Every API request requires authentication

All job, company, and export endpoints require an API key on every request, including the first page of results. Requests without a key return 401.

curl -X POST https://api.hirebase.org/v2/jobs/search \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"job_titles": ["Software Engineer"], "limit": 10}'

Only reference-data endpoints (GET /v2/jobs/data/categories, industries, subindustries) remain accessible without a key.

Getting Your API Key

Create an account at hirebase.org/signup.
Find your key under Profile → API Key at hirebase.org.
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

All data endpoints require authentication on every request. That includes job search (keyword, vector, and neural), job detail, company search and detail, expired jobs, exports, insights, and all resume/embedding and task endpoints.

Error Responses

Unauthorized

No key or Authorization header at all (most endpoints, e.g. POST /v2/jobs/search):

{ "detail": "Missing authorization header" }

Returned by expired jobs, exports, and insights endpoints when no key is provided:

{ "detail": "Sign in to access this endpoint" }

Invalid or revoked key:

{ "detail": "Invalid API key" }

Which body you get depends on the endpoint — treat any 401 as “authenticate and retry”."Sign in to access this endpoint" responses also carry the header X-Billing-Code: auth_required, which you can branch on instead of string-matching the detail message. ("Missing authorization header" responses do not include it.)

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;
};

Getting Started

Guides

Every API request requires authentication

Getting Your API Key

Endpoints That Always Require a Key

Error Responses

Example Request with Authentication

​Every API request requires authentication

​Getting Your API Key

​Endpoints That Always Require a Key

​Error Responses

​Example Request with Authentication

Every API request requires authentication

Getting Your API Key

Endpoints That Always Require a Key

Error Responses

Example Request with Authentication