Host a Public Job Listing Board via the API
Overview
You can easily build a public job board and host it directly on your university website by pulling position data from Interfolio’s API. The API provides a single endpoint that returns all the information you need about positions published in Interfolio Faculty Search. The endpoint returns a current listing of open positions, so the job listings are always up-to-date and accurate. Simply parse the data returned from the API and format it for display as a web page.
Prerequisites
The institution will need to create positions suitable for public advertising within Faculty Search and mark them as “published.”
Host a Public Job Listing Board via the API
Implement a Dynamic Job Board Using the API
The first step in implementing a dynamic job board is to examine the available data and determine what elements you would like to use in each position listing on your job board website. You may then design HTML and CSS appropriate for your institution, programmatically call the Interfolio API endpoint, parse the available fields, and insert them into your design. Use the Position’s Public Landing Page link to direct applicants to further information on how to apply. The Job Board API has a number of pagination features you can use to help organize and filter your position lists.
Examples:
This action will return the first page of 10 positions, beginning with the closest deadline:
GET => /public_job_boards?limit=10&page=1&sort_order=desc&sort_by=deadlineThis action will return the second page of 5 positions containing the string “Tenure Track” in the “name” field:
GET => /public_job_boards?limit=5&page=2&search=Tenure%20TrackThis action will return the first page of up to 25 positions that have “Department of History” in the “unit_name” field:
GET => /public_job_boards?unit_name=Department%20of%20HistoryView Public Job Board
This action will return a paginated “results” array containing a list of positions that meet the basic open criteria; meaning the position has “open: true”, “archived: false”, and “published: true”. Each position will contain basic information and a “legacy_position_id”. The endpoint will also return your institution’s EEO statement, a total position count, and a list of units at which there are open positions.
Action: GET => /byc-search/{tenant_id}/public_job_boards
Required parameters: “tenant_id” (path)
Optional parameters: “limit”, “page”, “sort_order”, “sort_by”, “unit_name” “search” (path, query)
You can access the public landing page for any position listed on your public job board by following the above URL pattern. Using “legacy_position_id”, you can build a hyperlink to the public landing page.
Check out the Job Board API documentation for more information.