Add your advertisements from your website to the search results of CityList Jobs
We just need an XML feed of your job advertisements and shortly these will visible within the search results for CityList Jobs.
An XML feed is a simple text file with specific formatting (XML) that contains its own structured information of your job advertisements.
Making an XML feed for job advertisements is simple to do using any programming language, even the one which runs your web site.
|<?xml version="1.0" encoding="UTF-8" ?>|
<!DOCTYPE feed SYSTEM "http://www.verthink.com/dtd/job-1.0.dtd">
|XML file header. The encoding must be UTF-8; of course the textual content must be encoded in UTF-8. Obligatory.|
|feed||This is root node and contains the XML Feed of CityList Jobs. Obligatory.|
|feed/version||The version number of XML Feed of CityList Jobs: currently 1.0. Obligatory.|
|feed/info||The node contains all the information relating to the specific feed. Obligatory.|
|feed/info/publisher||Information relating to the publisher. Obligatory.|
|feed/info/publisher/name||The name of the publisher. Example: "Temporary Work Inc.". Obligatory.|
|feed/info/publisher/site||The publisher web site. Example: "http://www.example.com/". Obligatory.|
|feed/info/publisher/email||Publisher's XML Feed mail address. Example: "email@example.com". Obligatory.|
|feed/info/build-date||XML Feed build date (not of the programme that generates the feed itself) formatted like so: RFC 2822. Example: "Wed, 23 Oct 2019 13:06:05 +0200" Obligatory.|
|feed/info/engine||For CityList Jobs this value is always "job". Obligatory.|
|feed/info/multipage||This macro-node contains information relating to multipage feeds where the number of advertisements is very high. An XML Feed can in fact be divided into several pages of smaller sizes. Is recommended not to exceed, for a single feed, about 1.000 ads.|
|feed/info/multipage/base-url||The node contains the base URL of the feed without the parameter that controls the required page number. Obligatory if multipage.|
|feed/info/multipage/page-param||This node contains the name of the parameter to add to the URL in the format "?param_name=value" (HTTP GET request only). Obligatory if multipage.|
|feed/info/multipage/pages||The pages node contains information on the current page and on the last page available. Obligatory if multipage.|
|feed/info/multipage/pages/current||This node contains the feed page number currently generated (must be equal to the value of the parameter page-param the GET request sent or to the value "1" if the request has been carried out without specifying any parameter). The request which comes next will be made with this value increased by 1 (up to the value of the nodelast, included). Obligatory if multipage.|
|feed/info/multipage/pages/last||This node contains the number of the last feed page. CityList Jobs will run through all the pages from 1 to the number in this parameter. Obligatory if multipage.|
|feed/items||The items node contains the number of all ads inside item nodes. Obligatory.|
|feed/items/item[@kind]||The item node contains information related to a single ad.|
It's obligatory to specity an attribute kind that can be one of these values:
Obligatory tag and attribute @kind.
- new : all obligatory nodes must be specified; ad is treated as new and is indexed;
- deleted : ad is deleted from index. The only node that is obligatory to specify is unique-reference.
|feed/items/item/metadata||This macro-node contains descriptive information of the advertisement. Obligatory.|
|feed/items/item/metadata/unique-reference||This is the most important node of the macro-node metadata: it contains the identifier of the advertisement.|
We use this identifier to refer to the inserted advertisement. If the identifier exists already in our indices (for the same publisher/name) it will be discarded (if you run an operation[@kind = "new"]) or deleted (if you run an operation[@kind = "deleted"]).
|feed/items/item/metadata/url||The node contains the URL of this advertisement. This address will be used in the pages of the results to lead the user to the display of the advertisement on the site of the publisher. Obligatory.|
|feed/items/item/metadata/date-publishing||Date of publication of the advertisement on the site of the publisher (for the specification of the date format see feed/info/build-date). Obligatory.|
|feed/items/item/metadata/date-expiration||Date of expiry of the advertisement. After this date the advertisement might be removed from our indices (for the specification for the date format see feed/info/build-date).|
|feed/items/item/metadata/location||This macro-node contains information relative to the location of the work place. Obligatory.|
|feed/items/item/metadata/location/address||Full address in the form "Street name and number, Zip code, City, State, USA".|
|feed/items/item/metadata/location/country-code||Nation code in ISO 3166 (Alpha 2) format. Obligatory.|
|feed/items/item/metadata/location/administrative-area||The Administrative Area relative to location.|
|feed/items/item/metadata/location/sub-administrative-area||The Sub-Administrative Area relative to location.|
|feed/items/item/metadata/location/locality||The city (locality) relative to location.|
|feed/items/item/metadata/location/thoroughfare||The thoroughfare relative to location.|
|feed/items/item/metadata/location/postal-code-number||Postal (Zip) Code |
|feed/items/item/metadata/location/longitude||The exact longitude relative to location (in the interval +180/-180 to referer 180° EAST/180° WEST)|
|feed/items/item/metadata/location/latitude||The exact latitude relative to location (in the interval +90/-90 to referer 90° NORD/90° SUD)|
|feed/items/item/metadata/contact||This macro-node contains information related to contacts of the job offer.|
|feed/items/item/metadata/contact/advertiser||The advertiser that offers work.|
|feed/items/item/metadata/contact/email||Email address of feed/items/item/metadata/contact/advertiser.|
|feed/items/item/metadata/contact/phone-number||Telephone number of feed/items/item/metadata/contact/advertiser. This node may be repeated more than once to indicate more telephone numbers.|
|feed/items/item/position||The advertised position. Examples: "Electronic engineer", "Secretary", "Developer", ... Obligatory.|
|feed/items/item/company||The name of the company offering the position (it can be the same of feed/items/item/metadata/contact/advertiser if the advertiser is not a recruitment agency).|
|feed/items/item/description||Detailed and complete text of the job offer description. May not contain HTML tags and must be obviously coded in UTF-8. This text must not be truncated or shortened.|
|feed/items/item/salary[@currency]||The salary for the employee (gross, annual). In the attribute @currency the currency must be specified in ISO 4217 format. Example: "USD".|
|feed/items/item/education||The education required to perform the task. Example: "Master's degree in Electronic Engineering", "Bachelor's degree in Chemistry", ...|
|feed/items/item/jobtype||The type of job for this list:|
- fulltime : a full time job;
- parttime : a part time job, requiring less daily hours than a full day's work.
|feed/items/item/skills||Know-how required for this job offer, age limitations. Example: "Experience of 10 years in the field, maximum 40 years old..."|
Use this form to inform the staff of CityList Jobs about an XML feed of job ads.