Feeds
As well as being able to search for opportunities on this website, we provide feeds that you can use, either for yourself or to help others find these opportunities. Below are details on how you can access different services.
RSS Feeds
RSS feeds are really simple ways you can see headline information from this website without having to visit it. Most web browsers have RSS readers built into them, or you can subscribe to RSS feeds via a personalised Google or Yahoo! homepage etc. There are a wide variety of feeds you can subscribe to.
The easiest method of subscribing is picking from some of our pre-defined feeds:
- latest The latest opportunities added to the database.
- latest-modified The most recently modified opportunities
- latest-virtual The latest virtual opportunities added to the database
- latest-no-virtual The latest opportunities added to the database, excluding virtual opportunities.
- popular The most viewed opportunities
- popular-virtual The most viewed virtual opportunities
- clickthru The opportunities with the most click-throughs
- clickthru-virtual The virtual opportunities with the most click-throughs
- Scotland
- Wales
- Northern Ireland
- North-East England
- North-West England
- Yorkshire and the Humber
- East Midlands
- West Midlands
- East of England
- London
- South-East England
- South-West England
- Outside UK
- Male
- Female
Alternatively, all searches via our search page can be made into an RSS feed. Just create the appropriate filters and click on the link at the bottom of the results page.
For more technical information, and terms of use, see below.
XML Feeds
If you want to do more clever stuff with our feeds, you can use our XML feed, which provides a full text version of the opportunities. Currently the access method is similar to RSS or search pages. Simply use the above methods to get the RSS link and replace rss with xml in the URL (example latest XML feed).
You will get an XML feed using our schema.
- Opportunities
- Overarching container
- Opportunity
- Individual opportunity. Attribute ID is our unique shortcode for this opportunity.
- Title
- The title of the opportunity
- Summary
- The first paragraph (max 1000 characters) of the description
- Description
- Full information about the opportunity
- Organisation
- Name of the organisation who submitted the opportunity (this may not be the opportunity running the opportunity. Opportunities listed as WNYP include those submitted without registration). Attribute ID is our unique reference of this organisation.
- Age
- Age range for this opportunity
- Minage
- Minimum age for this opportunity
- Maxage
- Maximum age for this opportunity
- Location
- Location(s) that this opportunity covers
- Place
- One or more place that this location covers (currently only breaks down to regions. Attribute ID is our unique reference of this place.
- Sex
- Details of what sex(es) the opportunity is open to.
- Type
- Either male or female. Attribute ID is our unique reference of this sex type. (If this seems a bit odd way of doing it, it is for future development of classifications such as race, religion, sexuality etc)
- Virtual
- Returns 1 if opportunity is virtual, or empty if not.
- Dates
- Various dates associated with the opportunity. All dates are listed as Y-m-d H:i:s; although some only contain date information (and therefore will return 0:0:0 for the time).
- Dateadded
- The time and date the opportunity was first added to the database.
- Datemodified
- The time and date the opportunity was last modified in the database.
- Validuntil
- The date the opportunity will is valid until (eg closing date)
- Links
- Various weblinks associated with the opportunity
- WNYP_GO
- Full URL of relevant WNYP go to link page. This page is the prefered link from the opportunity information. It will count the clickthru and also determine whether it is a website or an email address and provide the appropriate page.
- WNYP_OPP
- Full URL of relevant WNYP opportunity page.
- External
- Full URL of associated webpage. Attribute isEmail will be 1 if link is email, 0 if not. If it is email, external will be email address.
If you need to return a single opportunity, the easiest way to do this is use the shortcode id attribute (the numeric part of the opportunity URL). You can do this by creating a URL www.wnyp.org/XML/xxxx where xxxx is the shortcode URL. This will return the above, but with a single entry. Please note there is no query string on this URL, and it will not work for RSS feeds.
Some other notes: currently both the RSS and XML will return a maximum of 30 results. If you wish to change this, you can add limitfrom and limitto values to your query string. A querystring limitfrom=6&limitto=10 will return ten results from the sixth entry.
If there are no results, there is no elegant way of returning this; there will just be no opportunities contained within the over-arching container.
There are some terms and conditions for using the feeds