/api/v4/social/posts/{postId}/insightsGönderi istatistiklerini ve yorumlarını alın
Bağlı tek bir kanalda yayımlanmış tek bir gönderi için platformun kendi etkileşim veri yükünü ve yorumları döndürür.
Parametreler
Yol
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| postId | string | zorunlu | Post UUID, the `socialPostId` returned by POST /social/posts. |
Sorgu
| Ad | Tür | Zorunlu | Açıklama | Varsayılan |
|---|---|---|---|---|
| socialConnectedChannelId | string | zorunlu | UUID of the connection to read insights for, the `id` of a row from the brand's connections list. Insights are per channel, so this is required even when the post targeted one platform. Note the name: this endpoint takes `socialConnectedChannelId`, while disconnect takes `socialProfileConnectedChannelId` for the same ID. | — |
Yanıtlar
200The platform's engagement payload and comments. Both fields are JSON strings whose keys are set by the platform, not by Listings API: parse them before reading.
{ "data": { "getPostInsightsAndCommentsForSocialChannel": { "insights": "{\"impressions\": 4820, \"reach\": 3915, \"likes\": 212, \"comments\": 18, \"saved\": 44, \"shares\": 9, \"profile_visits\": 61}", "comments": "[{\"id\": \"17912345678901234\", \"username\": \"marta.builds\", \"text\": \"That oak finish is beautiful. Do you ship?\", \"like_count\": 3, \"timestamp\": \"2026-10-02T15:12:44+0000\"}, {\"id\": \"17912345678905678\", \"username\": \"eastsidehome\", \"text\": \"Stopping by Saturday!\", \"like_count\": 0, \"timestamp\": \"2026-10-02T18:40:02+0000\"}]" } }}401Unauthenticated, missing or invalid API key.
404No post with that ID on this account, or the connection does not belong to the post's brand (`SY95052`).
Tek bir kanalda yayımlanmış tek bir gönderi hakkında platformun bildirdiği bilgileri döndürür: gönderinin etkileşim metrikleri ve gönderiye yapılan yorumlar.
Kullanım senaryosu: gönderi başına etkileşim paneli. Bir müşteri arayüzünüzde yayımlanmış bir gönderiyi açtığında, kanal listesi için GET /social/posts/{postId} çağrısını yapın, ardından her kanal için o kanalın id değeriyle bu uç noktayı bir kez çağırın. insights verisini ayrıştırın, tanıdığınız metrikleri görüntüleyin ve geri kalanını yok sayın; böylece bir platformun alan eklemesi sayfanızın işleyişini hiçbir zaman bozmaz.
Kullanım senaryosu: yanıtlanması gereken yorumları öne çıkarma. Yakın zamanda yayımlanmış gönderiler için bu uç noktayı düzenli aralıklarla sorgulayın ve ayrıştırılan comments dizisindeki yeni öğeleri kendi gelen kutunuza yönlendirin. Bu uç noktanın salt okunur olduğunu unutmayın: bir yoruma Listings API üzerinden değil, platform üzerinden yanıt verilir.
Notlar.
socialConnectedChannelIdzorunludur ve markanın bağlantılarından alınan bağlantınıniddeğeridir; platformunreferenceIddeğeri değildir. Sayılar ilgili platformun API'sinden geldiği için istatistiklerin kapsamı her zaman tek bir kanalla sınırlıdır.- Kanal, gönderiyle aynı markaya ait olmalıdır. Bir gönderi başka bir markanın bağlantısıyla eşleştirildiğinde
SY95052döndürülür. - Yalnızca yayımlanmış gönderilerin istatistikleri vardır. Hâlâ
SCHEDULEDdurumunda olan veya bu kanalda yayımlanması başarısız olan bir gönderi için hata yerine boş veri yükleri döndürülür; bu nedenle bir sonuca varmadan önce gönderidekiconnectedChannels[].statusalanını kontrol edin. - Metriklerin güncelliği platformun bunları ne kadar hızlı güncellediğine bağlıdır; çoğu platformda bu, yayımlanmanın ardından birkaç dakika ile birkaç saat arasında bir gecikme anlamına gelir.
connectedChannels[].statusdeğeriSUCCESSolarak değişir değişmez sayıların hazır olmasını beklemek yerine, bir zamanlayıcı kullanarak düzenli aralıklarla sorgulayın. - Yorum sayısı, platformun tek bir sayfada döndürdüğü miktarla sınırlıdır; bu uç nokta sonraki sayfaları getirmez.
curl -X GET 'https://listingsapi.com/api/v4/social/posts/<postId>/insights?socialConnectedChannelId=<socialConnectedChannelId>' \ -H "Authorization: API $LISTINGSAPI_KEY"