Juju XML Job Feed Specification

Providing Juju an XML feed is the fastest way to get your jobs included in our index. Once you have created a feed, use the feed submission form to let us know. We will check your feed once a day to get new jobs and remove expired ones. Before submitting your feed, check to make sure it complies with our quality guidelines.

Quality Guidelines

All jobs must have been posted directly to your website.
Jobs reposted from other sites must be excluded from the feed.
Each job in the feed must have a full description and link to the job described.
Job detail pages on your site must include application information.
Pop-ups and other obstructions in the user's path are forbidden.
Feed must be updated daily and dead links must be removed promptly.
Quality controls must be in place (No pyramid schemes, MLM, scams, etc.).
Juju may reject individual jobs or the entire feed at our sole discretion.

If you already have a feed in another format, you may submit it for review and we will try to accommodate. Otherwise, create a feed that meets the following technical guidelines.

Accepted Fields

Below is a table outlining all of the possible fields in a Juju feed, which are required, and what each one may contain.

<positionfeed
    xmlns="http://www.juju.com/add-jobs/positionfeed-namespace/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.juju.com/add-jobs/positionfeed-namespace/ http://www.juju.com/add-jobs/positionfeed.xsd"
    version="2006-04">
    <source>(Your company name)</source>

    <sourceurl>(Your website's complete URL)</sourceurl>
    <feeddate>(Date feed was updated. For example, "2006-04-17T13:07:30Z")</feeddate>
    <job id="(Job ID unique for your site)">
        <employer>(Name of company posting job)</employer>

        <title>(Job title)</title>
        <description>(Summary of job)</description>
        <postingdate>(Date job was posted to your site. For example, "2006-04-17T13:07:30Z")</postingdate>
        <joburl>(URL to view more info and apply)</joburl>

        <location>
            <nation>(Nation)</nation>
            <city>(City)</city>
            <county>(County)</county>

            <state>(State or province)</state>
            <zip>(Zip or postal code)</zip>
        </location>
        <salary>
            <period>(yearly, monthly, weekly, daily, or hourly)</period>

            <min>(dollar number)</min>
            <max>(dollar number)</max>
        </salary>
        <type>(fulltime, parttime, temporary, contract, internship, seasonal, volunteer)</type>

        <experience>
            <min>(years)</min>
            <max>(years)</max>
        </experience>
        <education>(somehighschool, highschool, somecollege, associates,
            bachelors, masters, doctorate, postdoctorate, professional)</education>

        <jobsource>(Source of job. Defaults to the feed's <source> tag.)</jobsource>
        <jobsourceurl>(URL to any additional information about job's source.)</jobsourceurl>
    </job>
    [<job>...</job>...]

</positionfeed>

(Required)

<source>

The <source> field specifies the default source name, as presented to the end-user, for each job in the feed. Individual jobs may override it. Suffixes such as ".com" should be omited.

Note that this field relates to the job board posting the position, not necessarily the employer offering the position.

No HTML.

Example:
<source> Foo Job Board </source>

(Required)

<sourceurl>

The <sourceurl> field specifies the default sourceurl for each job in the feed. It should be the full URL to the organization providing the job posting information. Individual jobs may override it.

Note that this field relates to the job board posting the position, not necessarily the employer offering the position.

Example:
<sourceurl> http://yourcompany/ </sourceurl>

(Required)

<feeddate>

The <feeddate> specifies the time the feed is generated. This is not the date of the jobs in the feed. For formatting details, refer to W3C's Notes on ISO 8601.

Example:
<feeddate> 2006-04-17T13:07:30Z </feeddate>

<job>

For each job in the feed, one <job> exists. Information about the job is contained in this tag.

(Required)

<employer>

The <employer> field species the name of the employer for a job. The value is displayed to the end-user. Suffixes such as ".com" should be omitted.

No HTML.

Example:
<employer> Juju </employer>

(Required)

<title>

The <title> field specifies exact job title. It should not include the company name, salary, location, or other information besides the job's actual title.

No HTML.

Example:
<title> Sales Manager </title>

(Required)

<description>

The <description> field contains a summary of the job, about one paragraph long.

HTML is allowed, but discouraged.

Example:
<description> Project manager will negotiate requirements between users and developers for medium-sized enterprise development projects. Knowledge of C++ is a plus. </description>

(Required)

<postingdate>

The <postingdate> specifies the date the job opened. For formatting details, refer to W3C's Notes on ISO 8601.

Example:
<postingdate> 2006-04-17T13:07:30Z </postingdate>

(Required)

<joburl>

The <joburl> field a complete URL to additional details about the job, as well as information on how to apply.

Example:
<joburl> http://yourcompany/jobboard/123 </joburl>

(Required)

<location>

The <location> field specifies the physical location of the job. At a minimum, jobs specify a state or zip code. Nationwide jobs may only specify what nation they are available in.

Example 1:
<location> <city>Lawrence</city> <state>KS</state> <nation>US</nation> </location>

Example 2:
<location> <nation>US</nation> </location>

Example 3:
<location> <state>MA</state> <nation>US</nation> </location>

<salary>

The <salary> optional field specifies the salary range for a job. The value includes a minimum, a maximum, and a period indicating whether the salary is yearly, monthly, weekly, daily, or hourly.

Numbers should not include any current characters, such as "$".

Example:
<salary> <period>hourly</period> <min>15</min> <max>20</max> </salary>

<type>

The optional <type> field specifies the employment terms for the job. It may be fulltime, parttime, temporary, contract, internship, seasonal, or volunteer.

Example:
<type> parttime </type>

<education>

The optional <education> specifies the required level of education for position. Must be one of: somehighschool, highschool, somecollege, associates, bachelors, masters, doctorate, postdoctorate, professional.

Example:
<education> bachelors </education>

<jobsource>

The optional <jobsource> overrides the feed-wide source name for the individual job.

Note that this field relates to the job board posting the position, not necessarily the employer offering the position.

No HTML.

Example:
<source> Foo Job Board </source>

<jobsourceurl>

The <sourceurl> field overrides the feed-wide source url for each job in the feed. It should be the full URL to the organization providing the job posting information.

Note that this field relates to the job board posting the position, not necessarily the employer offering the position.

Example:
<sourceurl> http://yourcompany/ </sourceurl>

Additional Documents

Sample Feed

Here's what a properly constructed feed might look like. Note that all jobs include each of the required fields at a minimum, while some jobs also include optional fields. The XML declaration at the beginning specifies the character encoding as UTF-8. We prefer UTF-8 or ISO-8859-1, but whichever encoding is used must match the declaration.

Red tags are required.

<?xml version="1.0" encoding="UTF-8" ?>
<positionfeed
    xmlns="http://www.juju.com/employers/positionfeed-namespace/"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.juju.com/employers/positionfeed-namespace/ http://www.juju.com/employers/positionfeed.xsd" version="2006-04">
    <source>ExampleCompany</source>
    <sourceurl>http://www.ExampleCompany.com/</sourceurl>

    <feeddate>2006-04-17T13:07:30Z</feeddate>
    <job id="junior_soft_eng_10">
        <employer>ExampleCompany</employer>
        <title>Junior Software Engineer</title>

        <description>Develops software. Works closely with
        other software engineers, to engineer software.</description>
        <postingdate>2006-03-01</postingdate>
        <joburl>http://www.ExampleCompany.com/positions/junior_soft_eng_10.html</joburl>
        <location>

            <zip>80302</zip>
            <nation>US</nation>
        </location>
        <experience><min>1</min><max>3</max></experience>

    </job>
    <job id="senior_soft_eng_10">
        <employer>ExampleCompany</employer>
        <title>Senior Software Engineer</title>

        <description>Develops software. Works closely with
        other software engineers, to engineer software.</description>
        <postingdate>2006-03-01</postingdate>
        <joburl>http://www.ExampleCompany.com/positions/senior_soft_eng_10.html</joburl>
        <location>

            <city>Lawrence</city>
            <state>KS</state>
            <nation>US</nation>
        </location>

        <experience><min>3</min><max>5</max></experience>
    </job>
    <job id="sys_admin_10">

        <employer>ExampleCompany</employer>
        <title>Systems Administrator</title>
        <description>Keeps computers running.</description>
        <postingdate>2006-03-15</postingdate>

        <joburl>http://www.ExampleCompany.com/positions/sys_admin_10.html</joburl>
        <location>
            <state>MA</state>
            <nation>US</nation>

        </location>
        <type>parttime</type>
    </job>
    <job id="tech_writer_05">
        <employer>ExampleCompany</employer>

        <title>Technical writer</title>
        <description>Writes documents that describe feeds.</description>
        <postingdate>2005-02-20</postingdate>
        <joburl>http://www.ExampleCompany.com/positions/tech_writer_05.html</joburl>

        <location>
            <nation>US</nation>
        </location>
        <salary>
            <period>hourly</period>

            <min>15</min>
            <max>20</max>
        </salary>
    </job>
    <job id="accountant_20">

        <employer>ExampleCompany</employer>
        <title>Accountant</title>
        <description>Keep records, writes invoices, etc.</description>
        <postingdate>2005-03-01</postingdate>

        <joburl>http://www.ExampleCompany.com/positions/accountant_20.html</joburl>
        <location>
            <city>Lawrence</city>
            <state>KS</state>

            <nation>US</nation>
        </location>
        <education>bachelors</education>
    </job>   
    <job id="bigfood_chef_20">

        <employer>BigCompanyInternational</employer>
        <title>Chef</title>
        <description>Cooks food.</description>
        <postingdate>2007-03-01</postingdate>

        <joburl>http://www.bigcompanyinternational.com/positions/ExampleCompany_chef_20.html</joburl>
        <location>
            <city>Lawrence</city>
            <state>KS</state>

            <nation>US</nation>
        </location>
        <jobsource>Big Company International</jobsource>
        <jobsourceurl>http://www.bigcompanyinternational.com</jobsourceurl>

    </job>
</positionfeed>