XML Feed Example:

<?xml version="1.0" encoding="utf-8"?>
<source>
   <publisher>Example</publisher>    
   <publisherurl>http://www.example.com</publisherurl>
   <lastBuildDate>Mon, 05 Mar 2021 20:52:19 EST</lastBuildDate>
   <job>
      <title><![CDATA[Software Engineer]]></title>
      <date><![CDATA[Mon, 05 Mar 2021 20:52:19 EST]]></date>    
      <referencenumber><![CDATA[distinctive123456]]></referencenumber>
      <url>
         <![CDATA[http://www.example.com/viewjob.php?jobid=distinctive123456]]>
      </url>
      <company><![CDATA[ABC Technology Corporation]]></company>
      <city><![CDATA[New York]]></city>
      <state><![CDATA[NY]]></state>
      <postalcode><![CDATA[10001]]></postalcode>
      <email><![CDATA[example@abccorp.com]]></email>
      <description>
         <![CDATA[Do you have 3-5 years of software developing experience? Are you a big fan of new developing languages? Are you ready for an exciting and high-speed career in engineering? If so, we want to hear from you!<br />
         We provide competitive compensation, including stock options and a full benefit plan. As a fast-growing business, we offer excellent opportunities for exciting and challenging work. As our company continues to grow, you can expect unlimited career advancement!]]>
      </description>
      <salary><![CDATA[$70K per year]]></salary>
      <education><![CDATA[Associate's Degree]]></education>
      <jobtype><![CDATA[Full Time]]></jobtype>
      <major_category0>[Information Technology]</major_category0>
      <experience><![CDATA[3+ years]]></experience>      
   </job>
</source>


XML Feed Tags

The XML feed contains basic tags (used once per feed), and a set of job tags (used in each job in the feed)


Basic Tags

Tag Required Information Example Values
<?xml> YES XML declaration <?xml version="1.0" encoding="utf-8"?>
<source> YES the root tag for the whole XML document <source>
<publisher> NO The name of the company publishing this feed. Example Publisher
<publisherurl> NO The URL of the company publishing this feed. http://www.examplepublisher.com/
<job> YES Contains all the data needed for this job. We need one <job> element for each job See next section titled "Job Tags"


Job Tags

Tag Required Information Example Values
<title> YES This is the title of the job. <![CDATA[Software Engineer]]>
<date> YES The date this job was first published. <![CDATA[Mon, 05 Mar 2021 20:52:19 EST]]>
<referencenumber> YES A Unique Identifier for the job. This can contain Letters and numbers. Do not change your referencenumber once you set it. <![CDATA[distinctive123456]]>
<url> YES The URL for the job listing. This should eventually connect the job seeker to a link to apply for the job <![CDATA[http://www.example.com/viewjob.php?jobid=distinctive123456]]>
<company> YES The company displayed in the search results. This should be the same company displayed on the landing page from the URL link in this job. <![CDATA[ABC Technology Corporation]]>
<city> NO The city for the job's location. If a City is added, we expect there to be a valid <state> tag. For all Cities in a state, make the value <All Cities> <![CDATA[New York]]>
<state> NO The state for the job's location. If a State is added, we expect there to be a valid <city> tag. For all States in the US, make the value <All States> <![CDATA[NY]]>
<postalcode> YES The postal code for the job's location. While postalcode is technically required and prefered, it can be omitted if the <city> and <state> tags are included and valid. <![CDATA[10001]]>
<description> YES The description for the job posting. The information in the description should match the description displayed in the <url> link. Job Descriptions support HTML formatting and basic HTML tags if encoded properly and encapsulated properly inside CDATA. <![CDATA[Do you have 3-5 years of <b>software developing<b> experience?...]]>
<experience> NO The expierience that the company desires. [Value Options: None, Entry, Senior, Manager, Executive] <![CDATA[3+ years]]>
<salary> NO The salary for the position. <![CDATA[$70K per year]]>
<education> NO The education that the company desires. [Value Options: GED, High School Diploma, Some College, Associate's Degree, Bachelor's Degree, Master's Degree, Doctor's Degree, Certificate/Professional, Other, No Diploma/Degree] <![CDATA[Associate's Degree]]>
<jobtype> NO The type for the position [Value Options: Full Time,Part Time,Contract,Temp,Seasonal,Intern] <![CDATA[Full Time]]>
<campaign_id> NO Must be an integer. Can be used to group several jobs in this feed into individual campaigns. Talk with your Account Rep if this is something you want to utilize. <![CDATA[1]]>
<segment> NO Must be an integer. After jobs are loaded into a campaign, This can be used to group jobs within a sub segment of a campaign. Talk with your Account Rep if this is something you want to utilize. <![CDATA[123]]>
<phone> NO Must be an integer. The phone number of the company that the job seeker can reach out to to inquire about the job. <![CDATA[1234567890]]>
<email> NO Must be a valid email address. The email address of the company that the job seeker can reach out to inquire about the job. <![CDATA[test@test.com]]>
<cpc> NO cpc (aka: "Cost per Click") Must be a Float. In Dollars. Required for "cpc per click". Do not use if using the <cpa> tag. This must be greater than the minimum required CPC for the Industry or Product you will be using. Please ask your Account Rep for more details. <![CDATA[0.50]]>
<cpa> NO cpa (aka: "Cost per application") Must be a Float. In Dollars. Required for "cpc per apply". Do not use if using the <cpc> tag. <![CDATA[19.5]]>
<major_category0> NO The major category of this position. Full listing of accepted major category values here [Information Technology]
<minor_category0> NO The major category of this position. Full listing of accepted major category values here [Information Technology] Software Engineer, Developer, And Programmer


Common Mistakes

Mistake Solution
Incorrect use of CDATA See here for details on how to use CDATA
Suspected Invalid Advertisments We reserve the right to remove an invalid advertisement from our system if determined the job is not a valid job opportunity.
Invalid Charater Encoding Use an XML linter tool or browser "view source" to determine if your XML feed is encoded incorrectly


Additional Information (Common Questions)


What are the options for sending us the feed?

  • Talroo can call a URL link to your XML feed directly and download the file.
  • Talroo can provide access to our SFTP server for you to upload your jobs


How often is your feed refreshed in our system?

  • Talroo will refresh your feed at least once every 24 hours.


Can I include additional tags?

  • Yes, as long as the required tags are included.


How Do I display Jobs that are Statewide or Nationwide?

  • For State Wide: Simply do not include a postalcode tag and make the value of your city tag "All Cities"
  • For Nationwide: Do not include a postalcode tag. Make the value of the state tag "All States" along with your city tag value as "All Cities"