XML Feed Documentation

Version 1.0 - Last updated: July 24, 2025

Introduction

Welcome to the documentation for job integration via XML feed on Jobzem.com. This guide describes the format and fields required for our system to correctly read and display your job postings on our platform.

The feed must be a valid XML file, hosted on a public URL on your server, and updated regularly. Our system will read your feed every 24 hours to add new jobs, update existing ones, and remove those no longer present in the file.

File Structure

The XML file must follow a simple structure. It consists of a root node (<source>) containing multiple <job> nodes. Each <job> node represents a single job posting.

Field Table (Tags)

Within each <job> node, the following fields are used to describe the job. Fields marked as "Required" must be present for the job to be validated.

XML Tag	Required	Description
`<title>`	Required	The job title. Ex: "Software Engineer".
`<description>`	Required	The full job description. It is recommended to use to include HTML formatting.
`<url>`	Required	The direct URL to the job application page on your site.
`<date_posted>`	Required	The job posting date in YYYY-MM-DD format.
`<date_expires>`	Optional	The job expiration date in YYYY-MM-DD format.
`<reference_number>`	Required	A unique ID for the job in your system. Used to identify and update the job.
`<company_name>`	Required	The hiring company's name.
`<source_name>`	Optional	The source of the job posting, if different from the company name.
`<country_code>`	Required	The country code (ISO 3166-1 alpha-2). Ex: "US".
`<state>`	Conditional	The state abbreviation. Required if `remote_type` is empty.
`<city>`	Conditional	The city where the job is located. Required if `remote_type` is empty.
`<postal_code>`	Optional	The postal code (ZIP code) of the job location.
`<street_address>`	Optional	The physical street address of the job.
`<salary>`	Optional	Salary information. Free format. Ex: "90000" or "Competitive".
`<salary_currency>`	Optional	The currency code for the salary (ISO 4217). Ex: "USD".
`<cpc>`	Optional	Cost Per Click (CPC) for the job. Numeric format. Ex: "0.35".
`<currency_cpc>`	Optional	The currency code for the CPC. Ex: "USD".
`<job_type>`	Optional	The type of contract. Ex: "Full-time", "Part-time", "Contract".
`<category>`	Optional	The job category. Ex: "Information Technology".
`<education_req>`	Optional	Education requirements. Ex: "Bachelor's Degree".
`<experience_req>`	Optional	Experience requirements. Ex: "Minimum 3 years".
`<remote_type>`	Optional	Indicates if the job is remote. Accepted values: "REMOTE", "HYBRID".

Full Example

Below is an example of a valid XML feed with two jobs:

<?xml version="1.0" encoding="UTF-8"?>
<source>
  <job>
    <title><![CDATA[Senior Frontend Developer (React)]]></title>
    <description><![CDATA[
      <p>We are looking for a Frontend Developer with solid experience in React, Redux, and TypeScript.</p>
      <h6>Responsibilities:</h6>
      <ul>
        <li>Develop and maintain user interfaces.</li>
        <li>Collaborate with UX/UI teams.</li>
      </ul>
    ]]></description>
    <url><![CDATA[https://your-site.com/job/frontend-dev-123]]></url>
    <date_posted>2025-07-24</date_posted>
    <reference_number>DEV-FRONT-123</reference_number>
    <company_name><![CDATA[Tech Solutions Inc.]]></company_name>
    <country_code>US</country_code>
    <state>NY</state>
    <city>New York</city>
    <salary>110000</salary>
    <salary_currency>USD</salary_currency>
    <job_type>Full-time</job_type>
    <category>Information Technology</category>
  </job>

  <job>
    <title><![CDATA[Digital Marketing Analyst]]></title>
    <description><![CDATA[<p>Responsible for planning and executing digital marketing campaigns.</p>]]></description>
    <url><![CDATA[https://your-site.com/job/mkt-digital-456]]></url>
    <date_posted>2025-07-23</date_posted>
    <reference_number>MKT-DIG-456</reference_number>
    <company_name><![CDATA[Creative Marketing Co.]]></company_name>
    <country_code>US</country_code>
    <salary>110000</salary>
    <salary_currency>USD</salary_currency>
    <job_type>Full-time</job_type>
    <category>Information Technology</category>
    <remote_type>REMOTE</remote_type>
  </job>
</source>

Next Steps

After creating and hosting your XML feed on a public URL, please contact our partnership team through the Publish Jobs page, providing the URL of your feed. We will validate it, and if everything is correct, your jobs will start appearing on our site.