Skip to main content

Client library for Miniflux API

Project description

Python client library for Miniflux API.


  • Miniflux >= 2.x
  • Python >= 3.6
  • requests


pip install miniflux

Running Tests

python test

Usage Example

import miniflux

# Creating a client using username / password authentication
client = miniflux.Client("", "my_username", "my_secret_password")

# Use an API Key (preferred method)
client = miniflux.Client("", api_key="My secret API token")

# Get all feeds
feeds = client.get_feeds()

# Refresh a feed

# Discover subscriptions from a website
subscriptions ="")

# Create a new feed, with a personalized user agent and with the crawler enabled
feed_id = client.create_feed("", 42, crawler=True, user_agent="GoogleBot")

# Fetch 10 starred entries
entries = client.get_entries(starred=True, limit=10)

# Fetch last 5 feed entries
feed_entries = client.get_feed_entries(123, direction='desc', order='published_at', limit=5)

# Fetch entries that belongs to a category with status unread and read
entries = client.get_entries(category_id=456, status=['read', 'unread'])

# Update a feed category
client.update_feed(123, category_id=456)

# OPML Export
opml = client.export_feeds()

# Get application version


Frédéric Guillot


This library is distributed under MIT License.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for miniflux, version 0.0.13
Filename, size File type Python version Upload date Hashes
Filename, size miniflux-0.0.13.tar.gz (4.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page