Publisher XML Feed Specification
This document describes the structure and fields of the bulk XML feed that publishers receive from Talroo. For guidance on choosing between XML, API, or Widget integration, see XML vs. API vs. Widget Publishers.
Accessing Your Feed
Publishers can download their XML feed from the following endpoint:
https://feeds.talroo.com/download?id=YOUR_PUBLISHER_ID&pass=YOUR_PASSWORD&part=1
| Parameter | Description |
|---|---|
id | Your unique publisher ID |
pass | Your feed password |
part | Feed part number (default: 1) |
Your publisher ID and feed password are available in the Feed Manager dashboard.
Large feeds may be split into multiple parts. If your feed contains more jobs than can fit in a single file, you will need to download additional parts by incrementing the part parameter (e.g., &part=1, &part=2, &part=3, etc.). Continue fetching parts until you receive: {"message": "No feed available for YOUR_PUBLISHER_ID"}.
Refresh Frequency
We recommend refreshing your feed at least once every 24 hours to ensure job listings remain current. Jobs can expire or pause at any time, so more frequent refreshes (every 4-6 hours) will improve click payout.
Clicks on jobs with pricing older than 24 hours will be discarded. Always use the most recent feed data to ensure accurate CPC tiers and avoid rejected clicks.
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 |
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"] |
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>
Fields containing special characters (title, url, company, description, and extraction fields) are wrapped in <![CDATA[...]]> to preserve formatting.
Best Practices
Click Tracking
- Always use the provided
<url>for all job clicks to ensure proper attribution - Do not cache or modify click URLs
- Clicks must originate from real user interactions
Avoiding Expired Clicks
Jobs can expire or pause between feed refreshes. To avoid sending clicks to expired jobs, refresh your feed frequently (every 4-6 hours recommended).
For detailed guidance on avoiding expired clicks, see XML: Maximizing Monetization.
Data Quality
- Index jobs by
<referencenumber>as your unique key - Use location fields for geographic filtering and search
Related Documentation
- XML vs. API vs. Widget Publishers - Compare integration options
- XML: Maximizing Monetization - Avoid expired clicks and maximize revenue
- Quality Score - How click quality affects your account