Documentation :: LocumJobsOnline.com

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

[
    {
        "referenceNumber": "abcd4885",
        "title": "The greatest job ever #6",
        "city": "Exampleville",
        "state": "PA",
        "postalCode": "17601",
        "license": "NP",
        "specialty": "Cardiothoracic Surgery",
        "shiftType": "evening",
        "shiftsPerWeek": 4,
        "hoursPerShift": 9,
        "payAmountMin": "1000.00",
        "payAmountMax": "1300.00",
        "payFrequency": "Daily",
        "employmentType": "Temporary",
        "durationLength": "13",
        "durationUnit": "week",
        "startDate": "2021-04-24T18:21: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": "Qui ipsam dolorem qui odio." }, { "referenceNumber": "abcd3874", "title": "The greatest job ever #8", "city": "Exampleville", "state": "PA", "postalCode": "17601", "license": "MD", "specialty": "Rheumatology", "shiftType": "day", "shiftsPerWeek": 5, "hoursPerShift": 11, "payAmountMin": "1000.00", "payAmountMax": "1300.00", "payFrequency": "Hourly", "employmentType": "Full-Time", "durationLength": "13", "durationUnit": "week", "startDate": "2016-12-09T19:09:15+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": "Quis nemo asperiores et vitae." } ]
<?xml version="1.0"?>
<source>
  <job>
    <referenceNumber>abcd4885</referenceNumber>
    <title>The greatest job ever #6</title>
    <city>Exampleville</city>
    <state>PA</state>
    <postalCode>17601</postalCode>
    <license>NP</license>
    <specialty>Cardiothoracic Surgery</specialty>
    <shiftType>evening</shiftType>
    <shiftsPerWeek>4</shiftsPerWeek>
    <hoursPerShift>9</hoursPerShift>
    <payAmountMin>1000.00</payAmountMin>
    <payAmountMax>1300.00</payAmountMax>
    <payFrequency>Daily</payFrequency>
    <employmentType>Temporary</employmentType>
    <durationLength>13</durationLength>
    <durationUnit>week</durationUnit>
    <startDate>2021-04-24T18:21: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>Qui ipsam dolorem qui odio.</benefits>
  </job>
  <job>
    <referenceNumber>abcd3874</referenceNumber>
    <title>The greatest job ever #8</title>
    <city>Exampleville</city>
    <state>PA</state>
    <postalCode>17601</postalCode>
    <license>MD</license>
    <specialty>Rheumatology</specialty>
    <shiftType>day</shiftType>
    <shiftsPerWeek>5</shiftsPerWeek>
    <hoursPerShift>11</hoursPerShift>
    <payAmountMin>1000.00</payAmountMin>
    <payAmountMax>1300.00</payAmountMax>
    <payFrequency>Hourly</payFrequency>
    <employmentType>Full-Time</employmentType>
    <durationLength>13</durationLength>
    <durationUnit>week</durationUnit>
    <startDate>2016-12-09T19:09:15+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>Quis nemo asperiores et vitae.</benefits>
  </job>
</source>
referenceNumber,title,city,state,postalCode,license,specialty,shiftType,shiftsPerWeek,hoursPerShift,payAmountMin,payAmountMax,payFrequency,employmentType,durationLength,durationUnit,startDate,description,requirements,benefits
abcd4885,"The greatest job ever #6",Exampleville,PA,17601,NP,"Cardiothoracic Surgery",evening,4,9,1000.00,1300.00,Daily,Temporary,13,week,2021-04-24T18:21: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>.","Qui ipsam dolorem qui odio."
abcd3874,"The greatest job ever #8",Exampleville,PA,17601,MD,Rheumatology,day,5,11,1000.00,1300.00,Hourly,Full-Time,13,week,2016-12-09T19:09:15+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>.","Quis nemo asperiores et vitae."
<?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>abcd4885</job:referenceNumber>
      <title>The greatest job ever #6</title>
      <job:city>Exampleville</job:city>
      <job:state>PA</job:state>
      <job:postalCode>17601</job:postalCode>
      <job:license>NP</job:license>
      <job:specialty>Cardiothoracic Surgery</job:specialty>
      <job:shiftType>evening</job:shiftType>
      <job:shiftsPerWeek>4</job:shiftsPerWeek>
      <job:hoursPerShift>9</job:hoursPerShift>
      <job:payAmountMin>1000.00</job:payAmountMin>
      <job:payAmountMax>1300.00</job:payAmountMax>
      <job:payFrequency>Daily</job:payFrequency>
      <job:employmentType>Temporary</job:employmentType>
      <job:durationLength>13</job:durationLength>
      <job:durationUnit>week</job:durationUnit>
      <job:startDate>2021-04-24T18:21: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[Qui ipsam dolorem qui odio.]]></job:benefits>
    </item>
    <item>
      <job:referenceNumber>abcd3874</job:referenceNumber>
      <title>The greatest job ever #8</title>
      <job:city>Exampleville</job:city>
      <job:state>PA</job:state>
      <job:postalCode>17601</job:postalCode>
      <job:license>MD</job:license>
      <job:specialty>Rheumatology</job:specialty>
      <job:shiftType>day</job:shiftType>
      <job:shiftsPerWeek>5</job:shiftsPerWeek>
      <job:hoursPerShift>11</job:hoursPerShift>
      <job:payAmountMin>1000.00</job:payAmountMin>
      <job:payAmountMax>1300.00</job:payAmountMax>
      <job:payFrequency>Hourly</job:payFrequency>
      <job:employmentType>Full-Time</job:employmentType>
      <job:durationLength>13</job:durationLength>
      <job:durationUnit>week</job:durationUnit>
      <job:startDate>2016-12-09T19:09:15+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[Quis nemo asperiores et vitae.]]></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:

  • Full-Time
  • Part-Time
  • 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.

One of Locum Tenens or Permanent is required.

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.

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>
  1. One
  2. 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>
1 2
tbody Table body
<table>
    <tbody>
        <tr>
            <td>1</td>
            <td>2</td>
        </tr>
    </tbody>
</table>
1 2
td Table data cell
<table>
    <tbody>
        <tr>
            <td>1</td>
            <td>2</td>
        </tr>
    </tbody>
</table>
1 2
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
th 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
tr 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