# Universal Feed Parser

Parse RSS and Atom feeds in Python. 3000 unit tests. Open source.

- Download ·
- Documentation ·
- Unit tests ·
- Report a bug

## Atom 1.0

###

This is a sample Atom 1.0 feed, annotated with links that show how each value can be accessed once the feed is parsed.

Even though many of these elements are required according to the specification, real-world feeds may be missing any element. If an element is not present in the feed, it will not be present in the parsed results. You should not rely on any particular element being present.

### Example: Annotated Atom 1.0 feed

    <?xml version="1.0" encoding="utf-8"?>
    <feed xmlns="http://www.w3.org/2005/Atom"
          xml:base="http://example.org/"
          xml:lang="en">
      <title type="text">
        Sample Feed
      </title>
      <subtitle type="html">
        For documentation <em>only</em>
      </subtitle>
      <link rel="alternate"
            type="html"
            href="/"/>
      <link rel="self"
            type="application/atom+xml"
            href="http://www.example.org/atom10.xml"/>
      <rights type="html">
            <p>Copyright 2005, Mark Pilgrim</p><
      </rights>
      <generator uri="http://example.org/generator/"
                 version="4.0">
        Sample Toolkit
      </generator>
      <id>tag:feedparser.org,2005-11-09:/docs/examples/atom10.xml</id>
      <updated>2005-11-09T11:56:34Z</updated>
      <entry>
        <title>First entry title</title>
        <link rel="alternate"
              href="/entry/3"/>
        <link rel="related"
              type="text/html"
              href="http://search.example.com/"/>
        <link rel="via"
              type="text/html"
              href="http://toby.example.com/examples/atom10"/>
        <link rel="enclosure"
              type="video/mpeg4"
              href="http://www.example.com/movie.mp4"
              length="42301"/>
        <id>tag:feedparser.org,2005-11-09:/docs/examples/atom10.xml:3</id>
        <published>2005-11-09T00:23:47Z</published>
        <updated>2005-11-09T11:56:34Z</updated>
        <author>
          <name>Mark Pilgrim</name>
          <uri>http://diveintomark.org/</uri>
          <email>mark@example.org</email>
        </author>
        <contributor>
          <name>Joe</name>
          <url>http://example.org/joe/</url>
          <email>joe@example.org</email>
        </contributor>
        <contributor>
          <name>Sam</name>
          <url>http://example.org/sam/</url>
          <email>sam@example.org</email>
        </contributor>
        <summary type="text">
          Watch out for nasty tricks
        </summary>
        <content type="xhtml"
                  xml:base="http://example.org/entry/3"
                  xml:lang="en-US">
          <div xmlns="http://www.w3.org/1999/xhtml">Watch out for
          <span style="background-image: url(javascript:window.location='http://example.org/')">
          nasty tricks</span></div>
        </content>
      </entry>
    </feed>

← Annotated Examples
Atom 0.3 →