Skip to main content

​
Prerequisites

Before you begin, make sure you have:
  1. Created a Hirebase account
  2. Set up authentication credentials
  3. Basic knowledge of making HTTP requests

​
Making Your First Request

Let’s start by searching for software engineering jobs in the Bay Area: 
const fetchJobs = async () => {
  const response = await fetch('https://api.hirebase.org/v2/jobs/search', {
    method: 'GET',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'YOUR_API_KEY',
    },
  });
  
  const data = await response.json();
  console.log(data);
};

fetchJobs();

​
Expected Response

{
  "jobs": [
    {
      "_id": "6123456789abcdef01234567",
      "company_name": "TechCorp",
      "job_title": "Software Engineer",
      "description": "We're looking for a talented Software Engineer...",
      "location_type": "Hybrid",
      "locations": [
        {
          "city": "San Francisco",
          "region": "CA",
          "country": "United States"
        }
      ],
      "salary_range": {
        "min": 120000,
        "max": 170000,
        "currency": "USD"
      }
    },
	// More job objects ...
  ],
  "total_count": 342,
  "company_count": 85,
  "page": 1,
  "limit": 5,
  "total_pages": 69
}

​
Next Steps

Now that you’ve made your first request, explore these resources to learn more:

Jobs Search Guide

Learn about all the search parameters and features

Company Data Guide

Discover how to work with company information

Jobs API Reference

View detailed API endpoint documentation

Companies API Reference

Explore company data endpoints