The Job Status API is mainly for XML publishers who want to check a job before sending a click. We recommend appending rdr instead. Most publishers don't need this API. See RDR
Job Status API
Check whether a job is still live before you send traffic. That avoids some expired clicks. For most XML publishers, rdr is simpler. Use this API if you already have a pre-click check in the path.
Use Method 2 (SPL) to catch stale clicks. SPL can tell you the cached feed is outdated. Checking by Job ID only tells you if the job is live. It cannot detect stale click data.
Method 1: Check by Job ID
Use this when you have the Job ID and want to know if that job is still live.
Endpoint
GET api.talroo.com/v2/job/{JobID}/status
Getting the Job ID
To obtain a JobID, look at your click URL from the XML feed inside the <url> tag. Inside the URL, there will be an id parameter that contains both the job id and your affiliate id separated by a period.
Example click URL:
https://www.jobs2careers.com/click.php?id=14813142427.1234&job_loc=...
In this example, 14813142427 is the Job ID.
Example Request
GET api.talroo.com/v2/job/14813142427/status
Example Response
{
"14813142427": "LIVE"
}
Method 2: Check by SPL (Feed Freshness)
XML publishers: pass the spl from the click URL to see if your cached feed is stale. If it is, refresh before those URLs stop paying.
The spl parameter is an encrypted payload on click URLs with metadata about when the job was displayed. It's in the <url> field of your feed.
Example click URL with SPL:
https://www.jobs2careers.com/click.php?id=14813142427.1234&spl=ABC123...&job_loc=...
Endpoint
POST api.talroo.com/v2/job/status
Content-Type: application/json
Example Request
POST api.talroo.com/v2/job/status
Content-Type: application/json
{
"spls": ["ABC123...", "DEF456..."]
}
Example Response
[
{"ABC123...": "LIVE"},
{"DEF456...": "STALE"}
]
Status Values
Both methods return the same status values:
| Status | Meaning |
|---|---|
LIVE | Job is active and click data is fresh |
STALE | Job is live but click data is outdated. Refresh your feed. |
EXPIRED | Job is no longer accepting clicks |
UNKNOWN | We couldn't tell |
Check status at click time, or hourly if you swap URLs.
A STALE result means the click URL is past the pricing window (often 24 hours). Re-download the feed. Stale clicks