Publisher XML Feed Specification

This document is the canonical schema for job records Talroo delivers in the publisher XML bulk feed: root structure, core and optional <job> fields, on‑demand columns, and a full example.

Skip to example

For general feed information, see XML Integration.

---

Feed Structure

Root Level Elements

<?xml version="1.0" encoding="UTF-8"?>
<feed date="2024-01-15T12:00:00-05:00" total="50000">
  <job>...</job>
  <job>...</job>
  <!-- More jobs -->
</feed>

Element	Attribute	Description
<feed>	date	Feed generation timestamp
<feed>	total	Total number of jobs in the feed
<job>	-	Individual job listing (direct child of feed)

Job Fields

Core Fields

Field	Description	Example
<title>	Job title	Truck Driver
<referencenumber>	Unique job identifier	33153477500-7351-67D060BC
<url>	Click tracking URL	https://api.talroo.com/click?job_id=...&pub_id=...
<company>	Employer company name	ABC Logistics
<description>	Full job description text	Job description content

Important

Always use the <url> field for all job clicks. This URL contains tracking parameters required for proper attribution and revenue tracking. Do not modify or reconstruct click URLs.

Location Fields

Field	Description	Example
<city>	City name	Austin
<state>	State code (2-letter)	TX
<zip>	ZIP code	78750

Category Fields

Field	Description	Example
<major_category0>	Primary job category	[Sales]
<major_category1>	Secondary job category (optional)	[Government]
<major_category2>	Tertiary job category (optional)
<minor_category0>	Primary subcategory	[Sales] Sales - Securities/Financial Services
<minor_category1>	Secondary subcategory (optional)
<minor_category2>	Tertiary subcategory (optional)

Pricing Fields

Field	Description	Example
<ranking_value>	Ranking value in cents	287
<cpc>	Cost-per-click in dollars	2.87

The <ranking_value> field is in cents, while <cpc> is the same value converted to dollars (ranking_value / 100).

Timestamp Fields

Field	Description	Example
<date>	Job publication date	2024-01-15 12:00:00
<updated>	Last update timestamp	2024-01-15 14:30:00

Optional Fields (On-Demand)

The following fields are available upon request. Contact your account manager to enable them for your feed.

Field	Description	Example
<logo_url>	Company logo image URL	https://media.j2c.com/company-logos/12345-company-name-abc123
<talroo_apply>	Whether this job supports Talroo Apply (true/false)	true

Extraction Fields (On-Demand)

These fields contain AI-extracted structured data from job descriptions. Available upon request. All values are JSON-encoded.

Field	Description	Example
<all_requirements_normalized>	Map of job requirements with normalized requirement id values.	{"Valid driver's license":"101001","2+ years experience":"0"}
<all_preferences_normalized>	Map of job preferred qualifications to normalized ids.	{"Bilingual preferred":"0"}
<compensation>	Extracted compensation details	["$20-25/hour plus tips"]
<benefits>	Extracted benefits	["Health insurance", "401k", "PTO"]
<work_schedule>	Work schedule details	["Full-time, weekends and holidays"]
<work_location_type>	Work location arrangement	["onsite"]
<visa_status>	Visa/sponsorship information	["no_visa_information"]

On-Demand Features

These optional and extraction fields are not included by default. They must be enabled per-publisher through your account manager. Once enabled, they will appear in your XML feed.

Complete Example

<?xml version="1.0" encoding="UTF-8"?>
<feed date="1999-12-31T00:00:01-05:00" total="99999">
  <job>
    <title><![CDATA[Example Job Title]]></title>
    <date>1999-12-31 00:00:01</date>
    <referencenumber>00000000000-0000-00000000</referencenumber>
    <url><![CDATA[https://www.jobs2careers.com/click.php?id=00000000000.0000&job_loc=...]]></url>
    <company><![CDATA[Example Company]]></company>
    <city>Anytown</city>
    <state>TX</state>
    <zip>00000</zip>
    <description><![CDATA[This is an example job description.]]></description>
    <major_category0>[Example Category]</major_category0>
    <minor_category0>[Example Category] Example Subcategory</minor_category0>
    <ranking_value>287</ranking_value>
    <cpc>2.87</cpc>
    <updated>1999-12-31 00:00:01</updated>
    <!-- Optional fields (included when enabled) -->
    <logo_url><![CDATA[https://media.j2c.com/company-logos/12345-company-name-abc123]]></logo_url>
    <talroo_apply>true</talroo_apply>
    <!-- Extraction fields (included when enabled) -->
    <all_requirements_normalized><![CDATA[{"Valid driver's license":"101001","2+ years experience":"0"}]]></all_requirements_normalized>
    <all_preferences_normalized><![CDATA[{}]]></all_preferences_normalized>
    <compensation><![CDATA[["$20-25/hour plus tips"]]]></compensation>
    <benefits><![CDATA[["Health insurance", "401k", "PTO"]]]></benefits>
    <work_schedule><![CDATA[["Full-time, weekends and holidays"]]]></work_schedule>
    <work_location_type><![CDATA[["onsite"]]]></work_location_type>
    <visa_status><![CDATA[["no_visa_information"]]]></visa_status>
  </job>
</feed>

CDATA Wrappers

Fields containing special characters (title, url, company, description, and extraction fields) are wrapped in <![CDATA[...]]> to preserve formatting.

Related documentation

• XML Integration — downloading the feed, refresh cadence, and practices
• Click Validation — eligibility, freshness, earnings impact