MarkUDown

RSS Feed API — MarkUDown RSS feed generator API docs

POST/api/rss

RSS Feed

Get the feed items of any page as JSON. If the site publishes an RSS or Atom feed, MarkUDown finds it (in the page or at common paths such as /feed) and parses it; if not, it builds the items from the article links on the page.

ParameterTypeRequiredDefaultDescription
urlstringrequired—Page or feed URL.
max_itemsintegeroptional20Maximum items when the feed is built from the page. A site's own feed returns all of its items.
titlestringoptionalnullFeed title. A site's own feed keeps its own title; this is used only when it has none.
timeoutintegeroptional60Timeout in seconds for each request.
callback_urlstringoptionalnullWebhook URL to POST the result to when the job completes.

Request

curl -X POST https://api.scrapetechnology.com/api/rss \
  -H "X-API-KEY: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/blog", "max_items": 20}'

Response

// POST returns { "success": true, "id": "abc123", "url": "/api/rss/abc123" }
// Poll GET /api/rss/{id}
{
  "success": true,
  "id": "abc123",
  "status": "completed",
  "data": {
    "success": true,
    "data": {
      "url": "https://example.com/blog",
      "feed_url": "https://example.com/feed.xml",
      "feed_title": "Example Blog",
      "items": [
        {
          "title": "First post",
          "link": "https://example.com/blog/first-post",
          "description": "Post summary...",
          "pubDate": "Mon, 16 Nov 2026 10:00:00 GMT"
        }
      ],
      "items_count": 1,
      "source": "native_feed"
    },
    "processing_time_ms": 1840
  }
}

Python — pip install markudown

from markudown import MarkUDown

md = MarkUDown(api_key="your-api-key")
job = md.rss("https://example.com/blog", max_items=20)  # waits for the job
feed = job["data"]["data"]
for item in feed["items"]:
    print(item["title"], item["link"])

Node.js — npm install markudown-sdk

import { MarkUDown } from "markudown-sdk";

const md = new MarkUDown({ apiKey: "your-api-key" });
const job = await md.rss("https://example.com/blog", { maxItems: 20 }); // waits for the job
const feed = job.data.data;
for (const item of feed.items) console.log(item.title, item.link);
source is "native_feed" when a real feed was found and "generated" when the items were built from the page (there is no feed_url then). Items come back as JSON, not as RSS XML.

Cost: 1 credit per request.