MarkUDown
API de Feed RSS — documentação do gerador de feed RSS MarkUDown
POST
/api/rssFeed RSS
Obtenha os itens de feed de qualquer página em JSON. Se o site publica um feed RSS ou Atom, o MarkUDown o encontra (na página ou em caminhos comuns como /feed) e o lê; se não, monta os itens a partir dos links de artigos da página.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| url | string | obrigatório | — | URL da página ou do feed. |
| max_items | integer | opcional | 20 | Máximo de itens quando o feed é montado a partir da página. O feed próprio de um site devolve todos os seus itens. |
| title | string | opcional | null | Título do feed. O feed próprio de um site mantém o título dele; este só é usado quando ele não tem um. |
| timeout | integer | opcional | 60 | Tempo limite de cada requisição, em segundos. |
| callback_url | string | opcional | null | URL de webhook que recebe o resultado (POST) quando o job termina. |
Requisição
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}'Resposta
// 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 é "native_feed" quando um feed de verdade foi encontrado e "generated" quando os itens foram montados a partir da página (aí não há feed_url). Os itens voltam em JSON, não em XML RSS.
Custo: 1 crédito por requisição.