Listar las publicaciones de una marca

Parámetros

Ruta

Nombre	Tipo	Obligatorio	Descripción
brandId	string	obligatorio	Brand UUID whose posts should be listed.

Consulta

Nombre	Tipo	Obligatorio	Descripción	Predeterminado
filters	string	opcional	JSON-encoded filter object. Fields: `name` (substring match on the post's internal name), `platforms` (array of the platform enum), `status` (array of `DRAFT`, `PENDING`, `SCHEDULED`, `PUBLISHED`, `FAILED`, `ARCHIVED`, `REJECTED`), `startDate` and `endDate` (`YYYY-MM-DD`, filtering on the post's schedule in the brand's timezone), `socialConnectedChannelId` (one connection), `approvalState` (array of workflow states), `viewMode` (string) and `filterByUser` (boolean, defaults to false).	—
page	integer	opcional	1-based page number. Defaults to 1.	—
size	integer	opcional	Rows per page. Defaults to 20.	—
fetchPostContent	boolean	opcional	When `true`, each row carries its full `content` object. Leave it off for a lighter list.	—

Respuestas

200A page of posts plus `pageInfo` for paging.

Response

{  "data": {    "getSocialMediaPostByList": {      "socialPosts": [        {          "socialPostId": "c47a1e58-2b93-4f10-a6d7-58e0c9b12345",          "name": "Autumn collection launch",          "status": "PUBLISHED",          "platforms": ["INSTAGRAM", "FACEBOOK", "LINKEDIN"],          "socialPlatformIds": [2, 1, 4],          "socialProfileDetailsId": "6f2c9a41-7b0e-4d55-9a2f-3c8e1d47b902",          "createdAt": "2026-09-28T14:02:11Z",          "createdBy": 40122,          "author": "Dana Reyes",          "approver": null,          "approvalState": null,          "actionOn": null,          "actionBy": null,          "publishedOn": "2026-10-02T13:30:04Z",          "postAutomationId": null,          "content": {            "message": "Our autumn collection lands today. Solid oak, hand-finished, made two blocks from the shop.",            "images": ["https://cdn.example.com/social/autumn-collection.jpg"],            "video": [],            "liveLink": "https://www.instagram.com/p/CxYz1234abc/",            "boosted": false          },          "connectedChannels": [            {              "id": "b81d5b3c-4a90-4f6a-9c11-71e0dd2fa4a7",              "platform": "INSTAGRAM",              "displayName": "Jenny Home",              "status": "SUCCESS",              "liveLink": "https://www.instagram.com/p/CxYz1234abc/",              "error": null            }          ]        }      ],      "pageInfo": {        "total": 64,        "hasNextPage": true,        "totalEngagementPosts": 41,        "totalPublishedPosts": 47      }    }  }}

401Unauthenticated, missing or invalid API key.

404No brand with that ID on this account (`SY95043`).

Lista las publicaciones de una marca, de la más reciente a la más antigua, con filtros por nombre, plataforma, estado, estado de aprobación e intervalo de programación. Cada fila contiene información suficiente para mostrar un calendario o un feed sin una segunda llamada por publicación.

Caso de uso: un calendario de contenido. Filtra con filters={"status":["SCHEDULED"],"startDate":"2026-10-01","endDate":"2026-10-31"} y sitúa cada fila en su publishedOn o, si la publicación aún no se ha publicado, en la fecha y hora programadas que enviaste. Añade a cada entrada una acción de cancelación vinculada a POST /social/posts/cancel y abre la vista de detalle con GET /social/posts/{postId}.

Caso de uso: una comprobación de fallos. Ejecuta una comprobación nocturna con filters={"status":["FAILED"]} para cada marca y genera alertas sobre las filas devueltas. connectedChannels[].error te indica qué plataforma rechazó la publicación y por qué; un canal que informa de una autorización caducada necesita un nuevo enlace de conexión, no un reintento.

Notas.

socialPostId es el UUID sin formato adicional que aceptan get, insights y cancel.
Los filtros se envían como una única cadena codificada en JSON en el parámetro de consulta filters, no como parámetros separados. Aplícale codificación URL.
La paginación se basa en desplazamientos (page / size); pageInfo.total es el número total de publicaciones que coinciden con los filtros, no el tamaño de esta página. totalPublishedPosts y totalEngagementPosts son contadores que abarcan toda la marca, útiles como tarjetas del panel.
La fila solo contiene el estado a nivel de publicación. Para consultar el instante programado definitivo y el resultado por canal, abre la publicación con GET /social/posts/{postId}.
startDate y endDate filtran por la programación de la publicación y se interpretan en la zona horaria de la marca, la misma en la que se interpretan scheduleDate / scheduleTime.
publishedOn es null hasta que la publicación se publique en al menos un canal. Una publicación que haya fallado en todos sus canales conserva publishedOn: null y un status de FAILED.
approvalState, approver, actionOn y actionBy solo se rellenan para las cuentas que utilizan un flujo de aprobación de publicaciones; en caso contrario, permanecen en null.
Establece fetchPostContent=true solo cuando vayas a mostrar el cuerpo de las publicaciones; la opción predeterminada, más ligera, es suficiente para un calendario.