取得一則社群貼文

名稱	類型	必填	說明
postId	string	必填	Post UUID, the `socialPostId` returned by POST /social/posts or the `socialPostId` of a row from the brand's post list.

名稱

類型

必填

說明

postId

string

必填

Post UUID, the `socialPostId` returned by POST /social/posts or the `socialPostId` of a row from the brand's post list.

回應

200The post, with per-channel publish state in `connectedChannels`.

Response

{  "data": {    "getSocialMediaPost": {      "name": "Autumn collection launch",      "status": "PUBLISHED",      "initialContent": "Our autumn collection lands today. Solid oak, hand-finished, made two blocks from the shop. Come see it in person this weekend.",      "initialMedia": ["https://cdn.example.com/social/autumn-collection.jpg"],      "initialVideo": [],      "globalPostSchedule": "2026-10-02T13:30:00Z",      "customDataFlag": false,      "approvalState": null,      "actionOn": null,      "comment": null,      "postAutomationId": null,      "connectedChannels": [        {          "id": "b81d5b3c-4a90-4f6a-9c11-71e0dd2fa4a7",          "platform": "INSTAGRAM",          "socialPlatformId": 2,          "displayName": "Jenny Home",          "userName": "jennyhome",          "userImage": "https://cdn.listingsapi.com/social/channels/b81d5b3c/avatar.jpg",          "status": "SUCCESS",          "liveLink": "https://www.instagram.com/p/CxYz1234abc/",          "reason": null,          "error": null,          "archived": false        },        {          "id": "2d4e6f80-1c33-4b7a-8e05-9a1b2c3d4e5f",          "platform": "FACEBOOK",          "socialPlatformId": 1,          "displayName": "Jenny Home & Co.",          "userName": "jennyhomeco",          "userImage": "https://cdn.listingsapi.com/social/channels/2d4e6f80/avatar.jpg",          "status": "SUCCESS",          "liveLink": "https://www.facebook.com/jennyhomeco/posts/1029384756",          "reason": null,          "error": null,          "archived": false        },        {          "id": "7c5b9a12-8de4-4a31-b0f2-6e3d4c5b8a90",          "platform": "LINKEDIN",          "socialPlatformId": 4,          "displayName": "Jenny Home",          "userName": "jenny-home",          "userImage": null,          "status": "ERROR",          "liveLink": null,          "reason": "Authorization expired",          "error": "The LinkedIn authorization for this channel is no longer valid. Reconnect the channel and post again.",          "archived": false        }      ]    }  }}

401Unauthenticated, missing or invalid API key.

404No post with that ID on this account.

透過 UUID 擷取一則貼文，包含撰寫的內容、解析後的排程，以及每個目標管道各一筆的項目，說明該平台上實際發生的情況。這是您在建立貼文後輪詢的端點。

使用案例：發布後驗證。發布採非同步方式進行，因此 POST /social/posts 只表示貼文已被接受。請使用傳回的 socialPostId 輪詢此端點，並讀取 connectedChannels[]：status: "SUCCESS" 且具有 liveLink 表示該管道的貼文已上線；status: "ERROR" 且已設定 error 則表示尚未上線，並說明原因。當所有管道都不再處於 SCHEDULED 時，即可停止輪詢。

使用案例：向客戶顯示貼文發布到哪些平台。將每個 connectedChannels[].liveLink 顯示為外部連結，讓使用者能直接在平台上開啟已發布的貼文，並在發布失敗的管道旁顯示 error，而非將整則貼文簡化為單一的失敗狀態。

解讀狀態欄位

狀態分為 2 個層級，分別回答不同的問題。

欄位	值	意義
`status`	`DRAFT`, `PENDING`, `SCHEDULED`, `PUBLISHED`, `FAILED`, `ARCHIVED`, `REJECTED`	貼文的整體狀態。
`connectedChannels[].status`	`SCHEDULED`, `SUCCESS`, `ERROR`, `ARCHIVED`	該平台上發生的情況。

一則貼文的整體狀態可能顯示為 PUBLISHED，但其中一個管道仍處於 ERROR。請一律根據 connectedChannels[] 顯示狀態；貼文層級的 status 只是摘要。

注意事項。

globalPostSchedule 是解析後以 UTC 表示的發布時間點。如果您使用 scheduleDate + scheduleTime 設定排程，這就是依品牌時區解析後的結果，可用來確認所用的時區是否符合您的預期。
error 是易於閱讀且可安全顯示給客戶的訊息；reason 則是其背後較短的內部標籤。兩者都不包含平台權杖或追蹤 ID。
connectedChannels[].id 是來自品牌連線的連線 UUID，也是洞察資料所需的 socialConnectedChannelId 值。
顯示為 archived: true 的管道，表示其連線在貼文建立後已中斷。該管道將不會發布貼文；請參閱中斷連線。
授權失效後仍停留在 ERROR 的管道，需要新的連線連結，而不是重試發布貼文。
若要取得互動資料而非發布狀態，請呼叫 GET /social/posts/{postId}/insights。
若要列出品牌的貼文而非擷取單一貼文，請使用 GET /social/brands/{brandId}/posts。

取得一則社群貼文

參數

路徑

回應

解讀狀態欄位