Skip to main content
POST
/
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>"
  ],
  "job_slug": "<string>",
  "location_group": "<string>",
  "location_types": [
    "<string>"
  ],
  "locations": [
    {
      "city": "<string>",
      "region": "<string>",
      "country": "<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>"
  ],
  "date_posted": "<string>",
  "visa": "<string>",
  "sort_by": "<string>",
  "sort_order": "<string>",
  "score": 123,
  "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>"
        }
      ],
      "salary_range": {
        "min": 123,
        "max": 123,
        "currency": "<string>",
        "period": "<string>"
      },
      "yoe_range": {
        "min": 123,
        "max": 123
      },
      "requirements_summary": "<string>",
      "visa_sponsored": true,
      "date_posted": "<string>",
      "job_board": "<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": {},
    "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.

​
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
​
job_slug
string
Filter by the unique job slug (used for deep linking or targeting specific jobs).
​
location_group
string
Predefined geographic area (e.g., “Bay_Area”)
​
location_types
string[]
Array of work arrangements (e.g., “Remote”, “Hybrid”, “On-site”, “In-Person”)
​
locations
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.
​
date_posted
string
The date when the job was posted. Format: YYYY-MM-DD
​
visa
string
Filter for jobs that offer visa sponsorship (“true” or “false”)
​
sort_by
string
Field to sort results by (e.g., “relevance”, “date posted”, “salary”)
​
sort_order
string
Sort direction (“asc” or “desc”)
​
score
float
Minimum similarity score to include in results
Note:Higher similarity scores indicate stronger semantic matches.
​
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)
​
company_link
string
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_group": "Bay_Area",
  "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.