Skip to content

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

TagRequiredInformationExample
<?xml>YESXML declaration<?xml version=”1.0″ encoding=”utf-8″?>
<source>YESthe root tag for the whole XML document<source>
<publisher>NOThe name of the company publishing this feed.Example Publisher
<publisherurl>NOThe URL of the company publishing this feed.http://www.examplepublisher.com/
<job>YESContains all the data needed for this job. We need one <job> element for each jobSee next section titled “Job Tags”

Job Tags

TagRequiredInformationExample Values
<title>YESThis is the title of the job.<![CDATA[Software Engineer]]>
<date>YESThe date this job was first published.<![CDATA[Mon, 05 Mar 2021 20:52:19 EST]]>
<referencenumber>YESA Unique Identifier for the job. This can contain Letters and numbers. Do not change your referencenumber once you set it.<![CDATA[distinctive123456]]>
<url>YESThe 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>YESThe 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>NOThe 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, leave the value blank or make the value <All Cities><![CDATA[New York]]>
<state>NOThe 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>YESThe 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>YESThe 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>NOThe expierience that the company desires. [Value Options: None, Entry, Senior, Manager, Executive]<![CDATA[3+ years]]>
<salary>NOThe salary for the position.<![CDATA[$70K per year]]>
<education>NOThe 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>NOThe type for the position [Value Options: Full Time,Part Time,Contract,Temp,Seasonal,Intern]<![CDATA[Full Time]]>
<campaign_id>NOMust 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>NOMust 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>NOMust 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>NOMust 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>NOcpc (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>NOcpa (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>NOThe major category of this position. Full listing of accepted major category values here[Information Technology]
<minor_category0>NOThe major category of this position. Full listing of accepted major category values here[Information Technology] Software Engineer, Developer, And Programmer

Common Mistakes

MistakeSolution
Incorrect use of CDATASee here for details on how to use CDATA
Suspected Invalid AdvertismentsWe reserve the right to remove an invalid advertisement from our system if determined the job is not a valid job opportunity.
Invalid Charater EncodingUse 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?

How often is your feed refreshed in our system?

Can I include additional tags?

How Do I display Jobs that are Statewide or Nationwide?