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> </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
<jobFullDescription>
<![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>