Job Feed

LocumJobsOnline can import jobs using JSON, XML, CSV, or RSS format. If you create a job feed, all you need to do is enter the publicly accessible URL on the Job Feed page, and we will automatically fetch your feed on a nightly basis (approximately 3:00 AM).

Sample Feed

JSON XML CSV RSS

[
    {
        "referenceNumber": "abcd9339",
        "title": "The greatest job ever #3",
        "city": "Exampleville",
        "state": "PA",
        "postalCode": "17601",
        "license": "NP",
        "specialty": "Transplant Surgery",
        "shiftType": "evening",
        "shiftsPerWeek": 5,
        "hoursPerShift": 12,
        "payAmountMin": "1000.00",
        "payAmountMax": "1300.00",
        "payFrequency": "Daily",
        "employmentType": "Locum Tenens",
        "durationLength": "13",
        "durationUnit": "week",
        "startDate": "1992-07-20T05:37:29+0000",
        "description": "Description here explaining why leads want your awesome job. Basic HTML is allowed too
, just make sure you have properly escaped any \"quotes\".",
        "requirements": "Minimum requirements a lead applying to your job must meet go here. Basic HTML is allowed too
, just make sure you have properly escaped any \"quotes\".",
        "benefits": "Cupiditate aliquid nemo facilis tenetur aut."
    },
    {
        "referenceNumber": "abcd9499",
        "title": "The greatest job ever #2",
        "city": "Exampleville",
        "state": "PA",
        "postalCode": "17601",
        "license": "CRNA",
        "specialty": "Osteopathic",
        "shiftType": "day",
        "shiftsPerWeek": 5,
        "hoursPerShift": 10,
        "payAmountMin": "1000.00",
        "payAmountMax": "1300.00",
        "payFrequency": "Monthly",
        "employmentType": "Locum Tenens",
        "durationLength": "13",
        "durationUnit": "week",
        "startDate": "1974-09-20T18:28:24+0000",
        "description": "Description here explaining why leads want your awesome job. Basic HTML is allowed too
, just make sure you have properly escaped any \"quotes\".",
        "requirements": "Minimum requirements a lead applying to your job must meet go here. Basic HTML is allowed too
, just make sure you have properly escaped any \"quotes\".",
        "benefits": "Velit est aut non id."
    }
]

<?xml version="1.0"?>
<source>
  <job>
    <referenceNumber>abcd9339</referenceNumber>
    <title>The greatest job ever #3</title>
    <city>Exampleville</city>
    <state>PA</state>
    <postalCode>17601</postalCode>
    <license>NP</license>
    <specialty>Transplant Surgery</specialty>
    <shiftType>evening</shiftType>
    <shiftsPerWeek>5</shiftsPerWeek>
    <hoursPerShift>12</hoursPerShift>
    <payAmountMin>1000.00</payAmountMin>
    <payAmountMax>1300.00</payAmountMax>
    <payFrequency>Daily</payFrequency>
    <employmentType>Locum Tenens</employmentType>
    <durationLength>13</durationLength>
    <durationUnit>week</durationUnit>
    <startDate>1992-07-20T05:37:29+0000</startDate>
    <description>Description here explaining why leads want your awesome job. Basic &lt;strong&gt;HTML&lt;/strong&gt; is allowed too&lt;br /&gt;, &lt;em&gt;just make sure you have properly escaped any "quotes"&lt;/em&gt;.</description>
    <requirements>Minimum requirements a lead applying to your job must meet go here. Basic &lt;strong&gt;HTML&lt;/strong&gt; is allowed too&lt;br /&gt;, &lt;em&gt;just make sure you have properly escaped any "quotes"&lt;/em&gt;.</requirements>
    <benefits>Cupiditate aliquid nemo facilis tenetur aut.</benefits>
  </job>
  <job>
    <referenceNumber>abcd9499</referenceNumber>
    <title>The greatest job ever #2</title>
    <city>Exampleville</city>
    <state>PA</state>
    <postalCode>17601</postalCode>
    <license>CRNA</license>
    <specialty>Osteopathic</specialty>
    <shiftType>day</shiftType>
    <shiftsPerWeek>5</shiftsPerWeek>
    <hoursPerShift>10</hoursPerShift>
    <payAmountMin>1000.00</payAmountMin>
    <payAmountMax>1300.00</payAmountMax>
    <payFrequency>Monthly</payFrequency>
    <employmentType>Locum Tenens</employmentType>
    <durationLength>13</durationLength>
    <durationUnit>week</durationUnit>
    <startDate>1974-09-20T18:28:24+0000</startDate>
    <description>Description here explaining why leads want your awesome job. Basic &lt;strong&gt;HTML&lt;/strong&gt; is allowed too&lt;br /&gt;, &lt;em&gt;just make sure you have properly escaped any "quotes"&lt;/em&gt;.</description>
    <requirements>Minimum requirements a lead applying to your job must meet go here. Basic &lt;strong&gt;HTML&lt;/strong&gt; is allowed too&lt;br /&gt;, &lt;em&gt;just make sure you have properly escaped any "quotes"&lt;/em&gt;.</requirements>
    <benefits>Velit est aut non id.</benefits>
  </job>
</source>

referenceNumber,title,city,state,postalCode,license,specialty,shiftType,shiftsPerWeek,hoursPerShift,payAmountMin,payAmountMax,payFrequency,employmentType,durationLength,durationUnit,startDate,description,requirements,benefits
abcd9339,"The greatest job ever #3",Exampleville,PA,17601,NP,"Transplant Surgery",evening,5,12,1000.00,1300.00,Daily,"Locum Tenens",13,week,1992-07-20T05:37:29+0000,"Description here explaining why leads want your awesome job. Basic <strong>HTML</strong> is allowed too<br />, <em>just make sure you have properly escaped any ""quotes""</em>.","Minimum requirements a lead applying to your job must meet go here. Basic <strong>HTML</strong> is allowed too<br />, <em>just make sure you have properly escaped any ""quotes""</em>.","Cupiditate aliquid nemo facilis tenetur aut."
abcd9499,"The greatest job ever #2",Exampleville,PA,17601,CRNA,Osteopathic,day,5,10,1000.00,1300.00,Monthly,"Locum Tenens",13,week,1974-09-20T18:28:24+0000,"Description here explaining why leads want your awesome job. Basic <strong>HTML</strong> is allowed too<br />, <em>just make sure you have properly escaped any ""quotes""</em>.","Minimum requirements a lead applying to your job must meet go here. Basic <strong>HTML</strong> is allowed too<br />, <em>just make sure you have properly escaped any ""quotes""</em>.","Velit est aut non id."

<?xml version="1.0"?>
<rss xmlns:job="https://www.locumjobsonline.com/api/v2.0/public/jobs/xsd" version="2.0">
  <channel>
    <title>LocumJobsOnline.com Job Feed</title>
    <link>https://www.locumjobsonline.com</link>
    <description>LocumJobsOnline.com Job Feed</description>
    <docs>http://www.rssboard.org/rss-specification</docs>
    <generator>T5</generator>
    <item>
      <job:referenceNumber>abcd9339</job:referenceNumber>
      <title>The greatest job ever #3</title>
      <job:city>Exampleville</job:city>
      <job:state>PA</job:state>
      <job:postalCode>17601</job:postalCode>
      <job:license>NP</job:license>
      <job:specialty>Transplant Surgery</job:specialty>
      <job:shiftType>evening</job:shiftType>
      <job:shiftsPerWeek>5</job:shiftsPerWeek>
      <job:hoursPerShift>12</job:hoursPerShift>
      <job:payAmountMin>1000.00</job:payAmountMin>
      <job:payAmountMax>1300.00</job:payAmountMax>
      <job:payFrequency>Daily</job:payFrequency>
      <job:employmentType>Locum Tenens</job:employmentType>
      <job:durationLength>13</job:durationLength>
      <job:durationUnit>week</job:durationUnit>
      <job:startDate>1992-07-20T05:37:29+0000</job:startDate>
      <description><![CDATA[Description here explaining why leads want your awesome job. Basic <strong>HTML</strong> is allowed too<br />, <em>just make sure you have properly escaped any "quotes"</em>.]]></description>
      <job:requirements><![CDATA[Minimum requirements a lead applying to your job must meet go here. Basic <strong>HTML</strong> is allowed too<br />, <em>just make sure you have properly escaped any "quotes"</em>.]]></job:requirements>
      <job:benefits><![CDATA[Cupiditate aliquid nemo facilis tenetur aut.]]></job:benefits>
    </item>
    <item>
      <job:referenceNumber>abcd9499</job:referenceNumber>
      <title>The greatest job ever #2</title>
      <job:city>Exampleville</job:city>
      <job:state>PA</job:state>
      <job:postalCode>17601</job:postalCode>
      <job:license>CRNA</job:license>
      <job:specialty>Osteopathic</job:specialty>
      <job:shiftType>day</job:shiftType>
      <job:shiftsPerWeek>5</job:shiftsPerWeek>
      <job:hoursPerShift>10</job:hoursPerShift>
      <job:payAmountMin>1000.00</job:payAmountMin>
      <job:payAmountMax>1300.00</job:payAmountMax>
      <job:payFrequency>Monthly</job:payFrequency>
      <job:employmentType>Locum Tenens</job:employmentType>
      <job:durationLength>13</job:durationLength>
      <job:durationUnit>week</job:durationUnit>
      <job:startDate>1974-09-20T18:28:24+0000</job:startDate>
      <description><![CDATA[Description here explaining why leads want your awesome job. Basic <strong>HTML</strong> is allowed too<br />, <em>just make sure you have properly escaped any "quotes"</em>.]]></description>
      <job:requirements><![CDATA[Minimum requirements a lead applying to your job must meet go here. Basic <strong>HTML</strong> is allowed too<br />, <em>just make sure you have properly escaped any "quotes"</em>.]]></job:requirements>
      <job:benefits><![CDATA[Velit est aut non id.]]></job:benefits>
    </item>
  </channel>
</rss>

Detailed Field Explanation

Field	Format/Values	Required	Description
referenceNumber	Alphanumeric	Yes	Can be any combination of letters and numbers. Must be unique for each job. This number is used to identify if our website already has a copy of this job. If it exists, we will update the existing job with any new information provided. If not, the job will be added as a new job.
title	String	Yes	The title of your job posting.
city	String	No	The city where your job posting is located.
state	USPS 2-letter abbreviation	Yes	The state where your job posting is located.
postalCode	USPS 5-digit or 9-digit ZIP code	No	The ZIP code where your job posting is located.
license	String One of the following allowed values: CRNA DO MD NP PA	Yes	What type of license a nurse applying to your job post needs to have. We use this to appropriately categorize your job.
specialty	String One of the following allowed values: Addiction Medicine Administration Allergy and Immunology Anesthesiology Cardiac Electrophysiology Cardiology Cardiothoracic Surgery Cardiovascular Disease Child and Adolescent Psychiatry Colorectal Surgery Critical Care Dermatology Dermatopathology Emergency Medicine Endocrinology Family Practice Gastroenterology General Practice General Surgery Genetics Geriatrics Hematology and Oncology Hospitalist Infectious Disease Internal Medicine Interventional Radiology Maternal-Fetal Medicine Neonatal Nephrology Neurology Neurosurgery Nurse Practitioner Obstetrics and Gynecology Occupational Medicine Oncology Ophthalmology Orthopedic Surgery Osteopathic Other Otolaryngology Palliative Medicine Pathology Pediatric Surgery Pediatrics Perinatology Physical Medicine Psychiatry Psychology Pulmonology Radiation Oncology Radiology Rheumatology Transplant Surgery Trauma Surgery Urgent Care Urology Vascular Surgery	Yes	What specialty most accurately describes your job post. We use this to appropriately categorize your job. If you have used our Specialty Mapping Tool, you may use any mapped term in addition to the ones on the left.
shiftType	String One of the following allowed values: day evening overnight flex	No	The type of shifts the employee is expected to work.
shiftsPerWeek	Integer	No	The number of shifts per week the employee is expected to work. Values from 3 - 6
hoursPerShift	Integer	No	The number of hours per shift the employee is expected to work. Values from 6 - 16
payAmountMin	Decimal	No	The minimum pay provided by the Client for this Job. This is the bottom end of the pay range.
payAmountMax	Decimal	No	The maximum pay provided by the Client for this Job. This is the top end of the pay range.
payFrequency	String One of the following allowed values: Hourly Daily Weekly Monthly Yearly	No	The frequency at which a Client pays the Employee for this Job.
employmentType	Enum One of the following allowed values: Locum Tenens Permanent	Yes	The type(s) of employment applicable for this job. You can include more than one value from the list of allowed values. See sample feed above for List format example when including multiple values.
durationLength	Integer	No	The numeric length part of the contract duration (e.g. the "13" in "13 weeks").
durationUnit	String One of the following allowed values: day week month year	No	The unit part of the contract duration (e.g. the "weeks" in "13 weeks").
startDate	Date	No	The date your position starts. If left blank, or a date in the past, the start date will automatically be set to ASAP.
description	String	Yes	The description of your job posting. Basic HTML tags are allowed. If using XML, wrap in <![CDATA[ ]]>
requirements	String	No	The minimum requirements a lead applying to your job posting must meet. Basic HTML tags are allowed. If using XML, wrap in <![CDATA[ ]]>
benefits	String	No	The benefits offered by this position. Basic HTML tags are allowed.

Formatting Guidelines

When providing HTML markup for fields within your jobs, LocumJobsOnline supports the list of elements below.

NOTE: If using XML, your markup must either be wrapped in a CDATA section (e.g. <![CDATA[ ... ]]>), or entity-encoded.

General

Tag	Description	Example	How it looks on LocumJobsOnline
b	Bring attention to	`This is an <b>example</b>.`	This is an example.
br	Line break	`This is an<br>example.`	This is an example.
em	Emphasis	`This is an <em>example</em>.`	This is an example.
i	Interesting text	`This is an <i>example</i>.`	This is an example.
p	Paragraph	`<p>This is an example.</p><p>This is an example.</p>`	This is an example. This is an example.
span	Span	`This is an <span>example</span>.`	This is an example.
strong	Strong importance	`This is an <strong>example</strong>.`	This is an example.
u	Unarticulated annotation	`This is an <u>example</u>.`	This is an example.

Headings

Tag	Description	Example	How it looks on LocumJobsOnline
h2	Heading level 2	`<h2>This is an example.</h2>`	This is an example.
h3	Heading level 3	`<h3>This is an example.</h3>`	This is an example.
h4	Heading level 4	`<h4>This is an example.</h4>`	This is an example.
h5	Heading level 5	`<h5>This is an example.</h5>`	This is an example.
h6	Heading level 6	`<h6>This is an example.</h6>`	This is an example.

Lists

Tag	Description	Example	How it looks on LocumJobsOnline
li	List item	`<ul> <li>One</li> <li>Two</li> </ul>`	One Two
ol	Ordered list	`<ol> <li>One</li> <li>Two</li> </ol>`	One Two
ul	Unordered list	`<ul> <li>One</li> <li>Two</li> </ul>`	One Two

Tables

Tag Description Example How it looks on LocumJobsOnline

caption

Table caption (or title)

<table>
    <caption>This is an example.</caption>
    <tbody>
        <tr>
            <td>1</td>
            <td>2</td>
        </tr>
    </tbody>
</table>

This is an example.
1	2

table

Table

<table>
    <tbody>
        <tr>
            <td>1</td>
            <td>2</td>
        </tr>
    </tbody>
</table>

tbody

Table body

<table>
    <tbody>
        <tr>
            <td>1</td>
            <td>2</td>
        </tr>
    </tbody>
</table>

Table data cell

<table>
    <tbody>
        <tr>
            <td>1</td>
            <td>2</td>
        </tr>
    </tbody>
</table>

tfoot

Table footer

<table>
    <tbody>
        <tr>
            <td>1</td>
            <td>2</td>
        </tr>
    </tbody>
    <tfoot>
        <tr>
            <th>A</th>
            <td>B</td>
        </tr>
    </tfoot>
</table>

1	2
A	B

Table header cell

<table>
    <thead>
        <tr>
            <th>A</th>
            <td>B</td>
        </tr>
    </thead>
    <tbody>
        <tr>
            <th>1</th>
            <td>2</td>
        </tr>
    </tbody>
</table>

A	B
1	2

thead

Table head

<table>
    <thead>
        <tr>
            <th>A</th>
            <td>B</td>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>1</td>
            <td>2</td>
        </tr>
    </tbody>
</table>

A	B
1	2

Table row

<table>
    <thead>
        <tr>
            <td>A</td>
            <td>B</td>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>1</td>
            <td>2</td>
        </tr>
    </tbody>
</table>

A	B
1	2