Authentication

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

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, "page": 2}'

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

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

Unauthorized

Missing key on page 2+:

{ "detail": "Sign in to view results beyond the first page" }

Missing key on an endpoint that always requires auth:

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

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

Getting Started

Guides

Try it free — no key needed

Getting Your API Key

Endpoints That Always Require a Key

Error Responses

Example Request with Authentication

​Try it free — no key needed

​Getting Your API Key

​Endpoints That Always Require a Key

​Error Responses

​Example Request with Authentication

Try it free — no key needed

Getting Your API Key

Endpoints That Always Require a Key

Error Responses

Example Request with Authentication