TDUSA XML Job Feed

Overview

The XML job feed allows clients to push daily updates on job information that will be displayed on our network. By allowing our clients to maintaining an XML feed they have greater control over how jobs are displayed, location, bonus and payment information.

Create an XML Job Feed

Note: It can be technically challenging to create programtically an XML feed, please read the documentation in its entirety before creating and submitting your feed. If you need assistance in having a feed system coded for your please contact us about our coding services.

Programmatically create and maintain an XML document containing all job information on your site, TDUSA monitors the file for changes by crawling an XML URL daily and updating our records. Your feed should

XML feed example

The following example shows a basic XML feed containing one job.

<?xml version=”1.0″ encoding=”utf-8″?>

<job>

<![CDATA[ <p><strong>CDL-A OPPORTUNITIES: SEEKING OWNER-OPERATOR SOLO AND TEAMS</strong></p> <p> </p> <p>ABC Trucking is seeking CDL-A solo or team independent owner-operators to haul steady freight.</p> <p> </p> <p>CDL-A independent owner-operators at ABC Trucking enjoy:</p> <ul> <li>Choice of preferred running style </li> <li>Low start-up costs</li> <li>Dedicated opportunities available</li> <li>No forced dispatch</li> <li>Weekly pay settlements</li> <li>99% no touch freight</li> < </ul> <p> </p> <p>Get MORE than miles and money, get the freedom to grow or build your truck driving business by partnering with ABC Trucking today!</p> <p> </p> <p>APPLY NOW</p> ]]>

</jobFullDescription>

</job>

XML feed elements

The XML feed contains basic elements, used once per feed, and a set of job elements that are used for each job in the feed.

Basic elements

Basic elements table
Element	Required	Description	Example value
<?xml ?>	Yes	XML Declaration	<?xml version=”1.0″ encoding=”utf-8″?>
<source>	Yes	The root node for the XML feed document.	—
<publisher>	No	The name of the company publishing this job.	Company Name
<publisherurl>	No	The URL of the company publishing this job	http://www.example.com
<job>	Yes	All metadata specific to a job. Include one <job> element for each job to be displayed on Truck Drivers USA.	See following section for details.

Job elements

Note: Wrap all job content in <![CDATA[]]> nodes.

Element	Required	Description	Example value
<job>
<CompanyName>	Yes	Company name	<![CDATA[ABC Trucking]]>
<jobDate>	Yes	Job posting date	<![CDATA[ 2021-05-21 04:06:32 ]]>
<jobTitle>	Yes	Title of job posting.	<![CDATA[ CDL A Owner Operator Truck Driver OTR ]]>
<referenceNumber>	No	Company requisition number or corporate identification number.	<![CDATA[ 47128 ]]>
<jobDriverType>	Yes	Driver classification: Owner Operator, Company Driver, Team Driver, Lease	<![CDATA[ Owner Operator ]]>
<jobTrailerType>	Yes	Trailer type for job posting: Dry Van, Refrigerated, Flatbed, Tanker, Doubles / Triples, Intermodal, Household Goods, Hazmat, Specialized, Auto Hauler, Double Pups, Dry Bulk & Pneumatic	<![CDATA[ Dry Van ]]>
<cityHiring>	Yes	Name of city where the job is located.	<![CDATA[ Birmingham ]]>
<stateHiring>	Yes	Name of state where the job is located. Example: AL, MS, TX	<![CDATA[ AL ]]>
<zipHiring>	No	Zip code of job location	<![CDATA[ 35213 ]]>
<radiusAroundCity>	Yes	Mile radius around city that depicts hiring area. Example: 30,50,100	<![CDATA[ 50 ]]>
<countryHiring>	No	Country in which job resides.	<![CDATA[ USA ]]>
<jobFullDescription>	Yes	Full Job Description. Only the first 4 lines will be visible from card view. MUST BE IN HTML FORMAT.	<![CDATA[ HTML Job Description ]]>

Formatting guidelines

Truck Drivers USA expects same HTML formatting from your website when you provide job descriptions in XML. Include your formatting in CDATA tags.

Note: We do not support escaped HTML entities. For example, use < instead of <.
Supported tags include but are not limited to the following examples:

Formatting Guidelines Table

TAG	DESCRIPTION
<b>	BOLD
<h1> to <h6>	HEADERS Note: Text in header tags transform to consistent sizes when displayed on TDUSA pages.
<br>	LINE BREAK Note: TDUSA automatically inserts breaks between paragraphs.
<p>	PARAGRAPH
<ul>	Unordered list (bullets)
<li>	List item
<strong>	Strong text (bold)
<em>	Emphasized text (italics
<table>, <tbody>, <th>, <tr>, <td>	Simple tables

Additionally, we support computed style nodes like the following:

<font style=”font-weight:bold”>Some bold text</font> will result in bold text.
<div><h2 style=”display:inline”>Label: </h2> Text</div> will display “Label: Text” in-line, despite the fact that <h2> is a block element by default.
A paragraph tag must have positive top/bottom margin/padding. This is the <p> tag’s default behavior

Formatting example

Formatting for an example job description