Elenca i post di un brand

Parametri

Percorso

Nome	Tipo	Obbligatorio	Descrizione
brandId	string	obbligatorio	Brand UUID whose posts should be listed.

Query

Nome	Tipo	Obbligatorio	Descrizione	Predefinito
filters	string	facoltativo	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	facoltativo	1-based page number. Defaults to 1.	—
size	integer	facoltativo	Rows per page. Defaults to 20.	—
fetchPostContent	boolean	facoltativo	When `true`, each row carries its full `content` object. Leave it off for a lighter list.	—

Risposte

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`).

Elenca i post di un brand, dal più recente, con filtri per nome, piattaforma, stato, stato di approvazione e intervallo di pianificazione. Ogni riga contiene informazioni sufficienti per visualizzare un calendario o un feed senza una seconda chiamata per ogni post.

Caso d'uso: un calendario dei contenuti. Filtra con filters={"status":["SCHEDULED"],"startDate":"2026-10-01","endDate":"2026-10-31"} e posiziona ogni riga in corrispondenza del suo publishedOn oppure, per un post non ancora pubblicato, della data e dell'ora pianificate che hai inviato. Aggiungi a ogni voce un'azione di annullamento collegata a POST /social/posts/cancel e apri la vista di dettaglio con GET /social/posts/{postId}.

Caso d'uso: un controllo degli errori. Esegui ogni notte un controllo con filters={"status":["FAILED"]} per ciascun brand e genera avvisi per le righe restituite. connectedChannels[].error ti indica quale piattaforma ha rifiutato la pubblicazione e perché; un canale che segnala un'autorizzazione scaduta richiede un nuovo link di connessione, non un nuovo tentativo.

Note.

socialPostId è il semplice UUID accettato da get, insights e cancel.
I filtri vengono trasmessi come un'unica stringa codificata in JSON nel parametro di query filters, non come parametri separati. Applica alla stringa la codifica URL.
La paginazione è basata su offset (page / size); pageInfo.total è il numero totale di post corrispondenti ai filtri, non il numero di elementi di questa pagina. totalPublishedPosts e totalEngagementPosts sono contatori relativi all'intero brand, utili come riquadri della dashboard.
La riga contiene solo lo stato a livello di post. Per conoscere l'istante di pubblicazione pianificato risultante e l'esito per ciascun canale, apri il post con GET /social/posts/{postId}.
startDate e endDate filtrano in base alla pianificazione del post e vengono interpretati nel fuso orario del brand, lo stesso in cui vengono interpretati scheduleDate / scheduleTime.
publishedOn è null finché il post non viene pubblicato su almeno un canale. Un post per cui la pubblicazione non è riuscita su nessun canale mantiene publishedOn: null e un valore di status pari a FAILED.
approvalState, approver, actionOn e actionBy vengono valorizzati solo per gli account che utilizzano un flusso di approvazione dei post; altrimenti rimangono null.
Imposta fetchPostContent=true solo quando visualizzi il corpo dei post; l'impostazione predefinita più leggera è sufficiente per un calendario.