Listings APIListings API
サインイン
GET/api/v4/social/posts/{postId}

ソーシャル投稿の取得

1件のソーシャル投稿について、コンテンツ、スケジュール、およびチャネルごとの現在の公開ステータス、リンク、エラーを返します。

API キーが必要です。ヘッダーの形式とキーのローテーションについては認証を参照してください。

パラメーター

パス

名前型必須説明
postIdstring必須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を指定して1件の投稿を取得します。取得内容には、作成されたコンテンツ、確定したスケジュール、および対象チャネルごとにそのプラットフォームで実際に何が起きたかを示すエントリが1件ずつ含まれます。投稿を作成した後は、このエンドポイントをポーリングします。

ユースケース：公開後の検証。 公開は非同期で行われるため、POST /social/postsが示すのは投稿が受け付けられたことだけです。返されたsocialPostIdを使用してこのエンドポイントをポーリングし、connectedChannels[]を確認します。status: "SUCCESS"でliveLinkがある場合はそのチャネルで公開済みであることを意味し、status: "ERROR"でerrorが設定されている場合は未公開であることとその理由を示します。SCHEDULEDのままのチャネルがなくなったら、ポーリングを停止します。

ユースケース：投稿の公開先を顧客に表示する。 各connectedChannels[].liveLinkを外部リンクとして表示して、ユーザーがプラットフォーム上で公開済みの投稿を開けるようにし、投稿全体を単一の失敗状態にまとめる代わりに、失敗したチャネルにerrorをインラインで表示します。

ステータスフィールドの読み方

ステータスには2つのレベルがあり、それぞれ示す内容が異なります。

フィールド値意味
statusDRAFT, PENDING, SCHEDULED, PUBLISHED, FAILED, ARCHIVED, REJECTED投稿全体の状態です。
connectedChannels[].statusSCHEDULED, SUCCESS, ERROR, ARCHIVEDその1つのプラットフォームで何が起きたかを示します。

投稿全体ではPUBLISHEDと表示されていても、1つのチャネルがERRORのままである場合があります。表示には常にconnectedChannels[]を使用してください。投稿レベルのstatusは要約です。

注記。

  • globalPostScheduleは、UTCで表された確定済みの公開時刻です。scheduleDate + scheduleTimeでスケジュールを設定した場合、これはブランドのタイムゾーンに基づいてそれらから確定した時刻であり、タイムゾーンが想定どおりだったかを確認するのに役立ちます。
  • errorは、顧客に表示しても問題のない、人が読んで理解できるメッセージです。reasonは、そのメッセージに対応する短い内部ラベルです。どちらにもプラットフォームのトークンやトレースIDは含まれません。
  • connectedChannels[].idは、ブランドの接続にある接続のUUIDであり、インサイトでsocialConnectedChannelIdとして必要になる値です。
  • archived: trueと表示されるチャネルは、投稿の作成後に接続が解除されています。そのチャネルでは公開されません。接続の解除を参照してください。
  • 認可が失効した後にERRORのままになっているチャネルには、投稿の再試行ではなく、新しい接続リンクが必要です。
  • 配信状態ではなくエンゲージメントの数値を取得するには、GET /social/posts/{postId}/insightsを呼び出します。
  • 1件の投稿を取得するのではなく、ブランドの投稿を一覧表示するには、GET /social/brands/{brandId}/postsを使用します。
Request
curl -X GET 'https://listingsapi.com/api/v4/social/posts/<postId>' \  -H "Authorization: API $LISTINGSAPI_KEY"
Run in playground