XML Integration
XML feeds give you a bulk download of Talroo jobs for your own search infrastructure. This may seem like an easy way to get a bunch of jobs, but generating a feed for each publisher has a real cost. We prefer that smaller publishers use API integrations.
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"}.
Feed Schema
The Talroo XML schema is available here: Publisher XML Feed Specification
Refresh Frequency
We require an update at least daily. Every 3–6 hours is a better operational target; try to match the generation timing shown in TAP.
On each refresh, take down jobs that are no longer in the feed.
Expired and Stale Clicks
Expired means the job itself stopped taking full-price traffic (budget, pause, taken down). Those clicks pay about 6 cents unless we swap in a live job.
Stale means your copy of the click URL is too old (often 24 hours from when the feed was generated). The job may still be live. Those clicks are not valid.
Pass rdr if you'd rather get the user back than show a dead or swapped job. More detail: Click Validation.
Feed Settings
You can change XML settings in TAP. See Feed Configuration.
You can append any of these to the click <url> from the feed:
| Parameter | Purpose | Notes |
|---|---|---|
t1, t2, t3 | Segment reporting | Optional. Columns in the TAP earnings export. See T-Values (Tracking Tags). |
referrer | Traffic source (your domain) | Shows up in Analytics (Referrer domain) and Earnings Report. See Referrer. |
rdr | Redirect when the listing stops paying | Fully URL-encoded page on your site. See RDR (Redirect). |
Conversion Postbacks
XML does not get personalization. If you want conversion signals back, use S2S conversion postbacks.
Checklist
- Feed downloads with
id+pass; fetch everypart=when the feed is split - Refresh at least daily (first pull by 10am ET per the Terms of Service); every 3–6 hours is better
- On each refresh, take down jobs that are no longer in the feed
- Index on
<referencenumber>as the unique key - Postbacks set up with the publisher team if you need them (conversion postbacks)
- Use location fields for geographic filtering and search
- Send real jobseeker traffic. Don't trick people into clicking.
- Click Validation and Quality Score
Do not change job titles, pay language, or use deceptive practices to get users to click on jobs. Doing so may result in termination from the Talroo Publisher Program.