Talent.comIntegration Guide Talent.com integrates with your ATS to help you to optimize the hiring process, improve the job seeker experience, and help make the right hires faster.
XML Feeds
Using XML FeedsIn this first section, you will learn all there is to know regarding the content and the format XML feeds should have for your jobs to be featured on Talent.com.Using an XML feed allows you to control what you will to publish on Talent.com: the content of your job listings, the time during which they will be displayed on our website and all the specifics of the job description.
XML feed management
- By crawling an XML URL: We will extract the job listings from your XML feed once you provide us with its URL.
- By crawling an FTP site: We will extract the job listings from your FTP site once you give us access to it.
XML feed attributesThe XML feed consists of two sets of attributes:
Job attributesAll the content of the job listing must be wrapped in <![CDATA[]]> nodes.Note: Any additional information that is not shown in the following list won’t be taken into consideration.Required fields
Recommended fields
- General attributes: They refer to the whole feed and only have to be specified once (i.e. <source>, <publisher>, <publisherurl>, <lastbuilddate>, <job>).
- Job attributes: They are specific to each job posting (i.e. <title>, <company>, <city>, <state>,<country> , etc.)
| Element | Required | Description | Example value |
|---|---|---|---|
| <source> | Yes | XML feed root node | - |
| <publisher> | No | Name of the ATS that published the job | <publisher> ATS name</publisher> |
| <publisherurl> | No | Website URL of the ATS that published the job | <publisherurl>https://atssite.com</publisherurl> |
| <lastbuilddate> | No | Feed creation date (suggested format is yyyy-MM-ddTHH:mm:ssZ) | <lastbuilddate>2019-09-17T12:00:00Z</lastbuilddate> |
| <job> | Yes | Individual information of each job listed in the feed | See details in the Job attributes section |
| Element | Description | Example value |
|---|---|---|
| <referencenumber> | The job ID (assigned by the ATS) | <referencenumber><![CDATA[123_456]]></referencenumber> |
| <title> | The job title Note: Don’t include any other information such as location or job type in this tag. | <title><![CDATA[Assistant]]></title> |
| <company> | The exact company name Note: Don’t include any other information such as location or job category in this tag. | <company><![CDATA[Company 1A]]></company> |
| <city> | The city where the job is located | <city><![CDATA[Montreal]]></city> |
| <state> | The state, region or province where the job is located | <state><![CDATA[Quebec]]></state> |
| <country> | The country where the job is located | <country><![CDATA[Canada]]></country> |
| <dateposted> | The date on which the job was published (suggested format is yyyy-MM-ddTHH:mm:ssZ ) | <dateposted><![CDATA[2019-09-14T12:00:00Z]]></dateposted> |
| <url> | The URL to the original job listing Note: If you want to track clicks coming from talent, make sure to include your token in the URL (e.g. "source=talent"). | <url> <![CDATA[https://jobsite.com]]></url> |
| <description> | This information must be identical to the one shown on the job source (suggested format is HTML) (minimum 50 characters) Note: HTML format is required for the job description. | <description> <![CDATA[We’re looking for employer with 3+ years of experience...]]></description> |
| Element | Description | Example value |
|---|---|---|
| <expirationdate> | The date on which the job posting expires (suggested format is MM-dd-yyyyTHH:mm:ssZ) | <expirationdate><![CDATA[10-17-2019T12:00:00Z]]></expirationdate> |
| <streetaddress> | The street address where the job is located | <streetaddress><![CDATA[2000 N Broadway Street]></streetaddress> |
| <postalcode> | The exact company name Note: Don't include any other information such as location or job category in this tag. | <postalcode><![CDATA[60000]></postalcode> |
| <jobtype> | The job type (full time, part-time) | <jobtype><![CDATA[Full time]]></jobtype> |
| <isremote> | Whether a job is hiring remote applicants or not. Value should be "yes" or "no". | <isremote><![CDATA[no]></isremote> |
| <benefit> | See Benefit section for more details Note: categories outside of this list won’t be considered. | <category><![CDATA[Hospitality]]></category> |
| <logo> | The URL to the company’s logo (format must be .PNG. Suggested size 128 x 128 pixels) | <logo><![CDATA[https://companyslogo.com.png]]></logo> |
| <experience> | The URL to the original job listing Note: If you want to track clicks coming from talent, make sure to include your token in the URL (e.g. "source=talent"). | <experience> <experience_max> <![CDATA[5]> </experience_max> <experience_min> <![CDATA[1]> </experience_min> <period> <![CDATA[year]> </period> </experience> |
| <cpc> | The cpc value should be expressed as whole numbers | <cpc><![CDATA[15]></cpc> |
| <salary> | The salary offered should contain: • max salary • min salary • currency • period: should be express only as : (year, month, week, day, hour) type: should be expressed only as (Base salary, additional salary). | <salary> <salary_max> <![CDATA[100000]> </salary_max> <salary_min> <![CDATA[5000]> </salary_min> <salary_currency> <![CDATA[USD]> </salary_currency> <period> <![CDATA[year]> </period> <type> <![CDATA[BASE_SALARY]> </type> </salary> |
Adding Talent Apply
Our Talent Apply system allows job seekers to save time and apply for your jobs directly on Talent.com.How to add Talent ApplyIf you have already integrated an XML feed with Talent.com, and you want to make it easier for job seekers to apply for your jobs, simply add the Talent Apply function to your job listings by inserting the <talent-apply-data> tag to your existing feed.
Example of an XML feed with Talent ApplyHere is an example of how the Talent Apply function will display on your XML feed. Note: this example aims to show the <talent-apply-data> tag but all the previously mentioned elements must be included in the feed.
1<xml version="1.0" encoding="utf-8">
2<source>
3 <publisher/>
4 <publisherurl/>
5 <lastbuilddate/>
6 <job>
7 <title/>
8 <company/>
9 <city/>
10 <state/>
11 <country/>
12 <dateposted/>
13 <expirationdate/>
14 <referencenumber/>
15 <url/>
16 <description/>
17 <salary/>
18 <jobtype/>
19 <category/>
20 <logo/>
21 <talent-apply-data>
22 <![CDATA[talent-apply-posturl=https%3A%2F%2Famazingcompany.com%2F%0A&talent-apply-questions=https%3A%2F%2Fwww.talent.com%2Fintegrations%2Fquestions]]>
23 </talent-apply-data>
24 </job>
25</source>
26Talent Apply configuration requirementsIn order to configure Talent Apply in an XML feed, the following requirements must be met:
- Attributes must be URL encoded.
- All fields must be filled.
- Data attributes must include the prefix talent-apply-
- Know to which job each candidate has applied.
- Customize the information you want to receive from each candidate.
| Element | Required | Description | Example value |
|---|---|---|---|
| posturl | YES | The URL where the application data is sent (it should be encoded in an XML files). | http://www.company1a.com/process-applications |
| questions | NO | A URL which generates a JSON-formatted string with the application process content. Note: The default questions ask the candidates’ first name, last name, email, and phone number. |
Questions
Screening questions will help you get applicants information easier and makes sure your clients find the right person for the job while saving time, effort and money.Including screening questionsAdding the right questions to your application process can help you filter candidates and find the right fit faster, saving you time. Read below to learn about the different types of screening questions available.
Types of screening questions Type: HierarchicalA question that displays additional questions and answers depending on the applicant’s answer to the previous question. For example, once the candidate chooses a state/province, you could display a drop-down menu with all the cities in that state, so the applicant can pick one from the list. ExampleJSON for screener questionsThis segment provides a list of parameters that will be used in creating all question types.
Talent.com tips:
Type: Text areaA question applicants will be able to answer with a short paragraph. Example- Focus on questions that are specific to the position you're trying to fill.
- Go past the candidate's experience, which should be on their resume. Try to get to know them a bit better before a potential interview!
- When in doubt, ask your legal department. Better safe than sorry!
- Make sure candidates don't have to second guess your questions. Be clear, straightforward, and you'll get the information you need.
{
"id": "strengthstext",
"type": "textarea",
"question": "Name 3 of your strengths and explain how they help you in your daily work.",
"required": true
}
Questions requiring textual and numerical answers Type: TextA question candidates will answer in one line to share very specific information (e.g., degree, age , contact information, etc.). Note: for numerical questions, you can specify the format of the number you want (integer, decimal, etc.). Type: No format specification Example{
"id": "degree",
"type": "text",
"question": "What’s your highest degree of education?",
"required": true
}
Format: IntegerCandidates can only answer with whole numbers. Decimals and leading zeros are not allowed. Example{
"id": "age",
"type": "text",
"format": "integer",
"question": "What’s your age?",
"required": true,
"min": "18",
"max": "70"
}
Format: DecimalAnswers can should use with decimal numbers. In this configuration, trailing and leading zeros are allowed. Example{
"id": "gpa",
"type": "text",
"format": "decimal",
"question": "What was your GPA?"
}
Format: Numeric textApplicant's answers can include leading zeros. Decimals are not allowed. Example{
"id": "idnumber",
"type": "text",
"format": "numeric_text",
"question": "Enter the last 4 digits of any ID you have(e.g. passport or license.)",
"required": true
}
Type: SelectA question that displays a drop-down menu from which candidates can only choose one answer. Example{
"id": "maritalstatus",
"type": "select",
"question": "What’s your marital status?",
"required": true,
"options": [
{
"value": "0",
"label": "Decline to answer"
},
{
"value": "1",
"label": "Single"
},
{
"value": "2",
"label": "Married"
},
{
"value": "3",
"label": "Separated"
},
{
"value": "4",
"label": "Divorced"
}
]
}
Type: ConditionalA question that is shown or not, depending on the applicant’s answer to the previous question. For example, if you ask an applicant if they have a bachelor’s degree and their answer is yes, a question asking them to provide their certification could appear. If the answer is no, that extra question will stay hidden. Example{
"id": "bachelors-degree",
"question": "Do you have a bachelor’s degree?",
"required": true,
"options": [
{
"value": "1",
"label": "Yes"
},
{
"value": "0",
"label": "No"
}
],
"type": "select"
}
{
"id": "certification",
"question": "Can you provide a certification?",
"condition": {
"id": "bachelors-degree",
"value": "0"
},
"options": [
{
"value": "1",
"label": "Yes"
},
{
"value": "0",
"label": "No"
}
],
"type": "select"
}
{
"id": "location",
"type": "hierarchical",
"question": "State",
"required": true,
"options": [
{
"value": "0",
"label": "Texas"
},
{
"value": "1",
"label": "Alabama"
},
{
"value": "2",
"label": "New York"
}
],
"hierarchicalOptions": [
{
"id": "texas_cities",
"options": [
{
"value": "0",
"label": "Austin"
},
{
"value": "1",
"label": "Houston"
}
],
"condition": {
"id": "hierarchical",
"value": "0"
}
},
{
"id": "alabama_cities",
"options": [
{
"value": "0",
"label": "Birmingham"
},
{
"value": "1",
"label": "Ashville"
}
],
"condition": {
"id": "hierarchical",
"value": "1"
}
},
{
"id": "birmingham_zipcodes",
"options": [
{
"value": "0",
"label": "35005"
},
{
"value": "1",
"label": "35064"
}
],
"condition": {
"id": "alabama_cities",
"value": "0"
}
}
]
}
Type: MultiselectA question the applicant can answer by choosing several options from a list. Example{
"id": "favoriteanimals",
"type": "multiselect",
"question": "What are your favorite animals?",
"required": true,
"options": [
{
"value": "0",
"label": "Dog"
},
{
"value": "1",
"label": "Cat"
},
{
"value": "2",
"label": "Fish"
}
]
}
Type: DateA question the applicant can only answer with a date. Example{
"id": "startdate",
"type": "date",
"question": "When can you start working?",
"required": true,
"format": "dd/MM/yyyy"
}
Type: InformationDoes a question need more context? Want to guide the applicant? Use this option to add useful information to your form. Example{
"id": "header",
"type": "information",
"text": "Please, answer the following questions to complete your application",
"required": true
}
Type: Page breakControl the layout of your application form with page breaks: all questions included between two <pagebreak> tags will appear on the same page. Example{
"id": "page1_open",
"type": "pagebreak"
}
{
"id": "sample",
"type": "text",
"question": "What’s your marital status?"
}
{
"id": "page1_close",
"type": "pagebreak"
}
| Parameter Name | Required | Description | Allowed Values | Example |
|---|---|---|---|---|
| id | YES | Unique ID for each question | Any string | age |
| type | YES | The type of question. | • Text area • Text • Select • Multiselect • Date • Information • Page break • Hierarchical | multiselect |
| question | No: for type=information and type=pagebreak Yes: for the other question types | The question that is shown to applicants | Any string | “Are you currently working?” |
| text | No: for type=information and type=pagebreak Yes: for the other question types | The text that applicants see | Any string | “Please, answer the following questions.” |
| options | Yes: for type=select and type=multiselect | The list of options available in the drop-down menu | JSON | {"value":"1","label":"Married"} |
| value | Yes: for type=select and type=multiselect | The number/letter associated to each answer from drop-down menus | Any string | 1 |
| label | Yes: for type=select and type=multiselect | The text for each option in drop-down menus | Any string | Married |
| format | Yes: for type=date No: for type=text | It can be paired with type:text, to force integer, decimal, or numeric_text validation, or with type:date to point out how to parse date input | Text formats: • integer • decimal • numeric_text Date format: • dd/mm/yyyy | dd/mm/yyyy |
| limit | No | Character limit for candidates’ answers (for type=text and type=textarea) | Any integer | 50 |
| min | No | The minimum value the answer should have (for format=integer and format=decimal) Note: For type=date, the answer has to be “on” or “after” | Use format=integer to add integer numbers and format=decimal to add decimal numbers. To add a date, use type=date (in the specified format) | 0 |
| max | No | The maximum value the answer should have (for format=integer and format=decimal) Note: For type=date, the answer has to be “on” or “before”. | For any integer format=integer for any decimal format=decimal for any date type=date (in the specified format) | 50 |
| condition | No | It’s used to mark a question as conditional, depending on how a previous select question was answered. You have to specify the id of the previous question, as well as the option value that triggers this question. | JSON | [{"condition":{"id":"degree1","value":0}}] |
Application data delivery
Receive applications through PostURLTo receive applications through a URL or endpoint, we will send a POST call with the applicants’ information (JSON format). You will receive the applicant’s full name, email address, phone number and curriculum vitae.The JSON response could contain:JSON with questions example
- A standard JSON if no questions are asked.
- A JSON with questions with their corresponding answers if questions are asked.
1{
2 id: "60iiovDSr61jUlgw",
3 applicant: {
4 fullName: "Richard Roe",
5 phoneNumber: "5555555555",
6 email: "richard.roe@domain.com",
7 resume: {
8 file: {
9 fileName: "curriculum.pdf",
10 contentType: "application/pdf",
11 data: "OcIqMT4xfL6f187V",
12 },
13 },
14 },
15 job: {
16 jobCompany: "Amazing Company",
17 jobId: "85sezqas895ws-s",
18 jobLocation: "CA",
19 jobTitle: "General Labourer",
20 },
21 analytics: {
22 ip: "##.##.###.##",
23 useragent:
24 "Mozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
25 device: "mobileapp",
26 },
27}1{
2 "id": "60iiovDSr61jUlgw",
3 "applicant":{
4 "fullName":"Richard Roe",
5 "phoneNumber":"3145178965",
6 "email":"richard.roe.bc@domain.com",
7 "resume":{
8 "file":{
9 "fileName":"curriculum.pdf",
10 "contentType":"application/pdf",
11 "data":"base64"
12 }
13 }
14 },
15 "job":{
16 "jobCompany":"Company Name",
17 "jobId":"85sezqas895ws-s",
18 "jobLocation":"CA",
19 "jobTitle":"General Labourer"
20 },
21 "questions":{
22 "answers":[
23 {
24 "id":"strengthstext",
25 "value":" My greatest strength is my writing skills. I can also work to tight deadlines under pressure. For example, I was once asked to complete a project that fell through the cracks. My editor discovered the mistake two hours before the deadline. It was an important piece that gave our publication a scoop on the topic in question. Not only did the piece have to go out on time, but it had to be perfect. I hunkered down and wrote. The result? The article was on time and acclaimed."
26 },
27 {
28 "id":"degree",
29 "value":"Master's degree"
30 },
31 {
32 "id":"age",
33 "value":"30"
34 },
35 {
36 "id":"gpa",
37 "value":"3.87"
38 },
39 {
40 "id":"idnumber",
41 "value":"0539"
42 },
43 {
44 "id":"maritalstatus",
45 "value":"2"
46 },
47 {
48 "id":"bachelors-degree",
49 "value":"1"
50 },
51 {
52 "id":"certification",
53 "value":"1"
54 },
55 {
56 "hierarchicalAnswers":[
57 {
58 "id":"location",
59 "value":"0"
60 },
61 {
62 "id":"alabama_cities",
63 "value":"0"
64 },
65 {
66 "id":"birmingham_zipcodes",
67 "value":"1"
68 }
69 ],
70 "id":"location",
71 "values":[
72 "0",
73 "0",
74 "1"
75 ]
76 },
77 {
78 "id":"favoriteanimals",
79 "values":[
80 "0",
81 "1"
82 ]
83 },
84 {
85 "id":"startdate",
86 "value":"15/09/2019"
87 }
88 ],
89 "questions":[
90 {
91 "id":"strengthstext",
92 "type":"textarea",
93 "question":"Name 3 of your strengths and explain how they help you in your daily work.",
94 "required":true
95 },
96 {
97 "id":"degree",
98 "type":"text",
99 "question":"What’s your highest degree of education?",
100 "required":true
101 },
102 {
103 "id":"age",
104 "type":"text",
105 "format":"integer",
106 "question":"What’s your age?",
107 "required":true,
108 "min":"18",
109 "max":"70"
110 },
111 {
112 "id":"gpa",
113 "type":"text",
114 "format":"decimal",
115 "question":"What was your GPA?"
116 },
117 {
118 "id":"idnumber",
119 "type":"text",
120 "format":"numeric_text",
121 "question":"Enter the last 4 digits of any ID you have(e.g. passport or license.",
122 "required":true
123 },
124 {
125 "id":"maritalstatus",
126 "type":"select",
127 "question":"What’s your marital status?",
128 "required":true,
129 "options":[
130 {
131 "value":"0",
132 "label":"Decline to answer"
133 },
134 {
135 "value":"1",
136 "label":"Single"
137 },
138 {
139 "value":"2",
140 "label":"Married"
141 },
142 {
143 "value":"3",
144 "label":"Separated"
145 },
146 {
147 "value":"4",
148 "label":"Divorced"
149 }
150 ]
151 },
152 {
153 "id":"bachelors-degree",
154 "question":"Do you have a bachelor’s degree?",
155 "required":true,
156 "options":[
157 {
158 "value":"1",
159 "label":"Yes"
160 },
161 {
162 "value":"0",
163 "label":"No"
164 }
165 ],
166 "type":"select"
167 },
168 {
169 "id":"certification",
170 "question":"Can you provide a certification?",
171 "condition":{
172 "id":"bachelors-degree",
173 "value":"0"
174 },
175 "options":[
176 {
177 "value":"1",
178 "label":"Yes"
179 },
180 {
181 "value":"0",
182 "label":"No"
183 }
184 ],
185 "type":"select"
186 },
187 {
188 "id":"location",
189 "type":"hierarchical",
190 "question":"State",
191 "required":true,
192 "options":[
193 {
194 "value":"0",
195 "label":"Texas"
196 },
197 {
198 "value":"1",
199 "label":"Alabama"
200 },
201 {
202 "value":"2",
203 "label":"New York"
204 }
205 ],
206 "hierarchicalOptions":[
207 {
208 "id":"texas_cities",
209 "options":[
210 {
211 "value":"0",
212 "label":"Austin"
213 },
214 {
215 "value":"1",
216 "label":"Houston"
217 }
218 ],
219 "condition":{
220 "id":"hierarchical",
221 "value":"0"
222 }
223 },
224 {
225 "id":"alabama_cities",
226 "options":[
227 {
228 "value":"0",
229 "label":"Birmingham"
230 },
231 {
232 "value":"1",
233 "label":"Ashville"
234 }
235 ],
236 "condition":{
237 "id":"hierarchical",
238 "value":"1"
239 }
240 },
241 {
242 "id":"birmingham_zipcodes",
243 "options":[
244 {
245 "value":"0",
246 "label":"35005"
247 },
248 {
249 "value":"1",
250 "label":"35064"
251 }
252 ],
253 "condition":{
254 "id":"alabama_cities",
255 "value":"0"
256 }
257 }
258 ]
259 },
260 {
261 "id":"favoriteanimals",
262 "type":"multiselect",
263 "question":"What are your favorite animals?",
264 "required":true,
265 "options":[
266 {
267 "value":"0",
268 "label":"Dog"
269 },
270 {
271 "value":"1",
272 "label":"Cat"
273 },
274 {
275 "value":"2",
276 "label":"Fish"
277 }
278 ]
279 },
280 {
281 "id":"startdate",
282 "type":"date",
283 "question":"When can you start working?",
284 "required":true,
285 "format":"dd/MM/yyyy"
286 }
287 ]
288 },
289 "analytics":{
290 "ip":"96.48.150.98",
291 "useragent":"Mozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
292 "device":"mobileapp"
293 }
294}Appendix
Jobtype sectionBenefits SectionJob Categories section
Full time
Internship
CDI
Part time
Volunteer
Alternance
Contract
CDD
Other
Temporary
Medical insurance
Pension plan
Student loan assistance
Vision insurance
Child care support
Tuition assistance
Dental insurance
Paid maternity leave
Disability insurance
401(k) match
Commuter benefits
Accounting
Administration
Agriculture
Arts
Computer
Construction
Consulting
Customer Service
Education
Engineering
Finance
Food Industry
Healthcare
Hospitality
Human Resources
Insurance
IT
Legal
Logistics
Manufacturing
Marketing
Media
Multimedia
Nursing
Physicians
Sales
Scientific
Security
Services
Skilled Labor
Social Care
Telecommunications
Training
Transportation
Travel
Retail
Warehouse