Job Search

Searches and recommends jobs for job seekers based on their work history, education, skills.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
enum
Defaults to en-US
integer
0 to 100
Defaults to 5

The number of skills returned for each occupation.

integer
Defaults to 0

Number of rows/recommendations to exclude from the beginning of the ordered results set.

integer
0 to 100
Defaults to 10

Number of rows/recommendations to include in the results set.

string
required
posting_status
array

The status of the job posting. Values: ACTIVE, INACTIVE. Returns all if null.

posting_status
string

The desired job title. Results will consider the specified job title and/or the candidate's profile, depending on what is provided.

number
Defaults to 0.7

Include results with this match score or higher. Score must be between 0 and 1 inclusive. Defaults to 0.7.

integer

The maximum number of days since the job was posted.

internship_options
array

Whether to include internships and/or non-internships in results. Values: INTERNSHIP NON_INTERNSHIP. Returns all if null.

internship_options
job_type
array
job_type
onet_2019_codes
array of strings | null

Only include jobs classified as one of the provided ONET 2019 occupations. (AdeptID defines the O*NET classification during job posting creation.)

onet_2019_codes
location
object

The location to search within. Requires a state and country. Optionally include a city and radius (in miles) for geo-distance filtering; otherwise, filters by state. For multi-state filtering, use the states parameter instead.

states
array of strings
length ≤ 10

Two-letter US state abbreviations to filter jobs by (e.g. ["CA", "NY"]). Results include jobs located in any of the specified states. Cannot be combined with the location parameter.

states
employment_location_type
array
employment_location_type
enum
Defaults to REMOTE_FLEXIBLE

Controls how the location or states filter interacts with the employment_location_type filter. Only meaningful when a location or states filter is provided. Defaults to REMOTE_FLEXIBLE. STRICT: jobs of every requested type must match the location or state filter. REMOTE_FLEXIBLE: IN_PERSON and HYBRID jobs must match the location or state filter; REMOTE jobs are included from any location. FULLY_FLEXIBLE: Only IN_PERSON jobs must match the location or state filter; REMOTE and HYBRID jobs are included from any location.

Allowed:
salary
object

The salary requirements for the search.

shift
object

The timing requirements of the shift.

employment_term
object

The dates of employment.

years_of_experience
object

The range of years of experience the job requires.

education_levels
array of strings

Array of strings representing canonical degree levels. Results include jobs that specify any included degree level as the minimum required level of education. Include “UNKNOWN” to include jobs without a specified minimum in results.

education_levels
custom_filters
object

Filter on customer-defined fields. Each field accepts an array of values; a job matches if its stored value matches any of the provided values (case-insensitive). When multiple fields are specified, all must match (AND across fields).

candidate
object

AdeptID's standard Candidate object. Describes the job seeker to be matched to job and career opportunities.

sort_by
array of arrays of strings
length ≤ 10
Defaults to match_score,desc

List of [field_name] or [field_name, sort_order] pairs for hierarchical sorting. Results are sorted by the first field, then within those groups by the second field, etc. If sort_order is omitted, a sensible default will be used for each field. Valid fields: employer_name, employment_term.date_start, employment_term.duration, location.city, location.state, match_score, match_score_category, posting_date, salary.min, shift.type, years_of_experience.min. Custom attribute fields use the pattern 'custom_attributes.your_field_name'. (Case Sensitive)Custom filter fields: custom_filters.string_1, custom_filters.string_10, custom_filters.string_2, custom_filters.string_3, custom_filters.string_4, custom_filters.string_5, custom_filters.string_6, custom_filters.string_7, custom_filters.string_8, custom_filters.string_9. Valid orders: asc, desc. Example: [["match_score_category"], ["posting_date", "desc"], ["match_score"]]

sort_by
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json