RSS feeds from folkjam.org

We provide several different ways to pull content from folkjam.org via RSS. You may use our RSS feeds to show local jams on your web site, display a list of upcoming jams as a bookmark in your browser or anywhere an RSS feed can be used. We do ask that you leave all attribution as is in the RSS feed.

Feed basics

Folkjam.org shows you content based on your location, and our RSS feeds are built on the same principle. We supply five different types of RSS inquiry: jams based on zip code proximity, jams based on latitude/longitude proximity, jams contributed by a particular user, a group of specific jams, and jams that you have placed on your personal jam calendar (NOTE: The personal calendar feed type is not likely to be in the early versions of folkjam.org).

Postal (zip) code proximity feeds

http://www.folkjam.org/feed/jam/postcode/CC/PPPPP
This feed brings back a list of jams and/or festivals within a radius of a postal code. The CC portion of the URL is the two letter country code, and the PPPPP portion is the post/zip code. For example, a list of jam sessions near New York City could be retrieved with the RSS feed http://www.folkjam.org/feed/jam/postcode/us/10005.

The postal code feed can be customized with the distance, sort, count and type parameters described below.

Geographic lat/lon proximity feeds

http://www.folkjam.org/feed/jam/geo/LAT/LON
This RSS feed returns a list of jams and/or festivals within a radius of the latitude and longitude you supply. The LAT portion of the URL is the latitude and the LON portion is the longitude. For example, a list of jam sessions near Kansas City could be retrieved with the RSS feed http://www.folkjam.org/feed/jam/geo/38.96/-94.74.

The geo feed can be customized with the distance, sort, count and type parameters described below.

Jams contributed by a specific user

http://www.folkjam.org/feed/jam/contributor/UUU
The contributor feed returns a list of all folkjam events submitted by a specific user. This is useful if you only want to show 'your' jams/festivals on web pages you maintain instead of all of the events near you. If you run a jam session in your area, post it to folkjam.org and use our RSS feed to keep the 'next session' date of your jam current without having to edit your HTML pages after every jam.

The UUU portion of the URL is a numeric folkjam user ID. This is the ID of the user who contributed the jams you want to see.

A group of specific jams

http://www.folkjam.org/feed/jam/node/NNNhttp://www.folkjam.org/feed/jam/node/NNN+NNN+NNN
The specific jam feed allows you to specify one or more jams to retrieve as an RSS feed. The jams are identified by the same number you see in the URL when viewing the jam session. If the jam you want to pull into an RSS feed is on URL http://www.folkjam.org/node/864, then you can pull an RSS feed of upcoming dates for that jam using http://www.folkjam.org/feed/jam/node/864. If you want to bring back multiple specific jams combined into a single RSS feed, then use the second form of the RSS feed URL where the jam session id numbers are separated by a plus sign(+). For example, http://www.folkjam.org/feed/jam/node/864+1961+1972+2078.

The 'distance' parameter is not valid for this feed type. 'sort', 'count' and 'type' are valid. This feed takes an additional parameter - 'title'. Use the title parameter to set the title that is presented on the RSS feed. For example, http://www.folkjam.org/feed/jam/node/1234+1235?title=My+two+favorite+jam+sessions.

Jams from your personal jam calendar

http://www.folkjam.org/feed/jam/personalcalendar/UUU
NOTE: This feature will not be part of the initial release of folkjam.org and is planned for early 2007.

Feed parameters

All of our RSS feeds can take additional parameters to fine tune the data you receive from folkjam.org. These parameters are appended to the URL you construct with a ? followed by the parameter name, an equals sign, the parameter value and optionally an & followed by another parameter name. Confused? See the examples.

distance=##

Constrain the distance of the events presented in the RSS feed. Defaults to 90 miles. ## must be a numeric value, in miles. The distance cannot exceed a 200 mile radius.

sort=[title|upcoming]

Determines the sort order for the events presented in the RSS feed. A value of 'title' will return a list of events in alphabetic order (up to the 'count' parameter). A value of 'upcoming' will return a list of events in chronological order. The main difference is that the 'title' feed will show one entry for every jam on the feed with the date of the next session, where the 'upcoming' list will show jams in the order they happen, and any given jam may be in the list multiple times.

count=##

Constrains the number of items that will be returned in the RSS feed. Defaults to 10. Has a maximum of 75.

type=[festival|jam|camp]

Event types to return in the RSS feed. This is a comma separated list of the event types that will be delivered in the RSS feed. If no type parameter is supplied it defaults to 'jam' and does not return information on festivals.