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.
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.
Accessing Careers Site data via API will need authentication through API key which will be provided to you by your Simplicant contact.
You can access below information using the careers site API.
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 Method | Jobs Listing URL |
| GET | https://{company_subdomain}.simplicant.com/api/v1/jobs |
URL Configuration
| Parameter | Description |
| company_subdomain | Unique 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 Method | Jobs Detail URL |
| GET | https://{company_subdomain}.simplicant.com/api/v1/jobs/{job_id} |
URL Configuration
| Parameter | Description |
| company_subdomain | Unique Careers Site subdomain |
| job_id | Unique job identifier |
| questions (optional) | If set to 1, include additional fields in the response |
Job Questions
Allowed question types in the application form:
| Type | Description |
| textinput | field for single line text |
| textarea | field for paragraph text |
| radiobutton | multiple values shown via radio buttons |
| select | multiple values via drop-down |
| date | date text field |
| checkbox | multiple values shown via check-boxes |
| fileinput | Unique job identifier |
| address | drop-down fields to pick address location |
1. Get Locations listing
Returns the list of all your organization’s jobs, grouped by locations.
API Call
| HTTP Request Method | Locations Listing URL |
| GET | https://{company_subdomain}.simplicant.com/api/v1/locations |
URL Configuration
| Parameter | Description |
| company_subdomain | Unique 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 Method | Locations Detail URL |
| GET | https://{company_subdomain}.simplicant.com/api/v1/locations/{location_id} |
URL Configuration
| Parameter | Description |
| company_subdomain | Unique Careers Site subdomain |
| location_id | Unique location identifier |
1. Get Departments listing
Returns the list of all your organization’s jobs, grouped by departments.
API Call
| HTTP Request Method | Departments Listing URL |
| GET | https://{company_subdomain}.simplicant.com/api/v1/departments |
URL Configuration
| Parameter | Description |
| company_subdomain | Unique 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 Method | Departments Detail URL |
| GET | https://{company_subdomain}.simplicant.com/api/v1/departments/{department_id} |
URL Configuration
| Parameter | Description |
| company_subdomain | Unique Careers Site subdomain |
| department_id | Unique department identifier |
1. Get Job Groups listing
Returns the list of all your organization’s jobs, grouped by Job Groups.
API Call
| HTTP Request Method | Job Groups Listing URL |
| GET | https://{company_subdomain}.simplicant.com/api/v1/job_groups |
URL Configuration
| Parameter | Description |
| company_subdomain | Unique 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 Method | Job Group Detail URL |
| GET | https://{company_subdomain}.simplicant.com/api/v1/job_groups/{job_group_id} |
URL Configuration
| Parameter | Description |
| company_subdomain | Unique Careers Site subdomain |
| job_group_id | Unique job group identifier |