API Method /venues/rss
This function returns an RSS 2.0 (Specification) feed of events occuring at a specified venue.
Arguments
- authentication
- This method controls access via optional user authentication.
- id string
- The id of the venue to use as the feed source.
Example Request
Here's an example search URL:
http://api.evdb.com/rest/venues/rss?...&id=V0-001-000113112-0
Output Parameters
Output from this function is an XML-formed RSS 2.0 channel with the following constructs:
- title string
- Title of venue .
- link string
- Source of RSS feed. (http://eventful.com/)
- description string
- Required by RSS 2.0 format.
- language string
- Default "en-US".
- copyright string
- Required by RSS 2.0 format.
- category string
- Required by RSS 2.0 format.
- generator string
- Required by RSS 2.0 format.
- docs string
- Required by RSS 2.0 format.
- ttl string
- Required by RSS 2.0 format.
- item tag
- Each item entry has the following structure:
- title string
- The event title.
- description string
- The event description. In RSS, this includes the start time, end time, venue, venueid, tags, and description.
- category string
- Unused.
- pubDate string
- The timestampt of the most recent modification. (e.g. "Mon, 26 Sep 2005 08:33:28 -0700")
- guid string
- The unique ID for this event, it is the event's Eventful URL.
- link string
- URL of associated event on Eventful site.
- pubDate string
- Required by RSS 2.0 format.
- lastBuildDate string
- Required by RSS 2.0 format.
Example RSS 2.0 Response
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
<channel>
<title>University of California, San Diego (UCSD)</title>
<link>http://eventful.com</link>
<description>...</description>
<language>en-US</language>
<copyright>...</copyright>
<category>Events</category>
<generator>EVDB RSS Generator v1.2</generator>
<docs>http://blogs.law.harvard.edu/tech/rss</docs>
<ttl>60</ttl>
<item>
<title>Global Gourmet Thanksgiving Cooking Class @UCSD</title>
<link>http://eventful.com/events/E0-001-000437779-6</link>
<description>...</description>
<category></category>
<pubDate>Sat, 29 Oct 2005 16:45:05 -0700</pubDate>
<guid isPermaLink="true">http://eventful.com/events/E0-001-000437779-6</guid>
</item>
...
<pubDate>Sat, 29 Oct 2005 16:45:05 -0700</pubDate>
<lastBuildDate>Sat, 29 Oct 2005 16:45:05 -0700</lastBuildDate>
</channel>
</rss>
Error Codes
This method may return these errors in an error document:
- Authentication error
- The specified user was not found or provided invalid credentials.
- Missing parameter
- A mandatory parameter was not set.
- Not found
- There is no venue with that identifier.
-
-