RSS.app API Docs

Appearance

SOPs Overview ​

Fresh

This section contains step-by-step standard operating procedures for common tasks with the RSS.app API. Each SOP walks through a complete workflow from setup to verification, with code examples you can use directly.

What Are These SOPs For? ​

SOPs in this documentation are practical, task-oriented guides. They focus on outcomes rather than exhaustive parameter lists. If you want to accomplish a specific goal — create a feed, organize feeds into bundles, receive real-time notifications — the SOPs get you there directly.

The API Reference section covers every parameter and response field. The SOPs cover the "how do I actually do this" question.

Available SOPs ​

Authentication ​

Before any API call works, you need to understand how RSS.app authenticates requests. The authentication SOP covers where to find your credentials, how to format the Authorization header, and security practices for production deployments.

Authentication SOP

Creating Feeds ​

Feeds are the core resource in the RSS.app API. You can create a feed from four different source types:

  • Website URL — RSS.app scrapes the site and generates an RSS feed automatically
  • Native RSS URL — Track an existing RSS or Atom feed through the API
  • Keyword search — Aggregate news content matching specific search terms
  • News headlines — Pull full headline stories for a keyword or topic

Create Feed from URL | Create Feed from Keyword

Managing Bundles ​

Bundles let you group multiple feeds together under a single object. The bundle exposes its own rss_feed_url that combines all member feeds, making it easy to deliver multi-source aggregations to end users.

Manage Bundles SOP

Webhooks ​

Instead of polling the List Feeds endpoint for new items, configure webhooks to receive HTTP POST notifications whenever a feed update occurs. Webhooks reduce API call volume and enable real-time integrations.

Setup Webhooks SOP

Pagination ​

When you have more than 10 feeds or bundle items, you need to paginate through results. The pagination SOP explains the offset-based model RSS.app uses and how to iterate through full datasets.

Pagination SOP

Before You Start ​

  1. Create an account at rss.app and activate API access
  2. Copy your API Key and API Secret from the account settings
  3. Read the Authentication SOP to set up your request headers
  4. Install axios in your project: npm install axios

RSS.app API Documentation