MarkUDown
RSS Feed API — MarkUDown RSS feed generator API docs
POST
/api/rssRSS 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.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| url | string | required | — | Page or feed URL. |
| max_items | integer | optional | 20 | Maximum items when the feed is built from the page. A site's own feed returns all of its items. |
| title | string | optional | null | Feed title. A site's own feed keeps its own title; this is used only when it has none. |
| timeout | integer | optional | 60 | Timeout in seconds for each request. |
| callback_url | string | optional | null | Webhook 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.