Skip to main content
POST
https://api.hirebase.org
/
v2
/
jobs
/
search
Search Jobs
curl --request POST \
  --url https://api.hirebase.org/v2/jobs/search \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_titles": [
    "<string>"
  ],
  "keywords": [
    "<string>"
  ],
  "company_keywords": [
    "<string>"
  ],
  "job_slug": "<string>",
  "location_types": [
    "<string>"
  ],
  "geo_locations": [
    {
      "city": "<string>",
      "region": "<string>",
      "country": "<string>"
    }
  ],
  "geofilter_params": [
    {
      "mode": "<string>",
      "radius": 123,
      "unit": "<string>"
    }
  ],
  "experience": [
    "<string>"
  ],
  "yoe": {
    "min": 123,
    "max": 123
  },
  "job_type": [
    "<string>"
  ],
  "job_board": [
    "<string>"
  ],
  "company_name": "<string>",
  "company_slug": "<string>",
  "salary": {
    "min": 123,
    "max": 123
  },
  "industry": [
    "<string>"
  ],
  "sub_industry": [
    "<string>"
  ],
  "days_ago": 123,
  "visa": "<string>",
  "hide_recruiting_agencies": "<string>",
  "return_raw_description": "<string>",
  "sort_by": "<string>",
  "sort_order": "<string>",
  "page": 123,
  "limit": 123
}
'
{
  "jobs": [
    {
      "_id": "<string>",
      "job_title": "<string>",
      "description": "<string>",
      "application_link": "<string>",
      "job_categories": [
        {}
      ],
      "job_type": "<string>",
      "location_type": "<string>",
      "locations": [
        {
          "city": "<string>",
          "region": "<string>",
          "country": "<string>",
          "coordinates": {},
          "bbox": [
            123
          ],
          "address": "<string>"
        }
      ],
      "salary_range": {
        "min": 123,
        "max": 123,
        "currency": "<string>",
        "period": "<string>"
      },
      "yoe_range": {
        "min": 123,
        "max": 123
      },
      "requirements_summary": "<string>",
      "visa_sponsored": true,
      "recruiter_ageny": true,
      "skills": [
        "<string>"
      ],
      "team": "<string>",
      "technologies": [
        "<string>"
      ],
      "benefits": [
        "<string>"
      ],
      "education_level": "<string>",
      "date_posted": "<string>",
      "job_board": "<string>",
      "language": "<string>",
      "job_board_link": "<string>",
      "job_slug": "<string>"
    }
  ],
  "company_name": "<string>",
  "company_slug": "<string>",
  "company_link": "<string>",
  "company_logo": "<string>",
  "company_data": {
    "description_summary": "<string>",
    "linkedin_link": {},
    "services": [
      "<string>"
    ],
    "size_range": {
      "min": 123,
      "max": 123
    },
    "industries": [
      {}
    ],
    "subindustries": [
      {}
    ]
  },
  "meta": {
    "count.lowerBound": 123,
    "score": 123,
    "total_count": 123,
    "company_count": 123,
    "page": 123,
    "limit": 123,
    "total_pages": 123
  }
}
Search for jobs using common filters such as job titles, experience level, salary range, etc., in the JSON request body. The easiest way to start using our API is to use our Export button on our Search Page, this allows you to edit the tune the request using our Job Filters UI and easily export as a Javascript or cURL request.

Endpoint

POST /v2/jobs/search

Request Body

Note:
  • All request body fields are optional.
  • Filter combinations can be mixed and matched.
  • Use specific filters to narrow down search results and obtain relevant matches.
job_titles
string[]
Array of job titles to search for
keywords
string[]
Array of keywords to match in job descriptions, techonologies, skills, and benefits
company_keywords
string[]
Array of keywords to match in company descriptions, services, and products
job_slug
string
Filter by the unique job slug (used for deep linking or targeting specific jobs).
location_types
string[]
Array of work arrangements (e.g., “Remote”, “Hybrid”, “On-site”, “In-Person”)
geo_locations
object[]
Array of location objects with city, region, and country
geofilter_params
object[]
Array of location objects with city, region, and country
experience
string[]
Array of experience levels (e.g., “Entry”, “Mid”, “Senior”)
yoe
object
Years of experience range object
job_type
string[]
Array of job types (e.g., “Full Time”, “Contract”)
job_board
string[]
Filter by the source job board (e.g., “iCIMS”, “Lever”, “Greenhouse”).
company_name
string
Filter by specific company name
company_slug
string
Filter by the unique company slug (used for deep linking or specific company targeting).
salary
object
Salary range object
industry
string[]
Filter by industry sector. Can be a single string or an array of strings.
sub_industry
string[]
Filter by more specific industry category. Can be a single string or an array of strings.
days_ago
int
How many days ago to filter for. Days Ago set to 3 will return jobs posted on and after 3 days ago.
visa
string
Filter for jobs that offer visa sponsorship (“true” or “false”)
hide_recruiting_agencies
string
Filter out annoying recruiter agency repostings (“true” or “false”)
return_raw_description
string
Returns the raw description of the jobs (HTML)
sort_by
string
Field to sort results by (e.g., “relevance”, “date posted”, “salary”)
sort_order
string
Sort direction (“asc” or “desc”)
page
number
default:"1"
Page number for pagination
limit
number
default:"10"
Number of results per page
Note:The pagination (page and limit) fields control the number of results returned and which subset of results is displayed.

Response

jobs
array
Array of job objects
company_name
string
Name of the hiring company
company_slug
string
URL-friendly identifier for the company (used in deep-linking)
Official website of the company
URL to the company’s logo image
company_data
object
Enriched company profile details
meta
object
Metadata related to the job listing

Example Request

{
  "job_titles": ["Site/Civil Engineer"],
  "keywords": ["Graphics", "Exhibits", "Civil Engineering"],
  "location_types": ["Hybrid", "In-Person"],
  "geo_locations": [{"city": "Richmond", "region": "Virginia", "country": "United States"}],
  "experience": ["Entry"],
  "yoe": {"min": 1, "max": 6},
  "company_name": "CompanyXYZ",
  "salary": {"min": 80000, "max": 120000},
  "job_type": ["Full Time"],
  "industry": ["Design, Construction"],
  "sub_industry": ["Architecture", "Building Construction"],
  "visa": "true",
  "sort_by": "relevance",
  "sort_order": "desc",
  "page": 1,
  "limit": 10
}

Example Response

{
    "jobs": [
        {
            "_id": "6814bw99fc2284gt4777f21a",
            "company_name": "CompanyXYZ",
            "job_title": "Site/Civil Engineer",
            "description": "<p>CompanyXYZ is seeking a Site/Civil Project Engineer for our Richmond, Virginia office. The individual will be part of a growing team that provides comprehensive civil engineering services to public and private sector clients. The role requires subject matter knowledge and experience to move projects from concept to completion.</p><h2>Requirements</h2><ul><li>BS Degree in Civil Engineering or related field.</li><li>Minimum of 1-6 years of experience in civil design of land development activities.</li><li>PE in the Virginia preferred.</li><li>Proficient in preparation of graphics, exhibits and Site/Civil Construction Plans.</li><li>Strong technical capabilities in various Software Applications.</li><li>Excellent written and verbal communication skills.</li><li>Ability to become proficient in CompanyXYZ engineering practices, standards, and CompanyXYZ-specific software programs</li></ul><h2>Benefits</h2><ul><li>The opportunity to collaborate with the best and brightest and work on innovative and complex projects at the forefront of the industry.</li><li>A commitment to excellence stemming from personal integrity and other defining attributes.</li><li>The chance to grow and develop as a professional in a dynamic and supportive work environment.</li></ul>",
            "application_link": "https://careers-companyxyz.icims.com/jobs/13876/site-civil-engineer/job",
            "job_categories": [
                "Other"
            ],
            "job_type": "Full Time",
            "location_type": "In-Person",
            "yoe_range": {
                "min": 1,
                "max": 6
            },
            "salary_range": null,
            "date_posted": "2024-12-17",
            "company_link": "https://www.companyxyz.com",
            "company_logo": "https://c-1720-20210302-www-companyxyz-com.i.icims.com/images/default-source/site-assets/logos/companyxyz-logo.png?sfvrsn=ga8ga825_0",
            "job_board": "iCIMS",
            "job_board_link": "https://careers-companyxyz.icims.com",
            "requirements_summary": "BS in Civil Engineering, 1-6 years of experience, PE in Virginia preferred",
            "visa_sponsored": false,
            "company_data": {
                "description_summary": "CompanyXYZ provides professional services, creating innovative solutions for built and natural environments nationwide.",
                "linkedin_link": "https://www.linkedin.com/company/companyxyz",
                "size_range": {
                    "min": 1001,
                    "max": 5000
                },
                "industries": [
                    "Design",
                    "Construction"
                ],
                "subindustries": [
                    "Architecture",
                    "Building Construction"
                ]
            },
            "company_slug": "companyxyz",
            "job_slug": "site-civil-engineer-17",
            "locations": [
                {
                    "city": "Richmond",
                    "region": "Virginia",
                    "country": "United States"
                }
            ],
            "meta": {
                "count": {
                    "lowerBound": 1
                }
            },
            "score": 13.449975967407227
        }
    ],
    "total_count": 1,
    "company_count": 1,
    "page": 1,
    "limit": 10,
    "total_pages": 1
}

Error Responses

Returns when the request contains invalid or improperly formatted data. Some possible reasons may include the following:
  • When the industry field is missing, not a string, or doesn’t match any value from the list of valid industries.
  • If sub_industry is not a valid string from the list of allowed sub-industries.
  • JSON decoding errors, such as malformed JSON or incorrect data types in the request body.
Returns when an unexpected error occurs on the server.
  • Also occurs during unhandled server-side failures or bugs that prevent the request from being processed.