An XML file is used to describe currently available jobs openings. All valid tags are described below. Tag names must be given exactly as below, in English, while text in tag values can be given in any language, using UTF-8 encoding.
Note: All string tags must have their values wrapped as CDATA, for example
<![CDATA[Some Data]]>
.
source tag
Name | Description |
---|---|
publisher-name Type: string | Required Max characters: 1000 The name of your organization. Plain text only. Example: awesome-ats |
publisher-url Type: string | Required Max characters: 1000 The URL of your organization's website, including leading http:// or https://. Example: http://www.awesome-ats.com |
last-build-date | Optional |
job | Required |
job tag
Name | Description |
---|---|
job-type | Optional & Recommended |
remote-type | Optional
|
organization-data-policy-url | Optional & Recommended |
city | Optional |
postal-code | Optional |
salary | Optional |
target-location | Optional |
country-wide | Optional |
region-wide | Optional |
employer | Optional |
industry | Optional |
category | Optional Max characters: 1000
|
valid-through | Optional |
experience | Optional |
mobile-friendly | Optional |
media-url | Optional |
title | Required |
date | Required |
identifier | Required |
description | Required Greet customers with energy! Arrange shopping carts, help customers with information. |
bid | Optional 0.35 |
target-cpa | Optional 100.00 |
organization | Required |
url | Required |
region | Required if region-wide is used |
country | Optional and Recommended |
salary-currency | Required if salary is used |
salary-type | Required if salary is used |
<?xml version="1.0" encoding="utf-8"?>
<source>
<!-- Publisher and feed info -->
<publisher-name>Your ATS</publisher-name>
<publisher-url>http://www.yourdomain.com</publisher-url>
<last-build-date>2020-11-06 18:47:08 +0000</last-build-date>
<!-- Job tag. Repeat for each job opening. -->
<job>
<!-- Basic job info -->
<title><![CDATA[Mechanical Engineer]]></title>
<date><![CDATA[2020-11-06 18:47:08 +0000]]></date>
<identifier><![CDATA[unique11111]]></identifier>
<description><![CDATA[Mechanical Engineer. Help develop a perpetual motion machine. Great perks.]]></description>
<job-type><![CDATA[FULL_TIME]]></job-type><!-- optional. -->
<organization><![CDATA[Hiring Company, Ltd.]]></organization>
<organization-data-policy-url>
<![CDATA[https://www.hiringcompany.com/policy.html]]>
</organization-data-policy-url><!-- optional. -->
<experience><![CDATA[5+ years]]></experience><!-- optional. -->
<valid-through><![CDATA[2020-11-09 18:47:08 +0000]]></valid-through><!-- optional. -->
<mobile-friendly><![CDATA[True]]></mobile-friendly><!-- optional. -->
<category><![CDATA[Mechanical Engineers]]></category><!-- optional. -->
<industry><![CDATA[Manufacturing]]></industry><!-- optional. -->
<employer><![CDATA[Employer, Inc.]]></employer><!-- optional. -->
<remote-type><![CDATA[WFH_FLEXIBLE]]></remote-type><!-- optional. -->
<!-- Location -->
<city><![CDATA[New York]]></city><!-- optional. -->
<country><![CDATA[US]]></country>
<region><![CDATA[NY]]></region><!-- optional. -->
<postal-code><![CDATA[94025]]></postal-code><!-- optional. -->
<target-location><![CDATA[Buffalo, NY, US]]></target-location><!-- optional. -->
<country-wide><![CDATA[True]]></country-wide><!-- optional. -->
<region-wide><![CDATA[False]]></region-wide><!-- optional. -->
<!-- Salary -->
<salary><![CDATA[100000]]></salary><!-- optional. -->
<salary-currency><![CDATA[USD]]></salary-currency><!-- optional. -->
<salary-type><![CDATA[ANNUALLY]]></salary-type><!-- optional. -->
<media-url><![CDATA[https://youtu.be/7WH8uxXXe9o]]></media-url><!-- optional. -->
</job>
<!-- ...add more <job> tags for additional jobs -->
</source>
Redirect URL
When redirecting a user to our system, if the job is expired, we can redirect the user back to your system to show an expired page. Additionally, it allows you to mark the click as expired on your end to better match the numbers between your system and ours.
Attach your desired redirect URL with the job URL from the feed using the parameter redirect_url
. If you are marking the click as expired on your end you should include a way to distinguish the click via an identifier within your redirect URL.
Examples
In the example below the user will be sent to http://www.your-website.com/expired
if the job is expired in our system. It also will include the identifier for the click (as generated by you) click_id=abf4f895-eaba-4688-9d90-c15d58dc786e
which can be used by your system to mark it as expired.
https://track.jobadx.com/v0/clk/dz1qe2JoPHgtZXhjaGFuZ2UmYT1sb2NhbHdvcmsmZj0wNzI2MjcxODNkZDg5NTA5ZTgyZTlhYzMxNTViZTY3YSZqPTIyOThmMTFkLTlmZDEtNDEyNi05MTk5LWQ5YjFhNWUwZjc0MSZjPTAuNzMmY2o9NDU2YTc1MzUtYzk4NC00NzZmLWFhMWYtN2UzZDg2MmMzOWMy?1=&redirect_url=http://www.your-website.com/expired?click_id=abf4f895-eaba-4688-9d90-c15d58dc786e