Feeds RSS

Permiso: posts.read. Consulta Roles y permisos.

Listar y leer feeds y sus elementos necesita posts.read. Crear, previsualizar, actualizar, pausar, reanudar, comprobar y eliminar necesitan posts.draft, más el permiso que pide el modo de publicación del feed: posts.schedule para SCHEDULE, posts.publish para PUBLISH y ai.generate para los textos de IA. Un feed que configuró otro miembro también necesita posts.others para actualizarlo, pausarlo, reanudarlo, comprobarlo o eliminarlo.

Un feed se comprueba según un horario, y cada elemento que aparece después de añadirlo se convierte en una publicación en las cuentas de targets. Cada publicación pasa por las mismas comprobaciones que Crear publicación. Un feed publica como el miembro que lo guardó por última vez: crear, actualizar o reanudar un feed convierte al miembro de la clave en su propietario.

POST /api/v1/rss-feeds

Lee el feed y registra cada elemento que ya contiene, para que solo se publiquen los elementos que aparezcan después. Un espacio de trabajo admite hasta 20 feeds.

Los destinos pueden ser FACEBOOK, INSTAGRAM, THREADS, TWITTER, BLUESKY, LINKEDIN, MASTODON, TELEGRAM y GOOGLE_BUSINESS.

Solicitud de ejemplo:

{
  "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": "Nuevo en el blog: {title}\n\n{link}",
  "excludeKeywords": ["sponsored"]
}

Devuelve 201 con el 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": "Nuevo en el 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"
}

Una URL que no es un feed RSS o Atom, un feed ya conectado, una plataforma de destino no admitida, la falta de publishDelayMinutes o el límite de 20 feeds devuelve 400. Un feed al que no se puede llegar devuelve 503. Una clave sin el permiso que piden el modo de publicación o los textos de IA devuelve 403.

Campos del feed

Los demás campos llevan los ajustes de arriba.

Corrige la causa y luego reanuda el feed.

POST /api/v1/rss-feeds/preview

Recibe url y un template opcional, lee el feed sin guardar nada y devuelve url, title, siteUrl y sus 5 items más recientes, cada uno con title, link, summary, publishedAt, imageUrl y text, el elemento con la plantilla aplicada.

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

Lista los elementos que ha visto el feed, los más nuevos primero, sin los que ya estaban en el feed cuando se añadió. limit admite de 1 a 100 y por defecto es 20. Devuelve { "items": [...] }, cada uno con id, title, link, publishedAt, createdAt, status, postId y error.

Actualizar, pausar, reanudar, comprobar y eliminar

PATCH acepta los mismos campos que la creación, salvo url y postLatestItem, y solo cambia los que envías. Pausar, reanudar, comprobar y eliminar no llevan cuerpo. Todos menos eliminar devuelven el feed; eliminar devuelve { "deleted": true }. Un id que no existe o que pertenece a otro espacio de trabajo devuelve 404.