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″?>

<source>

<publisher></publisher>

<publisherurl></publisherurl>

<job>

<companyName><![CDATA[ XPO Expedite ]]></companyName>

<jobDate><![CDATA[ 2021-05-21 04:06:32 ]]></jobDate>

<jobTitle><![CDATA[ CDL A Truck Driver]]></jobTitle>

<referenceNumber><![CDATA[ 47128 ]]></referenceNumber>

<jobDriverType><![CDATA[ Owner Operator ]]></jobDriverType>

<jobTrailerType><![CDATA[ Dry Van ]]></jobTrailerType>

<cityHiring><![CDATA[ Birmingham ]]></cityHiring>

<stateHiring><![CDATA[ AL ]]></stateHiring>

<zipHiring><![CDATA[ 35213 ]]></zipHiring>

<radiusAroundCity><![CDATA[ 50 ]]></radiusAroundCity>

<countryHiring><![CDATA[ USA ]]></countryHiring>

<jobFullDescription>

<![CDATA[ <p><strong>CDL-A OPPORTUNITIES: SEEKING OWNER-OPERATOR SOLO AND TEAMS</strong></p> <p>&nbsp;</p> <p>ABC Trucking is seeking CDL-A solo or team independent owner-operators to haul steady freight.</p> <p>&nbsp;</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>&nbsp;</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>&nbsp;</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 &#150; 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 &lt;.
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

 

<jobFullDescription>

<![CDATA[ <p><strong>CDL-A OPPORTUNITIES: SEEKING OWNER-OPERATOR SOLO AND TEAMS</strong></p> <p>&nbsp;</p> <p>ABC Trucking is seeking CDL-A solo or team independent owner-operators to haul steady freight.</p> <p>&nbsp;</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>&nbsp;</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>&nbsp;</p> <p>APPLY NOW</p> ]]>

</jobFullDescription>