Feeds RSS

Permissão: posts.read. Veja Papéis e permissões.

Listar e ler feeds e seus itens precisa de posts.read. Criar, pré-visualizar, atualizar, pausar, retomar, verificar e excluir precisam de posts.draft, mais a permissão que o modo de publicação do feed exige: posts.schedule para SCHEDULE, posts.publish para PUBLISH e ai.generate para legendas de IA. Um feed que outro membro configurou também precisa de posts.others para atualizar, pausar, retomar, verificar ou excluir.

Um feed é verificado em um cronograma, e cada item que aparece depois que você o adicionou vira uma publicação nas contas de targets. Cada publicação passa pelas mesmas verificações de Criar publicação. Um feed publica como o membro que o salvou por último: criar, atualizar ou retomar um feed torna o membro da chave o dono dele.

POST /api/v1/rss-feeds

Lê o feed e registra cada item que já está nele, para que só os itens que aparecerem depois sejam publicados. Um espaço de trabalho comporta até 20 feeds.

Os destinos podem ser FACEBOOK, INSTAGRAM, THREADS, TWITTER, BLUESKY, LINKEDIN, MASTODON, TELEGRAM e GOOGLE_BUSINESS.

Requisição de exemplo:

{
  "url": "https://blog.example.com/feed.xml",
  "targets": [
    { "platform": "LINKEDIN", "connectionId": "conn_li_001" },
    { "platform": "FACEBOOK", "connectionId": "conn_fb_001", "pageId": "123456789012345" }
  ],
  "postMode": "SCHEDULE",
  "publishDelayMinutes": 30,
  "contentMode": "TEMPLATE",
  "template": "Novo no blog: {title}\n\n{link}",
  "excludeKeywords": ["sponsored"]
}

Retorna 201 com o feed:

{
  "id": "rss_01j9x",
  "userId": "user_123",
  "accountGroupId": "ag_01j9x",
  "name": "Example Blog",
  "url": "https://blog.example.com/feed.xml",
  "siteUrl": "https://blog.example.com",
  "status": "ACTIVE",
  "postMode": "SCHEDULE",
  "publishDelayMinutes": 30,
  "contentMode": "TEMPLATE",
  "template": "Novo no blog: {title}\n\n{link}",
  "includeImage": true,
  "twitterKeepLinks": false,
  "includeKeywords": [],
  "excludeKeywords": ["sponsored"],
  "maxPostsPerCheck": 3,
  "checkIntervalMinutes": 60,
  "targets": [
    { "platform": "LINKEDIN", "connectionId": "conn_li_001", "displayName": "Example Inc." },
    { "platform": "FACEBOOK", "connectionId": "conn_fb_001", "pageId": "123456789012345", "displayName": "Example" }
  ],
  "nextCheckAt": "2026-11-08T15:00:00.000Z",
  "createdAt": "2026-11-08T14:00:00.000Z",
  "updatedAt": "2026-11-08T14:00:00.000Z"
}

Uma URL que não é um feed RSS ou Atom, um feed já conectado, uma plataforma de destino não suportada, a falta de publishDelayMinutes ou o limite de 20 feeds retorna 400. Um feed que não pode ser alcançado retorna 503. Uma chave sem a permissão que o modo de publicação ou as legendas de IA exigem retorna 403.

Campos do feed

Os outros campos trazem as configurações acima.

Corrija a causa e depois retome o feed.

POST /api/v1/rss-feeds/preview

Recebe url e um template opcional, lê o feed sem salvar nada e retorna url, title, siteUrl e os 5 items mais recentes, cada um com title, link, summary, publishedAt, imageUrl e text, o item com o modelo aplicado.

GET /api/v1/rss-feeds/:id/items

Lista os itens que o feed já viu, os mais novos primeiro, sem os que já estavam no feed quando ele foi adicionado. limit aceita de 1 a 100 e o padrão é 20. Retorna { "items": [...] }, cada um com id, title, link, publishedAt, createdAt, status, postId e error.

Atualizar, pausar, retomar, verificar e excluir

PATCH aceita os mesmos campos da criação, exceto url e postLatestItem, e muda só os que você envia. Pausar, retomar, verificar e excluir não têm corpo. Todos, menos excluir, retornam o feed; excluir retorna { "deleted": true }. Um id que não existe ou que pertence a outro espaço de trabalho retorna 404.