Listar as publicações de uma marca

Parâmetros

Caminho

Nome	Tipo	Obrigatório	Descrição
brandId	string	obrigatório	Brand UUID whose posts should be listed.

Query

Nome	Tipo	Obrigatório	Descrição	Padrão
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.	—

Respostas

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 as publicações de uma marca, das mais recentes para as mais antigas, com filtros por nome, plataforma, status, estado de aprovação e intervalo de agendamento. Cada linha contém dados suficientes para renderizar um calendário ou um feed sem uma segunda chamada por publicação.

Caso de uso: um calendário de conteúdo. Filtre com filters={"status":["SCHEDULED"],"startDate":"2026-10-01","endDate":"2026-10-31"} e posicione cada linha em seu publishedOn ou, para uma publicação que ainda não foi ao ar, no horário de agendamento que você enviou. Adicione a cada entrada uma ação de cancelamento vinculada a POST /social/posts/cancel e abra a visualização de detalhes com GET /social/posts/{postId}.

Caso de uso: uma varredura de falhas. Execute uma verificação todas as noites com filters={"status":["FAILED"]} em cada marca e emita alertas para as linhas retornadas. connectedChannels[].error informa qual plataforma recusou a publicação e por quê; um canal que informa uma autorização expirada precisa de um novo link de conexão, não de uma nova tentativa.

Observações.

socialPostId é o UUID simples aceito por get, insights e cancel.
Os filtros são enviados como uma única string codificada em JSON no parâmetro de consulta filters, não como parâmetros separados. Aplique a codificação de URL a essa string.
A paginação é baseada em deslocamento (page / size); pageInfo.total é o número total de publicações que correspondem aos filtros, não o tamanho desta página. totalPublishedPosts e totalEngagementPosts são contadores que abrangem toda a marca, úteis como cartões do painel.
A linha contém apenas o status no nível da publicação. Para consultar o instante de agendamento determinado e o resultado por canal, abra a publicação com GET /social/posts/{postId}.
startDate e endDate filtram pelo agendamento da publicação e são interpretados no fuso horário da marca, o mesmo fuso em que scheduleDate / scheduleTime são interpretados.
publishedOn permanece null até que a publicação vá ao ar em pelo menos um canal. Uma publicação que falhou em todos os canais mantém publishedOn: null e um status de FAILED.
approvalState, approver, actionOn e actionBy são preenchidos apenas para contas que usam um fluxo de aprovação de publicações; caso contrário, permanecem null.
Defina fetchPostContent=true apenas quando você estiver renderizando o corpo das publicações; o padrão mais leve é suficiente para um calendário.