Listings APIListings API
Oturum aç
GET/api/v4/social/posts/{postId}

Bir sosyal medya gönderisini alın

Bir sosyal medya gönderisini içeriği, zamanlaması ve kanal başına güncel yayın durumu, bağlantısı ve hatasıyla birlikte döndürür.

API anahtarı gerektirir. Başlık biçimi ve anahtar yenileme için Kimlik doğrulama bölümüne bakın.

Parametreler

Yol

AdTürZorunluAçıklama
postIdstringzorunluPost UUID, the `socialPostId` returned by POST /social/posts or the `socialPostId` of a row from the brand's post list.

Yanıtlar

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.

Bir gönderiyi UUID'sine göre, oluşturulan içeriği, kesinleşen zamanlaması ve hedeflenen her kanal için o platformda gerçekte ne olduğunu açıklayan bir kayıtla birlikte getirir. Bir gönderi oluşturduktan sonra düzenli aralıklarla sorgulayacağınız uç nokta budur.

Kullanım senaryosu: yayın sonrası doğrulama. Yayınlama eşzamansızdır, bu nedenle POST /social/posts yalnızca gönderinin kabul edildiğini bildirir. Döndürülen socialPostId ile bu uç noktayı düzenli aralıklarla sorgulayın ve connectedChannels[] alanını okuyun: liveLink ile birlikte status: "SUCCESS", gönderinin o kanalda yayında olduğu anlamına gelir; error ayarlanmışken status: "ERROR" ise yayında olmadığını ve nedenini belirtir. Hiçbir kanal artık SCHEDULED durumunda olmadığında sorgulamayı durdurun.

Kullanım senaryosu: müşteriye gönderisinin nerede yayınlandığını gösterme. Kullanıcının yayınlanan gönderiyi doğrudan platformda açabilmesi için her connectedChannels[].liveLink değerini harici bağlantı olarak görüntüleyin ve tüm gönderiyi tek bir başarısızlık durumuna indirgemek yerine, başarısız olan kanallarda error değerini satır içinde gösterin.

Durum alanlarını okuma

İki durum düzeyi vardır ve bunlar farklı soruları yanıtlar.

AlanDeğerlerAnlamı
statusDRAFT, PENDING, SCHEDULED, PUBLISHED, FAILED, ARCHIVED, REJECTEDBir bütün olarak gönderi.
connectedChannels[].statusSCHEDULED, SUCCESS, ERROR, ARCHIVEDO platformda ne olduğu.

Bir kanal ERROR durumundayken gönderinin genel durumu PUBLISHED olabilir. Görüntülemeyi her zaman connectedChannels[] üzerinden yapın; gönderi düzeyindeki status bir özettir.

Notlar.

  • globalPostSchedule, UTC cinsinden kesinleşen yayın anıdır. Zamanlamayı scheduleDate + scheduleTime ile yaptıysanız bu, markanın saat dilimine göre bu değerlerin karşılık geldiği andır; saat diliminin beklediğiniz gibi olduğunu doğrulamak için yararlı bir kontroldür.
  • error, müşteriye güvenle gösterilebilecek, insanlar tarafından okunabilir bir mesajdır; reason ise bunun arkasındaki daha kısa dahili etikettir. Hiçbiri platform token'ları veya izleme kimlikleri içermez.
  • connectedChannels[].id, markanın bağlantılarından alınan bağlantı UUID'sidir ve istatistikler için socialConnectedChannelId olarak gereken değerdir.
  • archived: true durumundaki bir kanalın bağlantısı, gönderi oluşturulduktan sonra kesilmiştir. Gönderi bu kanalda yayınlanmayacaktır; bağlantıyı kesme bölümüne bakın.
  • Yetkilendirme geçerliliğini yitirdikten sonra ERROR durumunda takılı kalan bir kanal için gönderiyi yeniden denemek değil, yeni bir bağlantı kurma bağlantısı gerekir.
  • İletim durumu yerine etkileşim sayılarını almak için GET /social/posts/{postId}/insights çağrısını yapın.
  • Tek bir gönderiyi getirmek yerine bir markanın gönderilerini listelemek için GET /social/brands/{brandId}/posts kullanın.
Request
curl -X GET 'https://listingsapi.com/api/v4/social/posts/<postId>' \  -H "Authorization: API $LISTINGSAPI_KEY"
Run in playground