API Resources

Simplicant is the leading social recruiting platform and applicant tracking system built from the ground up to harness the power of the newest and most effective paradigms in talent acquisition, recruitment marketing, employee referrals and applicant tracking combined in one complete and integrated social recruitment management system.

Careers Site API

With Simplicant’s careers site API, a business can build and manage their own careers site, complete with custom styles and page structures. To have careers site API option added to your plan, please contact us for more information.

With our Careers Site API, you will be able to access a simple JSON representation of all of your company’s published jobs, locations and departments. Using this data, you can build your own careers site pages with your company branding as well as construct department or location focused pages or microsites etc.

Authentication

Accessing Careers Site data via API will need authentication through API key which will be provided to you by your Simplicant contact.

Careers Site API categories

You can access below information using the careers site API.

JOBS

1. Get Jobs listing

Returns the list of all your organization’s published jobs. The id field contains the unique identifier for the job opening, while requisition_ id contains the unique identifier for the job itself.

API Call

HTTP Request MethodJobs Listing URL
GEThttps://{company_subdomain}.simplicant.com/api/v1/jobs
 

URL Configuration

ParameterDescription
company_subdomainUnique Careers Site subdomain
description (optional)If set to 1, include job description field in the response
 

2. Get Job detail

Returns a published job. This will include the individual job details along with questionnaire for the specific job.

API Call

HTTP Request MethodJobs Detail URL
GEThttps://{company_subdomain}.simplicant.com/api/v1/jobs/{job_id}
 

URL Configuration

ParameterDescription
company_subdomainUnique Careers Site subdomain
job_idUnique job identifier
questions (optional)If set to 1, include additional fields in the response
 

Job Questions

Allowed question types in the application form:

TypeDescription
textinputfield for single line text
textareafield for paragraph text
radiobuttonmultiple values shown via radio buttons
selectmultiple values via drop-down
datedate text field
checkboxmultiple values shown via check-boxes
fileinputUnique job identifier
addressdrop-down fields to pick address location
 

LOCATIONS

1. Get Locations listing

Returns the list of all your organization’s jobs, grouped by locations.

API Call

HTTP Request MethodLocations Listing URL
GEThttps://{company_subdomain}.simplicant.com/api/v1/locations
 

URL Configuration

ParameterDescription
company_subdomainUnique Careers Site subdomain
 

2. Get Locations detail

Returns the list of all your organization’s published jobs for the given location id.

API Call

HTTP Request MethodLocations Detail URL
GEThttps://{company_subdomain}.simplicant.com/api/v1/locations/{location_id}
 

URL Configuration

ParameterDescription
company_subdomainUnique Careers Site subdomain
location_idUnique location identifier
 

DEPARTMENTS

1. Get Departments listing

Returns the list of all your organization’s jobs, grouped by departments.

API Call

HTTP Request MethodDepartments Listing URL
GEThttps://{company_subdomain}.simplicant.com/api/v1/departments
 

URL Configuration

ParameterDescription
company_subdomainUnique Careers Site subdomain
 

2. Get Department detail

Returns the list of all your organization’s published jobs for the given department id.

API Call

HTTP Request MethodDepartments Detail URL
GEThttps://{company_subdomain}.simplicant.com/api/v1/departments/{department_id}
 

URL Configuration

ParameterDescription
company_subdomainUnique Careers Site subdomain
department_idUnique department identifier
 

JOB GROUPS

1. Get Job Groups listing

Returns the list of all your organization’s jobs, grouped by Job Groups.

API Call

HTTP Request MethodJob Groups Listing URL
GEThttps://{company_subdomain}.simplicant.com/api/v1/job_groups
 

URL Configuration

ParameterDescription
company_subdomainUnique Careers Site subdomain
 

2. Get Job Group detail

Returns the list of all your organization’s published jobs for the given job group id.

API Call

HTTP Request MethodJob Group Detail URL
GEThttps://{company_subdomain}.simplicant.com/api/v1/job_groups/{job_group_id}
 

URL Configuration

ParameterDescription
company_subdomainUnique Careers Site subdomain
job_group_idUnique job group identifier