XML Job Feed Specifications

Providing us with an XML feed is the most reliable way to get your jobs included on Whatjobs.com. You must provide us with a URL where your XML feed is located. The feed should contain all the current jobs published on your website.

Submit XML
Feed Format Required Tags Optional Fields XML Feed Examples TheWhatBot

XML Feed Format

We strongly recommend you specify the current encoding of an XML feed in its header (for example, <?xml version="1.0" encoding="utf-8"?>). If you cannot do this, it is very unlikely your jobs will perform well and may not be indexed.

All job content must be inside CDATA sections to avoid issues in processing your XML job feed. Your XML feed must contain one common tag.

Every single job must be inside a separate tag; this tag must contain a single "id" attribute, which must show a unique job ID.

The <job> tag must contain the following criteria, or your feed will be rejected by our processor:

Coding

Required Tags

<id> <link> <title> <location> <country> <language> <description> <pubdate> <CPC> <updated> <salary> <company> <expire> <jobtype>

Optional Tags to improve performance:

<company_logo> <joblocationtype> <category> <zipcode> <street>
  • <id>
    Identification of the job on your website as numeric or alphanumeric. However, it must be unique.
  • <link>
    The full URL of the job, where WhatJobs will redirect users to. The link must lead to a page with a complete job description.
  • <title>
    The job title of the job being presented.
  • <location>
    The town, region, or city of the job being presented. Locations can be listed in a text format and separated by punctuation marks.
  • <country>
    The country in which this job is advertised. This must match the data in your location tag.
  • <language>
    Two digit language ISO Code. To inform us about the language of the job listing.
  • <description>
    The complete job description. We are unable to index an XML feed that contains incomplete job descriptions.
    All additional fields, such as "job description", "candidates", "requirements", "responsibilities", "working conditions" on a job page, must be included in the <description> tag. (all jobs must contain the full job description, or they will be rejected)

    You must format the description in HTML.
    At minimum, add paragraph breaks using <br>, <p>.
    The feature recognizes the following HTML tags: <p>, <ul>,<b> and <li> .
    The feature doesn't recognize header and character-level tags, such as <h1>. While the tags won't affect the formatting in the feature, you can safely include them on the page.
  • <CPC>
    Cost-per-click (CPC) bidding means that you pay for each click on your job ad.
  • <pubdate>
    Original publication date of a job. Please specify the date in the DD.MM.YYYY format.
  • <updated>
    last modification date of a job. By this, we mean the last time when the original publication date of a job was updated or when an employer edited a job description. Please specify the date in the DD.MM.YYYY format.
  • <salary>
    salary + currency. For example, "$25", "€20,000", or "£1,500".
  • <company>
    Name of a company or recruiter.
  • <expire>
    The date when the job expires. Please specify the date in the DD.MM.YYYY format.
  • <jobtype>
    The type of job being advertised, for example, full-time, part-time, contract, internship, temporary, or graduate.
  • <company_logo>
    WhatJobs may display a company logo on the search results page. If you want us to display your client’s company logo, you must add a tag with a URL address of the company logotype.

    Acceptable Formats:
    - SVG (Preferred)
    - PNG (Max 50KB)
  • <joblocationtype>
     This specifies that the job can be done from a remote location. You can also use the ‘telecommute’ value to indicate that the job can be done remotely. This will help us deliver better-quality candidates.
  • <category>
    Category a particular job belongs to, i.e. Legal, Engineering, Sales etc.
  • <zipcode>
    The Zipcode to which the job belongs.
  • <street>
    Should include the street name and number of the job location
Coding

Important

WhatJobs will only index jobs published less than 28 days ago. This rule applies to <updated> and <pubdate> tags. If a job does NOT have <updated> and <pubdate> tags, then the job will have a default value of 28 days.

Sending accurate job descriptions from your website using the required tags may increase your visibility on Whatjobs, resulting in greater targeted traffic and a higher CPA.

Example of an XML Feed:

XML feed

TheWhatBot

A thought

To enhance the quality of the jobs from your XML feed, we may use a web crawler, which identifies itself as 'TheWhatBot’ or

'HTTP/1.1 TheWhatBot (compatible; https:/whatjobs.com/thewhatbot)'

TheWhatBot crawls XML feeds at least once every 24 hours. The time and frequency of crawling can be adjusted to your requirements.

If you have any questions, contact us or speak with your account manager directly.

A thought