Interserve Job Openings Data Feeds v2 (Jan 2012)

The URL is structured /feed-v2/[format]/name/[feed-name](/[parameter-name]/[parameter-value])*

[feed-name]

Feed Name	Description	Allowed Parameters
apinews	Notification of changes to this API, new features, service notices.	limit
country	List of known Countries used in Jobs
duration	List of known Job durations eg Short Term
job	Job Openings	region, duration, profession, country, keyword, status, limit
office	Contact information for our offices worldwide
profession	List of known Professions, used in Jobs, Stories, Prayer Requests
publication	Obsolete: will return empty list
region	List of known geographic regions (used to group Countries)
statistics	A few numbers
story	Stories of people in mission	region, profession, keyword, theme, limit
vision	Obsolete: will return empty list

[format]

Data for all [feed-name]s is available in all [format]s. Formats are:

/html: HTML in a standard format using html5 data-* attributes. Items are styled so you can format and alter position with CSS
/json: JSON: (Javascript Object Notation) for AJAX calls to load and dynamically format the data. Add a parameter /callback/[your-callback-name] to get a JSONP response
/rss: RSS 2.0: for feed readers or content management systems
/csv: download the data in csv format: titles in first row, one record per row
/xml: crude xml with no dtd

If you need an additional format, please contact the International Office.

Parameters

Parameters are specified in two parts of the url path: /[parameter-name]/[parameter-value].

Parameters are all optional, can appear in any order, may be a single value or comma separated list, must be URL encoded. Each [feed-name] defines its own set of allowed parameters.

/limit/5: 5 or fewer items will be returned. Items are sorted newest first. The default is 0, which returns all matching records
/country/India,Nepal,Pakistan: Returns only those jobs/stories/etc matching countries in the list. You can add as many countries as you like separated by commas (do not add whitespace around the commas) or for brevity you can use the Country ID. The default is to return items from all countries. Note that items in sensitive countries may use the region name (eg Arab World) instead of the real country name.
/region/Arab World: Like for Country
/profession/Engineer,Medical: Like for Country. Some professions have a / in them: encode the slash like this: .
/duration/Long Term: Like for Country
/status/salaried,priority: Include one or more comma separated status flags to display only jobs with that status.
/keyword/opthalmology: Return only jobs/stories/etc where the keyword is included in the name or description (case insensitive). Include one or more comma separated keywords to required the text to contain all matching terms (logical AND).

Examples

/feed-v2/html/name/country returns the list of all countries

/feed-v2/html/name/job/limit/5/country/Nepal/status/salaried returns the most recent 5 salaried jobs in Nepal (if any)

/feed-v2/html/name/job/keyword/teach,esl returns jobs with the words esl and teach in them (if any)

/feed-v2/html/name/story/limit/3/region/Arab+World returns the most recent 3 stories in the Arab World

Caching

This is intended to be a low volume feed. Where possible, we would prefer you to cache the data locally on your own server and only refresh from here at most once or twice a day. Job Openings tend to be the most popular item on a site, and if this server is required to handle several small requests for each page visit on every ISV site worldwide, we will need to spend too much on hosting and bandwidth. High bandwidth consumers will be blocked without notice.