Search Jobs

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

Show child attributes

city

string

City name

region

string

State, region, or province

country

string

Country name

geofilter_params

object[]

Array of location objects with city, region, and country

Show child attributes

mode

string

Filtering mode for geographic search; ‘auto’, ‘weak’, ‘strict’, ‘box’ (defaults to: ‘auto’).

Weak: uses coordinate based matching
Strict: uses exact matching
Box: uses bounding box matching
Auto: uses heuristics to pick the optimal matching mechanism (recomended)

radius

float

Search radius for geographic filtering (defaults to 25.0)

unit

string

Units for radius; ‘mi’, ‘km’, ‘degrees’ (defaults to: ‘mi’)

experience

string[]

Array of experience levels (e.g., “Entry”, “Mid”, “Senior”)

yoe

object

Years of experience range object

Show child attributes

min

number

Minimum years of experience

max

number

Maximum years of experience

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

Show child attributes

min

number

Minimum salary

max

number

Maximum salary

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

Show child attributes

_id

string

Unique identifier for the job

job_title

string

Title of the job

description

string

Full job description in HTML or plain text format

application_link

string

URL where candidates can apply for the job

job_categories

array

Categories or tags associated with the job posting (e.g., “Engineering”, “Design”)

job_type

string

Type of job, such as “Full Time”, “Part-time”, or “Contract”

location_type

string

Work arrangement, such as “Remote”, “Hybrid”, or “In-Person”

locations

array

Array of location objects

Show child attributes

city

string

Name of the city

region

string

Name of state or province

country

string

Name of the country

coordinates

GeoJSON

Coordinates (long/lat) in GeoJSON format

bbox

float[]

Bounding Box (x1, y1, x2, y2) of the location region it encompasses

address

string

Normalized geographical address based on Nominatim API

salary_range

object|null

Salary range offered for the job. May be null if not specified

Show child attributes

min

number

Minimum salary

max

number

Maximum salary

currency

string

Currency code (e.g., USD, CAD)

period

string

Salary period (e.g., year, month)

yoe_range

object

Required years of experience

Show child attributes

min

number

Minimum years of experience

max

number

Maximum years of experience

requirements_summary

string

Brief summary of key requirements or qualifications for the job

visa_sponsored

boolean

Indicates whether the job supports visa sponsorship

recruiter_ageny

boolean

Indicates whether the job supports visa sponsorship

skills

string[]

List of skills mentioned in the job description

team

string

Team at the company hiring for the position

technologies

string[]

List of technologies mentioned in the job description

benefits

string[]

List of benefits mentioned in the job description

benefits

string[]

List of benefits mentioned in the job description

education_level

string

Level of education required for the job

date_posted

string

The date when the job was posted. Format: YYYY-MM-DD

job_board

string

The name of the job board from which the listing was sourced (e.g., “iCIMS”)

language

string

Language the job posting is in

job_board_link

string

URL of the job board hosting the listing

job_slug

string

URL-friendly identifier for the job (used in deep-linking)

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

company_logo

string

URL to the company’s logo image

company_data

object

Enriched company profile details

Show child attributes

description_summary

string

Short description about the company’s mission or services

linkedin_link

string | null

Link to the company’s LinkedIn profile

services

string[]

List of services that the company provides

size_range

object | null

Approximate number of employees

Show child attributes

min

number

Minimum number of employees

max

number

Maximum number of employees

industries

array

List of industries the company belongs to (e.g., “Design”, “Healthcare”)

subindustries

array

More specific categories under the industry (e.g., “Architecture”)

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

422 Unprocessable Entity Error

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.

500 Internal Server Error

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.

Jobs API

Companies API

Resume (Embeddings) API

Tasks API

Error Handling

Endpoint

Request Body

Response

Example Request

Example Response

Error Responses

Jobs API

Companies API

Resume (Embeddings) API

Tasks API

Error Handling

​Endpoint

​Request Body

​Response

​Example Request

​Example Response

​Error Responses

Endpoint

Request Body

Response

Example Request

Example Response

Error Responses