Deprecation notice

XML and JSON feeds will be deprecated at the end of December 2018.
Please use the Communico API or RSS for generating event feeds after this date.

Communico API RSS event feeds

xml and json feeds for Attend

Feeds can be used to generate and import Attend events data. The preferred method for importing events data is to use the communico API but options for xml and json are shown below if you need to use these formats.

You can create xml feeds based on this url format:

https://api.communico.co/v2/<yourkeyword>/events/export.xml

To generate a json feed replace .xml with .json

The feed urls will include your keyword which will then generate your own library's events. In the examples, <yourkeyword> would be replaced with your actual keyword. If you don't know your keyword, please contact support

By default, feeds will include events for the next 365 days starting from the current date, but you can specify start and end dates as shown in the examples below.

Available feeds

All events
Events limited by type (or types)
Events excluding a type (or types)
Events limited by age group (or age groups)
Events from a start date
Events up to an end date
Events with multiple dates summary list
Events with multiple dates full list
Combination feeds

All events

To generate a list of all events for the next 365 days starting from the current date.

https://api.communico.co/v2/<yourkeyword>/events/export.xml

Example result

<event>
<Ages>Adults</Ages>
<Title>Knitting Club</Title>
<SubTitle>Needlechat</SubTitle>
<DateString>Wednesday, Apr 5</DateString>
<Date>Apr 5</Date>
<Weekday>Wednesday</Weekday>
<StartTime>10:00 am</StartTime>
<EndTime>11:00 am</EndTime>
<Location>Plain Community Branch</Location>
<RoomName/>
<ShortDescription>
Join fellow knitters and crocheters to work on current projects at all skill levels while sharing tips and tricks.
</ShortDescription>
<LongDescription>
<![CDATA[
Do you love to knit or want to learn? Join other knitters & crocheters and have fun in a laid back atmosphere. Share tips and tricks, and work on community projects together. <h2> FAQs</h2> What do I need to bring? Bring your supplies if you have them. Yarn may be provided—ask your local branch for details. I am learning how to knit, so I am just a beginner. Can I still come? Yes, all ages and skill levels are welcome.
]]>
</LongDescription>
<AllowRegistration>no</AllowRegistration>
<status>3</status>
</event>
<event>
<Ages>Early Learners (Birth - Pre-K)</Ages>
<Title>Story Time & More</Title>
<SubTitle>Toddler</SubTitle>
<DateString>Wednesday, Apr 5</DateString>
<Date>Apr 5</Date>
<Weekday>Wednesday</Weekday>
<StartTime>10:00 am</StartTime>
<EndTime>10:30 am</EndTime>
<Location>Lake Community Branch</Location>
<RoomName>Meeting Room</RoomName>
<ShortDescription>
Introduce your child to the world of books while learning easy ways to build early literacy skills. Registration is required for all.
</ShortDescription>
<LongDescription>
<![CDATA[
<h2>FAQs </h2> Why is story time important? With an early introduction to skills such as holding a book or listening to stories, children have a better chance at succeeding in school, which translates into positive outcomes later in life. Our Start Smart initiative focuses on providing the information and tools that parents, caregivers, and educators need to facilitate early literacy development. Early Literacy is the knowledge a child develops about reading and writing before actually learning to read or write.  What is the role of a parent or caregiver during story time? A parent or caregiver must remain in the story time area. It is the perfect time to gain awareness of age-appropriate books, music, songs and activities suited for your child. How can a parent or caregiver make the most of story time? <ul> <li>By attending story time regularly.</li> <li>By arriving a few minutes early.</li> <li>By participating when encouraged to do so.</li> <li>By not bringing food or toys.</li> <li>By taking an upset child out of the area until he or she calms down.</li> <li>By talking with your child about the stories afterward.</li> <li>By repeating the story time rhymes and songs at home with your child.</li> </ul>
]]>
</LongDescription>
<AllowRegistration>yes</AllowRegistration>
<status>3</status>
</event>

...

Events limited by type

To generate a list of a events of a certain type for the next 365 days starting from the current date. Example shows 'Lego' as the event type, but you can use any of your event types.

https://api.communico.co/v2/<yourkeyword>/events/export.xml?types=Lego

Multiple event types can be added by separating event types with a comma.

https://api.communico.co/v2/<yourkeyword>/events/export.xml?types=Lego,Book%20Clubs

Events excluded by type

To generate a list of a events excluding a certain event type for the next 365 days starting from the current date. Example shows 'Book Clubs' as the event type being excluded.

https://api.communico.co/v2/<yourkeyword>/events/export.xml?excludetypes=Book%20Clubs

Multiple event types can be excluded by separating event types with a comma.

https://api.communico.co/v2/<yourkeyword>/events/export.xml?excludetypes=Book%20Clubs,Lego

Events limited by age group

To generate a list of a events for just a certain age group for the next 365 days starting from the current date. Example shows 'Adult' as the age group. (Any of your library's age groups can be used)

https://api.communico.co/v2/<yourkeyword>/events/export.xml?ages=Adult

Multiple Age groups can be included by separating age groups with a comma.

https://api.communico.co/v2/<yourkeyword>/events/export.xml?ages=Adult,Teen

Events from a start date

To generate a list of a events from a specific date.

https://api.communico.co/v2/<yourkeyword>/events/export.xml?start=2017-04-01

Events up to an end date

To generate a list of a events from the current date up to a specific date

https://api.communico.co/v2/<yourkeyword>/events/export.xml?end=2017-04-30

Events within a date range

To specify a start and end date for the events

https://api.communico.co/v2/<yourkeyword>/events/export.xml?start=2017-04-01&end=2017-04-30

Events with multiple dates summary list

To generate a list of recurring events and their dates. This will show just a string of dates for the event.

https://api.communico.co/v2/<yourkeyword>/events/export.xml?group_dates_into_string=true

Example result

<event>
<Ages>Adults</Ages>
<Title>Knitting Club</Title>
<SubTitle>Needlechat</SubTitle>
<DateString>Wednesday, Apr 5</DateString>
<Weekday>Wednesday</Weekday>
<StartTime>10:00 am</StartTime>
<EndTime>11:00 am</EndTime>
<Location>Plain Community Branch</Location>
<RoomName/>
<ShortDescription>
Join fellow knitters and crocheters to work on current projects at all skill levels while sharing tips and tricks.
</ShortDescription>
<LongDescription>
<![CDATA[
Do you love to knit or want to learn? Join other knitters & crocheters and have fun in a laid back atmosphere. Share tips and tricks, and work on community projects together. <h2> FAQs</h2> What do I need to bring? Bring your supplies if you have them. Yarn may be provided—ask your local branch for details. I am learning how to knit, so I am just a beginner. Can I still come? Yes, all ages and skill levels are welcome.
]]>
</LongDescription>
<AllowRegistration>no</AllowRegistration>
<status>3</status>
<Dates>
Apr 5, Apr 12, Apr 19, Apr 26, May 3, May 10, May 17, May 24, May 31
</Dates>
</event>

...

Events with multiple dates full list

To generate a list of recurring events and their dates. This will show full time, date and venue information for each event.

https://api.communico.co/v2/<yourkeyword>/events/export.xml?dates=true

Example result

<event>
<Ages>Adults</Ages>
<Title>Knitting Club</Title>
<SubTitle>Needlechat</SubTitle>
<Location>Plain Community Branch</Location>
<ShortDescription>
Join fellow knitters and crocheters to work on current projects at all skill levels while sharing tips and tricks.
</ShortDescription>
<LongDescription>
<![CDATA[
Do you love to knit or want to learn? Join other knitters & crocheters and have fun in a laid back atmosphere. Share tips and tricks, and work on community projects together. <h2> FAQs</h2> What do I need to bring? Bring your supplies if you have them. Yarn may be provided—ask your local branch for details. I am learning how to knit, so I am just a beginner. Can I still come? Yes, all ages and skill levels are welcome.
]]>
</LongDescription>
<AllowRegistration>no</AllowRegistration>
<status>3</status>
<Dates>
<Date>
<StartTime>10:00 am</StartTime>
<EndTime>11:00 am</EndTime>
<Date>Apr 5</Date>
<DateString>Wednesday, Apr 5</DateString>
<Weekday>Wednesday</Weekday>
<RoomName/>
</Date>
<Date>
<StartTime>10:00 am</StartTime>
<EndTime>11:00 am</EndTime>
<Date>Apr 12</Date>
<DateString>Wednesday, Apr 12</DateString>
<Weekday>Wednesday</Weekday>
<RoomName/>
</Date>
<Date>
<StartTime>10:00 am</StartTime>
<EndTime>11:00 am</EndTime>
<Date>Apr 19</Date>
<DateString>Wednesday, Apr 19</DateString>
<Weekday>Wednesday</Weekday>
<RoomName/>
</Date>

...

Combining feeds

You can combine feeds by adding '&'.

For example Event type 'Lego' until the end of December 2017 would be:

https://api.communico.co/v2/<yourkeyword>/events/export.xml?types=Lego&end=2017-04-01

URL encoding

Since URLs often contain characters outside the ASCII set, the URL has to be converted into a valid ASCII format.

URL encoding replaces unsafe ASCII characters with a "%" followed by two hexadecimal digits.

URLs cannot contain spaces. URL encoding normally replaces a space with a plus (+) sign or with %20.

For example, Story Time would be encoded as Story%20Time.

After creating your text string, use an online encoder to ensure it is valid.