Feedsearch provides a simple API for searching websites for RSS and JSON feeds. It's the library that runs the feed search function at Auctorial.

Search for Feeds

API Usage

Make a GET request to https://feedsearch.auctorial.com/search with a "url" value in the querystring containing the URL you'd like to search:

curl https://feedsearch.auctorial.com/search?url=arstechnica.com

The API returns a JSON list of found feeds, with attached metadata about the feed.

[
  {
    "bozo": 0, 
    "content_type": "text/xml; charset=UTF-8", 
    "description": "Serving the Technologist for more than a decade. IT news, reviews, and analysis.", 
    "favicon": "https://cdn.arstechnica.net/favicon.ico", 
    "favicon_data_uri": "", 
    "hub": "http://pubsubhubbub.appspot.com/", 
    "is_push": true, 
    "score": 4, 
    "self_url": "http://feeds.arstechnica.com/arstechnica/index", 
    "site_name": "Ars Technica", 
    "site_url": "https://arstechnica.com/", 
    "title": "Ars Technica", 
    "url": "http://feeds.arstechnica.com/arstechnica/index/", 
    "version": "rss20"
  }
]

The API accepts the following query parameters:

  • url: The URL to search. Will return 400 Bad Request if not set.
  • info: Returns all feed metadata as above. Defaults True.
  • checkall: Checks all the links at the given URL for feeds, and attempts a few guesses. Defaults False.

Documentation

Feedsearch is written as an Python library, and is available as a Python package on PyPI.

Further documentation and source code can be found at the Feedsearch Github repository.