XML Integration
XML feeds require approval. These instructions are for publishers approved to download XML feeds for their own search system.
XML feeds also have a CPA option for applications hosted through Talroo Apply.
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, replace click URLs even when the job ID is unchanged, and take down jobs no longer in the feed.
Expired and Stale Clicks
Expired means the job stopped accepting traffic at full value, for example because its budget ran out or it was paused or removed. These clicks can pay less. Talroo may replace the job with a similar active one.
Stale means the click URL's pricing window has ended, even if the job is still active. For CPC feeds, the default is 24 hours from when Talroo generates the feed, not from when you import it. Old URLs can pay less or nothing. Check Click Expiration in TAP for your feed's window.
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 | Override the source domain | Only needed to change or standardize the source domain in reports. 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.
- Review Earnings, including 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.