MarkUDown

API de Feed RSS — documentação do gerador de feed RSS MarkUDown

POST/api/rss

Feed 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âmetroTipoObrigatórioPadrãoDescrição
urlstringobrigatório—URL da página ou do feed.
max_itemsintegeropcional20Máximo de itens quando o feed é montado a partir da página. O feed próprio de um site devolve todos os seus itens.
titlestringopcionalnullTí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.
timeoutintegeropcional60Tempo limite de cada requisição, em segundos.
callback_urlstringopcionalnullURL 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.