📚 API Documentation

Complete guide to integrating Site 2 RSS Factory into your applications

🚀 Getting Started

The Site 2 RSS Factory API allows you to programmatically generate RSS feeds from any website. All API requests require authentication using your API key.

Base URL: https://site2rssfactory.com/api

🔑 Authentication

All API requests must include your API key in the X-API-Key header:

X-API-Key: rss2ff_your_api_key_here

You can find your API key in your dashboard after logging in.

Endpoints

GET /api/feeds/generate

Generate RSS Feed

Converts any website into an RSS feed. Supports custom CSS selectors for precise content extraction.

Query Parameters

Parameter	Type	Required	Description
url	string	Yes	The URL of the website to convert to RSS
format	string	No	Output format: `rss` or `atom` (default: rss)
maxItems	integer	No	Maximum number of items to include (default: 20, max depends on your plan)
itemSelector	string	No	CSS selector for feed items (Professional+ plans)
titleSelector	string	No	CSS selector for item titles (Professional+ plans)
linkSelector	string	No	CSS selector for item links (Professional+ plans)
summarySelector	string	No	CSS selector for item summaries (Professional+ plans)

Example Request

curl -X GET "https://site2rssfactory.com/api/feeds/generate?url=https://example.com&format=rss&maxItems=10" \
  -H "X-API-Key: rss2ff_your_api_key_here"

Response

Returns an RSS or Atom feed in XML format

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0">
  <channel>
    <title>Example Site</title>
    <link>https://example.com</link>
    <description>RSS Feed generated by Site 2 RSS Factory</description>
    <item>
      <title>Article Title</title>
      <link>https://example.com/article</link>
      <description>Article summary...</description>
      <pubDate>Mon, 29 Dec 2025 12:00:00 GMT</pubDate>
    </item>
  </channel>
</rss>

POST /api/feeds/generate

Create Feed (POST)

Alternative method to generate feeds using JSON request body.

Request Body

{
  "url": "https://example.com",
  "format": "rss",
  "maxItems": 10,
  "itemSelector": ".article",
  "titleSelector": "h2",
  "linkSelector": "a.read-more",
  "summarySelector": ".excerpt"
}

Example Request

curl -X POST "https://site2rssfactory.com/api/feeds/generate" \
  -H "X-API-Key: rss2ff_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "format": "rss",
    "maxItems": 10
  }'

GET /api/savedfeeds

List Saved Feeds

Retrieve all your saved feed configurations.

Example Request

curl -X GET "https://site2rssfactory.com/api/savedfeeds" \
  -H "X-API-Key: rss2ff_your_api_key_here"

Response

[
  {
    "id": 1,
    "name": "Tech Blog Feed",
    "sourceUrl": "https://example.com",
    "maxItems": 20,
    "isActive": true,
    "accessCount": 42,
    "createdAt": "2026-01-01T10:00:00Z"
  }
]

GET /api/mashedfeeds

List Mashed Feeds

Retrieve all your mashed feeds (combined RSS feeds from multiple sources).

Example Request

curl -X GET "https://site2rssfactory.com/api/mashedfeeds" \
  -H "X-API-Key: rss2ff_your_api_key_here"

POST /api/mashedfeeds

Create Mashed Feed

Combine 2-10 RSS feeds into a single unified feed.

Request Body

{
  "name": "Tech News Mashup",
  "description": "Combined tech news from multiple sources",
  "feedUrls": "https://feed1.com/rss,https://feed2.com/rss",
  "maxItems": 50,
  "sortBy": "date",
  "customSlug": "tech-mashup"
}

Rate Limits

Rate limits depend on your subscription plan:

Plan	Update Interval	Max Feeds	Max Items/Feed
Starter	6 hours	10	25
Basic	1 hour	50	50
Professional	15 minutes	200	100
Enterprise	5 minutes	500	250

Error Codes

Code	Description
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid or missing API key
403	Forbidden - Feature not available in your plan
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error

Support

Need help? Contact our support team at support@therankingstore.com

Check your dashboard to view your API usage and current plan limits.