Submit a Job Feed

Would you like your jobs to appear in our search?

If you can provide us your website url and we can include them. See our FAQ or Feed Spec for more details. Ready to get started? Just fill out the form below and we'll get back with you to complete setup.

*required

verification image

Enter the characters shown in the image above:

Job Feed Specification

Contents
  1. 1. Summary
  2. 2. Data Fields
  3. 3. XML Formats
  4. 4. Delimited Formats
  5. 5. Character Encodings
  6. 6. Transport Methods
1. Summary

Simply Hired can accept incoming job feeds in either xml or delimited formats. We do not take RSS-XML feeds. This document will describe the data fields that we read, our standard xml format, what types of other xml formats can be mapped to ours, and delimited formats.

2. Data Fields

The fields that we accept are (organized by category):

General
  • title
  • job-code
  • job-board-name
  • job-board-url
  • detail-url
  • apply-url
  • posted-date
  • close-date
  • job-category
  • action
Description
  • summary
  • required-skills
  • required-education
  • required-experience
  • full-time
  • part-time
  • flex-time
  • internship
  • volunteer
  • exempt
  • contract
  • permanent
  • temporary
  • telecommute
Compensation
  • salary-range
  • salary-amount
  • salary-currency
Location
  • address
  • city
  • state
  • zip
  • country
  • area-code
Contact
  • name
  • email
  • phone
  • fax
  • hiring-manager-name
  • hiring-manager-email
Company
  • name
  • description
  • industry
  • url
The required fields are:
  • title
  • Description:summary
  • detail-url
  • Location:state
  • job-code

If these required fields are not present for a given job, it will be thrown out in our data cleansing and normalization process.

3. XML Formats

Simply Hired can work with a wide range of XML formats including one that we have designed and are standardizing on.

3.1. Simply Hired XML Format

We do not yet have a DTD type of specification for our xml format, so for the time being it is represented as a simple xml skeleton without data. We can read XML data values from either of these tag usages:

<tag value="VALUE" />
or
<tag>VALUE</tag>

Below is the skeleton XML format:

<jobs>

  <job>

    <title/>
    <job-code/>
    <action/>
    <job-board-name/>
    <job-board-url/>
    <detail-url/>
    <apply-url/>
    <job-category/>

    <description>
      <summary/>
      <required-skills/>
      <required-education/>
      <required-experience/>
      <!-- below are all boolean -->
      <full-time/>
      <part-time/>
      <flex-time/>
      <internship/>
      <volunteer/>
      <exempt/>
      <contract/>
      <permanent/>
      <temporary/>
      <telecommute/>
    </description>

    <compensation>
      <salary-range/>
      <salary-amount/>
      <salary-currency/>
      <benefits/>
    </compensation>

    <posted-date/>
    <close-date/>

    <location>
      <address/>
      <city/>
      <state/>
      <zip/>
      <country/>
      <area-code/>
    </location>

    <contact>
      <name/>
      <email/>
      <hiring-manager-name/>
      <hiring-manager-email/>
      <phone/>
      <fax/>
    </contact>

    <company>
      <name/>
      <description/>
      <industry/>
      <url/>
    </company>

  </job>

</jobs>
3.2. Other XML Formats

We can map most other reasonable XML formats onto our XML format given that the required fields are present. Please inquire to see if we can take your XML feed as is.

4. Delimited Files

We can take just about any type of delimited file (comma, tab, other single character, or multi-character) as long as it has a header line and uses either proper escaping or a significantly complicated multicharacter delimiter such that there is no worry of the delimiter showing up in the data. An example of a multi-character delimiter might be: "#!#"

For single character delimiters, proper escaping is essential if the delimiter may appear in the data.

For multi-character delimiters, we assume that NO escaping will present.

5. Character Encodings

All feeds must be in ASCII or Latin1 encoding. Other encodings will not parse properly. A decent, though not comprehensive, test is to load the xml file in Mozilla Firefox or Microsoft Internet Explorer. Both of these browsers will complain about bad XML or un-readable characters, though they each have they're own view of "valid" and neither will catch all problems.

6. Transport Methods

There are three ways to get a feed file from you to us. HTTP, FTP, & FTP. You say "You put FTP twice!" so I will explain. The three methods are:

  • HTTP: post your feed to your website where we can grab it (with or without a password)
  • FTP-1: post your feed to your FTP server, which has an account setup for us
  • FTP-2: post your feed to our FTP server, which has an account setup for you