Documentation :: TravelNurseSource.com

Job Feed

TravelNurseSource can import jobs using JSON or XML 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":"abcd1234",
		"title":"The greatest job ever",
		"city":"Exampleville",
		"state":"PA",
		"postalCode":"12345",
		"license":"CNA",
		"preference":"Antepartum",
		"description":"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>.",
		"requirements":"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>."
	},
	{
		"referenceNumber":"abcd1235",
		"title":"The second greatest job ever",
		"city":"Exampleville",
		"state":"PA",
		"license":"RN",
		"preference":"Neonatal",
		"description":"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>.",
		"requirements":"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>."
	}
]
<?xml version="1.0" encoding="utf-8"?>
<source>
	<job>
		<referenceNumber>abcd1234</referenceNumber>
		<title>The greatest job ever</title>
		<city>Exampleville</city>
		<state>PA</state>
		<postalCode>12345</postalCode>
		<license>CNA</license>
		&lt;specialty&gt;ER/Trauma&lt;/specialty&gt;
		<description><![CDATA[Description here explaining why leads want your awesome job. Basic <strong>HTML</strong> is allowed too<br />, <em>as long as you have properly wrapped it in a CDATA block</em>.]]></description>
		<requirements><![CDATA[Minimum requirements a lead applying to your job must meet go here. Basic <strong>HTML</strong> is allowed too<br />, <em>as long as you have properly wrapped it in a CDATA block</em>.]]></requirements>
	</job>
	<job>
		<referenceNumber>abcd1235</referenceNumber>
		<title>The second greatest job ever</title>
		<city>Exampleville</city>
		<state>PA</state>
		<postalCode>12345</postalcode>
		<license>RN</license>
		&lt;specialty&gt;Stepdown&lt;/specialty&gt;
		<description><![CDATA[Description here explaining why leads want your awesome job. Basic <strong>HTML</strong> is allowed too<br />, <em>as long as you have properly wrapped it in a CDATA block</em>.]]></description>
		<requirements><![CDATA[Minimum requirements a lead applying to your job must meet go here. Basic <strong>HTML</strong> is allowed too<br />, <em>as long as you have properly wrapped it in a CDATA block</em>.]]></requirements>
	</job>
</source>

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 in your spreadsheet. If not, the job will be added as a new job. If you select the 'Deactivate' option, any jobs that were added by a previous imported spreadsheet that no longer appear in your current spreadsheet will be deactivated.

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 ZIP code

No

The zip code where your job posting is located.

license

String

One of the following values:

  • CNA
  • LPN
  • RN
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 values:

  • Admin/Mgmt
  • Antepartum
  • CVICU
  • CVOR
  • Case Manager
  • Cath Lab
  • Coronary Care
  • Diabetes
  • Dialysis
  • ER/Trauma
  • Endoscopy
  • Flight Nurse
  • Gastroenterology
  • Home Health
  • Hospice
  • ICU/Critical Care
  • Interventional Radiology
  • Labor/Delivery
  • Long-Term Care
  • Med/Surg
  • NICU
  • Neonatal
  • Neuro
  • OB/GYN
  • OR
  • Occupational
  • Oncology
  • Orthopedics
  • Other
  • PACU/Pre-Post Op
  • PCU
  • PICU
  • Pain Management
  • Pediatrics
  • Postpartum
  • Psych
  • RNFA
  • Radiology
  • Rehab
  • Stepdown
  • Telemetry
  • Wound/Ostomy
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.

shift

String

No What shift your job posting is for.
payRate

String

No How much this position pays.
employmentType

List

Any combination of the following values:

  • Full-Time
  • Part-Time
  • Temporary
  • Permanent
No

The type(s) of employment applicable for this job. You can include more than one type.

positionType

String

No What type of position this is.
duration

String

No The duration of this job.
startDate

Date

No The date your position starts.
description

String

Yes The description of your job posting. Basic HTML tags are allowed.
requirements

String

No The minimum requirements a lead applying to your job posting must meet. Basic HTML tags are allowed.
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, TravelNurseSource supports the list of elements below.

General

Tag Description Example How it looks on TravelNurseSource
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 TravelNurseSource
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.</h5>
This is an example.

Lists

Tag Description Example How it looks on TravelNurseSource
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 TravelNurseSource
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