The FlexJobs job feed application downloads job feed files (typically in XML format) from web and ftp sites, automatically parses jobs from the retrieved file, compares them to various filters to determine if the job meets our criteria for a 'flexible' job and, if so, places the job into a queue that is manually reviewed by our job researches before final posting to our website.

In the case of Greenhouse, we request a job feed file using the Greenhouse Job Board API. This API provides a JSON representation of all the jobs in your system for a specific company. To isolate the specific company in your Job Board API, we need to know the Job Board API token assigned to each company that we interact with.

Retrieve Greenhouse job board token

Navigate to the job board that you want to track and choose the ellipses icon on the right side of the page. (Configure  icon Job Boards Posts Ellipses  icon)

Choose Edit Board Settings from the dropdown menu.

Navigate to the URL section of the page, and copy the information in the text field.

Provide the token URL to FlexJobs.

Using that token, we pull job data from a url in the format:

https://api.greenhouse.io/v1/boards/TOKEN/jobs?content=true (for example: https://api.greenhouse.io/v1/boards/studentloanhero/jobs?content=true)

The URL must include ?content=true at the end so that the data returned includes job description content. Once the JSON data for that company has been retrieved, we internally convert that to an XML file and pass it through the process described above.