Advertisers XML Feed Specifications

In order to import your feed into Optimize you will need to map your feed tags. Below is a list of mappable tags. If you require additional fields we offer dynamic fields which you can add on the account Details page.

Note: All string tags where content could contain HTML or non UTF-8 characters should have their values wrapped as CDATA, for example <![CDATA[Some Data]]>.

Note: Include <?xml version="1.0" encoding="UTF-8"?> at the top of the file (version and encoding type may vary).

Advertiser Source Tag

The following tags are mappable to non-job fields. They are for giving us information about the feed file.

Name	Description
publisher_name Type: string	Optional The name of the creator of the feed. Example: Your Company
publisher_url Type: string	Optional The website URL of the feed creator, including leading http:// or https://. Will always be our company URL. Example: https://www.your-company-website.com
last_build_date Type: string	Optional The date this feed was last updated, in RFC3339 format with a space separator. Example: 2020-11-06 18:47:08 +0000
job Type: wrapper	Required Each instance of this tag defines a job. See the full specification in the table below.

Advertiser Job Tag

The following tags are mappable to any tags within your job.

Name	Description
job_type Type: string	The type of role. Example: Full-time
city Type: string	City where the job is located. Example: Menlo Park
postal_code Type: string	Postal code for where the job is located. In the United States this is the zip code. Example: 94025
salary Type: string	Salary of this job, can contain currency value and separators. Example: $150,000
target_location Type: string	Location of the target audience. Example: Buffalo, NY, US
employer Type: string	The name of the employer. This field is an additional qualifier for the organization field which is the main company field. Example: Acme Inc.
industry Type: string	The industry associated with the job position. Example: Finance
category Type: string	A category describing the job. Example: Computer Hardware Engineers
valid_through Type: string	The date after when the job is not valid, in RFC3339 format with a space separator. Example: 2020-11-06 18:47:08 +0000
experience Type: string	Description of skills or experience needed for the position or Occupation. Example: 5+ years
title Type: string	Required The job title. Example: Cashier
date Type: string	Required The date the job was posted, in RFC3339 format with a space separator. Example: 2020-11-06 18:47:08 +0000
identifier Type: string	Required A unique ID for the job Example: JID-20394874
description Type: string	Required The job description text. Example: Greet customers with energy! Arrange shopping carts, help customers with information.
bid Type: float	The job's payout. Expects a float value in the base unit currency for your company. Example: 0.35
target_cpa Type: float	The job's target cost per apply. Expects a float value (in dollars) Example: 100.00
organization Type: string	Required The name of the hiring company. Note this is usually not your company, but the company that is offering the job. Example: Hiring Company, Ltd.
url Type: string	Required URL of the job. Example: https://www.example.com/the-job
region Type: string	Required Region where the job is located within the country. Example: CA
country Type: string	Defaults to US 2-letter ISO 3166-1 code or full name for the country where the job is located. Example: US
requisition_id Type: string	The requisition ID for the job. While recommended, this does not have to be unique. Example: REQ-123
job_schedule_shift Type: string	The shift schedule for the job Example: Weekdays, 9pm to 5pm
remote_type Type: string	Lists whether the job is fully remote, in person, or anywhere in between. Example: WFH
requisition_details Type: string	Additional requisition details for the job. Example: Urgent
business_unit_division Type: string	The business unit division for the job. Example: Corporate
education Type: string	The amount of education needed for the role. Example: Bachelors Degree
street_address Type: string Type: string	The street address for the job Example: 123 Wonderland Road

While we can accommodate various feed configurations our recommended format looks as follows:


<!-- File Information -->
<?xml version="1.0" encoding="utf-8"?>
<!-- Start of feed content -->
<source>

<!-- Publisher and feed info -->
<publisher-name>Your Company</publisher-name>
<publisher-url>https://www.your-company-website.com</publisher-url>
<last-build-date>2024-08-12 18:47:08 +0000</last-build-date>

<!-- Job tag. Repeat for each job opening. -->
<job>
  <title>Mechanical Engineer</title>
  <date>2020-11-06 18:47:08 +0000</date>
  <identifier>JID-10394857283</identifier>
  <requisition-id>RID-19238475</requisition-id>
  <organization>Hiring Company, Ltd.</organization>
  <url>https://track.jobadx.com/v0/clk/YT1zbWFydC1yZW3MmZj0wMUo1M1hFSDIwMEtRMlEyRkhXUUpESzAzWSZjaj1iYzJiYjgwOC05MGE2LTQzZTEtYjVjOS1kYWVjYzk2OTQ0YWQmYj0wLjc1JmNvPWpvYmFkeC1wcm9ncmFtbWF0aWM?1=</url><!-- This is a sample URL resembling one that will be sent, it does not work -->
  <job-type>FULL_TIME</job-type>
  <remote-type>FULLY_REMOTE</remote-type>
  <city>Buffalo</city>
  <region>NY</region>
  <country>US</country>
  <postal-code>94025</postal-code>
  <salary>100000</salary>
  <target-location>Buffalo, NY, US</target-location>
  <employer>Employer, Inc.</employer>
  <industry>Manufacturing</industry>
  <category>Mechanical Engineers</category>
  <valid-through>2020-11-09 18:47:08 +0000</valid-through>
  <experience>5+ years</experience>
  <description><![CDATA[Mechanical Engineer. Help develop a perpetual motion machine. Great perks.]]></description>
  <bid>0.78</bid>
  <target-cpa>5.23</target-cpa>
  <street-address>123 Wonderland Road, Buffalo, NY, US 94025</street-address>
</job>
</source>