Skip to main content

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
ParameterDescription
idYour unique publisher ID
passYour feed password
partFeed part number (default: 1)
Credentials

Your publisher ID and feed password are available in the Feed Manager dashboard.

Multiple parts

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

Recommended every 3-6 hours; Match the feed frequency in the Talroo Dashboard.

Stale data hurts your payout

If you rely on cached click URLs longer than Talroo's pricing window, earnings drop even when traffic looks steady. Click Validation covers refresh cadence, bots/geo/duplicate considerations, and tactics (SPL checks, Job ID checks).

Feed settings and configuration

Configurable via TAP: Learn more

Optional query parameters on outbound <url> clicks

You may append these Talroo-supported query params when sending a jobseeker through the XML <url>

Optional Click Params

You can append any of these to the end of the click <url> provided by Talroo in the feed

ParameterPurposeNotes
t1, t2, t3Segment reportingOptional; columns land in the TAP earnings export. See T-Values (Tracking Tags).
referrerTraffic source (your domain)label which of your sites or surfaces sent the click. Useful for Talroo Platform Visibility. surfaces in Analytics (Referrer domain) and Earnings Report. See Referrer.
rdrRedirect when a listing <url> stops earningvalue is a fully URL-encoded page on your infrastructure. See RDR (Redirect).

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 where volume warrants it). For detailed guidance on click eligibility and expired/stale URLs, see Click Validation.

Conversion Postbacks (XML's feedback loop)

XML does not receive personalization. Talroo can mirror conversion quality signals back to you with S2S conversion postbacks.

Integration Checklist

  • Feed download successfully via id + pass; all part= files should be fetched when feed splitting is on
  • Refresh cadence is at least daily; 4–6h recommended where volume warrants it
  • Index keyed on <referencenumber> as the unique key
  • Postbacks coordinated with Publisher Team if necessary (see conversion postbacks)
  • Use location fields for geographic filtering and search.
  • Send only real, high-intent user traffic to Talroo, do not trick users into clicking on links
  • You have read and understand the Click Validation, and Quality Score
danger

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.

See also