获取一条社交帖子

名称	类型	必填	描述
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，而不是将整条帖子归为单一的失败状态。

解读状态字段

状态分为两个层级，分别回答不同的问题。

字段	值	含义
`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。

获取一条社交帖子

参数

路径

响应

解读状态字段