Developers Guide to Job Feed APIs

For deeper integration with your company's website or application, on paid plans, Jobscore provides an API for accessing your company's Job feed. The information that follows is designed to aid a developer in successful integration.

Jobscore provides your company's job feed in multiple industry standard formats for consumption by a wide array of programming languages and parsing libraries. You can request the feed results in JSON, JSONP, XML, or a legacy ATOM format (deprecated).

Job feed URLs can be found in Jobscore by visiting Admin > Careers Site and looking for the 'Build your own custom careers site using the Job Feed API' link.

The JSON/JSONP and XML feeds contain an easy to parse listing of each of the open jobs. Note that only 'published' jobs will appear in your company's job feed. Unpublished jobs will remain hidden in both the careers site and the job feeds.

Because the job description can contain HTML in the XML and ATOM feeds the contents of the job 'description' field are HTML encoded and may need to be HTML decoded to render properly in your integration. For JSON/JSONP the raw HTML is passed as a string. No decoding is necessary.

Sorting and Filtering:

The job feeds allow you to sort in forward or reverse alpha and also filter jobs by department.

Sorting ('sort' parameter)

You can sort the feed output by a number of fields in alphabetical and reverse alphabetical order.

An example of sorting by department might be:

https://careers.jobscore.com/jobs/yourco/feed.json?sort=department_reverse

Filtering by Department ('departments' parameter):

The feed also allows filtering by a single department or multiple departments (comma separated). An example of filtering by engineering and marketing might be:

https://careers.jobscore.com/jobs/yourco/feed.json?departments=marketing,engineering

Note the filter is 'departments' (plural) even if there's only 1 department being filtered.

Limiting the number of returned jobs ('limit' parameter)

You can limit the number of returned jobs by adding an 'limit' URL parameter. In the example below, we're requesting only the first 10 jobs from the marketing department:

https://careers.jobscore.com/jobs/yourco/feed.json?departments=marketing&limit=10

Rate Limits on Polling

Job feeds are generally slow changing lists that rarely change faster than once per day for most companies. We suggest limiting polling to once per day. If your application needs to be more up to date you may poll up to once per hour. If we detect polling more frequently than once per hour we may disable feed access to your account. Please contact 'support@jobscore.com' if you have an application requirement that needs more frequent polling than once per hour.

Using Custom Job Fields 

You can use job fields to customize the information shown on your careers site. Any custom job fields you want to use must have "Confidential" set to "No" and "Include in Feed" to "Yes" for the custom field name and value to be visible in the job feed.

For example, if you want to create a landing page that highlights specific new/high-priority jobs, you could create a multiple choice job field called "Highlighted" with the choices "Yes" and "No", and filter results in your client code for jobs where the "Highlighted" value is "Yes".  A "Yes" value on a job would appear in the (JSON) job record as:

"custom_fields": [{"label":"Highlighted","content":"Yes"}]

Other Examples

Let's say you wanted to get a JSON feed to integrate, that only lists the 8 most recently opened 8 jobs, sorted by date. Use the following URL:

https://careers.jobscore.com/jobs/yourco/feed.json?sort=date&limit=8

(change the '.json' to '.xml' if you wanted XML data)

Each job block in the data looks like:

JSON object (we're only listing 1 job for sake of clarity):

{"publisher":"JobScore","title":"Careers at Yourcompany,
Inc.","publisher_url":"http://www.jobscore.com","jobs":[{"description":"...full
html job description here...","opened_date":"2011-11-29T23:14:53Z","city":"Redwood City","department":"Administrative","location":"Redwood City, CA","postal_code":"94063","title":"Contracts Administrator","country":"US","state":"CA","apply_url":"http://www.jobscore.com/job_seeker/jobs/apply_jump_page?job_id=xxx","detail_url":"http://www.jobscore.com/job_seeker/jobs/job_posting?job_id=xxxxx","last_updated_date":"2011-12-07T03:05:54Z","id":"xxxxxxxxx","custom_fields":[{"label":"Your Custom Field","content":"Custom Field Content"}]}],"company":"Yourcompany, Inc.","company_url":"http://www.yourcompany.com"}

If you looped over the embedded 'jobs' array, you could extract 'title', 'location' and the 'detail_url'.

The XML format is similar to the JSON structure but with a root element of 'jobfeed' and the 'description' element is HTMLencoded because it may contain HTML. An example response (again, only listing 1 job):

<jobfeed>
<publisher>JobScore</publisher>
<title>Careers at Yourcompany, Inc.</title>
<publisher_url>http://www.jobscore.com</publisher_url>
<jobs type="array">
<job>
<description>
...html job description text here...
</description>
<opened_date type="datetime">2011-11-29T23:14:53Z</opened_date>
<city>Redwood City</city>
<department>Administrative</department>
<location>Redwood City, CA</location>
<postal_code>94063</postal_code>
<title>Contracts Administrator</title>
<country>US</country>
<state>CA</state>
<apply_url>
http://www.jobscore.com/job_seeker/jobs/apply_jump_page?job_id=xxxxxxx
</apply_url>
<detail_url>
http://www.jobscore.com/job_seeker/jobs/job_posting?job_id=xxxxxxxxx
</detail_url>
<last_updated_date type="datetime">2011-12-07T03:05:54Z</last_updated_date>
<id>xxxxxxx</id>
<custom_fields type="array">
<custom_field>
<label>Your Custom Field</label>
<content>Custom Field Content</content>
</custom_field>
</custom_fields>
</job>
</jobs>
<company>Yourcompany, Inc.</company>
<company_url>http://www.yourcompany.com</company_url>
</jobfeed>