Feedparser Library

6.0.12 · active · verified Sun Apr 05

Feedparser is a Python library for downloading and parsing syndicated feeds, including RSS (0.9x, 1.0, 2.0), Atom (0.3, 1.0), CDF, and JSON feeds. It aims to normalize various feed types and versions into a consistent Python dictionary structure, simplifying feed processing. The current stable version is 6.0.12, and the project maintains an active release cadence with regular updates and fixes.

Warnings

breaking The `sanitize_html` and `resolve_relative_uris` flags, which were global module attributes in `feedparser` 5.x, must now be passed directly as arguments to the `feedparser.parse()` function in version 6.x.
Fix: Update calls from `feedparser.SANITIZE_HTML = True; feedparser.parse(...)` to `feedparser.parse(..., sanitize_html=True)`.
gotcha Older versions of `feedparser` 6.x (prior to 6.0.12) could crash with an `AssertionError` on Python 3.10+ when encountering malformed CDATA sections in feeds.
Fix: Upgrade to `feedparser` version 6.0.12 or higher to resolve the `AssertionError` crash with Python 3.10+.
deprecated `feedparser` 6.0.10 and earlier versions relied on Python's deprecated `cgi` module, which is slated for removal in Python 3.13. This could lead to `DeprecationWarning` messages on newer Python interpreters.
Fix: Upgrade to `feedparser` version 6.0.11 or higher to avoid deprecation warnings related to the `cgi` module.
gotcha The internal HTTP fetching mechanism of `feedparser` (which uses `urllib` by default) does not include a built-in timeout, potentially causing applications to hang indefinitely when a feed server is unresponsive.
Fix: Implement a custom timeout mechanism by monkey-patching `feedparser.api._open_resource` to use an HTTP client library like `requests` with explicit timeout parameters. Example: `feedparser.api._open_resource = lambda *args, **kwargs: requests.get(args[0], headers=headers, timeout=5).content`.
breaking `feedparser` version 6.x officially dropped support for Python 2. Early 6.0.x releases had issues where `pip` might incorrectly install them on Python 2 due to incorrect wheel metadata.
Fix: Ensure you are running Python 3.6 or later when using `feedparser` 6.x. If targeting Python 2, use `feedparser` 5.x.

Install

pip install feedparser Install latest version

Imports

feedparser
```
import feedparser
```

Quickstart

Parses a given feed URL and prints the feed title, the title of the first entry, and its link. It handles both RSS and Atom feeds, normalizing their structures.

import feedparser
import os

# Replace with a real RSS/Atom feed URL
feed_url = os.environ.get('FEED_URL', 'http://feedparser.org/docs/examples/atom10.xml')

d = feedparser.parse(feed_url)

print(f"Feed Title: {d.feed.title}")
if d.entries:
    first_entry = d.entries[0]
    print(f"First Entry Title: {first_entry.title}")
    print(f"First Entry Link: {first_entry.link}")
    if hasattr(first_entry, 'published_parsed'):
        print(f"First Entry Published: {first_entry.published_parsed}")

view raw JSON →