Job Status API
The Job Status API allows publishers to check whether jobs are still active before sending traffic. This helps avoid wasted clicks on expired jobs and ensures you receive full payout for valid clicks.
If you are an XML publisher, use Method 2 (SPL) to check for stale clicks. The SPL endpoint can detect when your cached feed data is outdated, allowing you to refresh your feed before losing earnings on stale click URLs. The Job ID method only tells you if a job is live—it cannot detect stale click data.
Method 1: Check by Job ID
Use this method when you have the Job ID and want to verify if a specific 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)
This method is primarily useful for XML publishers who want to know if a click is stale—indicating that refreshing the feed might be necessary to avoid loss in earnings.
XML publishers can check whether their cached feed data is stale by passing the spl parameter from click URLs. This helps detect when your XML feed should be refreshed to get updated click URLs.
What is an SPL?
The spl parameter is an encrypted payload included in click URLs that contains metadata about when the job was displayed. You can find it 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 | Unable to determine status |
Best Practices
We recommend checking job status at click time or hourly if you are swapping URLs. This prevents wasted clicks on expired jobs and ensures you receive full payout for valid clicks.
A STALE status indicates that the click URL has passed the EPC expiration window (typically 24 hours). You should re-download your XML feed to get fresh click URLs and ensure full payout.