Listings APIListings API
Masuk
GET/api/v4/social/posts/{postId}

Mendapatkan satu unggahan media sosial

Mengembalikan satu unggahan media sosial beserta konten, jadwal, serta status publikasi, tautan, dan kesalahan terkini untuk setiap kanal.

Memerlukan kunci API. Lihat Autentikasi untuk format header dan rotasi kunci.

Parameter

Path

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

Respons

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.

Mengambil satu unggahan berdasarkan UUID-nya, beserta konten yang disusun, jadwal yang telah ditentukan, dan satu entri untuk setiap kanal yang ditargetkan yang menjelaskan apa yang sebenarnya terjadi di platform tersebut. Endpoint ini yang Anda periksa secara berkala setelah membuat unggahan.

Kasus penggunaan: verifikasi setelah publikasi. Publikasi bersifat asinkron, sehingga POST /social/posts hanya memberi tahu Anda bahwa unggahan telah diterima. Periksa endpoint ini secara berkala menggunakan socialPostId yang dikembalikan dan baca connectedChannels[]: status: "SUCCESS" dengan liveLink berarti unggahan telah tayang di kanal tersebut, sedangkan status: "ERROR" dengan error yang terisi berarti unggahan belum tayang dan menjelaskan alasannya. Hentikan pemeriksaan berkala setelah tidak ada lagi kanal yang masih berstatus SCHEDULED.

Kasus penggunaan: menunjukkan kepada pelanggan tempat unggahan mereka dipublikasikan. Tampilkan setiap connectedChannels[].liveLink sebagai tautan keluar agar pengguna dapat membuka unggahan yang telah dipublikasikan langsung di platform tersebut, dan tampilkan error langsung pada kanal yang gagal alih-alih menyederhanakan seluruh unggahan menjadi satu status gagal.

Membaca field status

Ada dua tingkat status yang menjawab pertanyaan berbeda.

FieldNilaiArti
statusDRAFT, PENDING, SCHEDULED, PUBLISHED, FAILED, ARCHIVED, REJECTEDUnggahan secara keseluruhan.
connectedChannels[].statusSCHEDULED, SUCCESS, ERROR, ARCHIVEDApa yang terjadi di satu platform tersebut.

Sebuah unggahan dapat berstatus PUBLISHED secara keseluruhan sementara satu kanal berstatus ERROR. Selalu tampilkan berdasarkan connectedChannels[]; status pada tingkat unggahan merupakan ringkasan.

Catatan.

  • globalPostSchedule adalah waktu publikasi yang telah ditentukan dalam UTC. Jika Anda menjadwalkan dengan scheduleDate + scheduleTime, waktu ini merupakan hasil konversi keduanya berdasarkan zona waktu merek — berguna untuk memeriksa bahwa zona waktu tersebut sesuai dengan yang Anda harapkan.
  • error adalah pesan yang mudah dibaca dan aman ditampilkan kepada pelanggan; reason adalah label internal yang lebih singkat untuk pesan tersebut. Keduanya tidak memuat token platform atau ID pelacakan.
  • connectedChannels[].id adalah UUID koneksi dari koneksi merek, sekaligus nilai yang diperlukan oleh insights sebagai socialConnectedChannelId.
  • Kanal yang berstatus archived: true telah diputus koneksinya setelah unggahan dibuat. Kanal tersebut tidak akan memublikasikan unggahan; lihat pemutusan koneksi.
  • Kanal yang tetap berstatus ERROR setelah otorisasi kedaluwarsa memerlukan tautan koneksi baru, bukan percobaan ulang publikasi unggahan.
  • Untuk mendapatkan angka interaksi alih-alih status pengiriman, panggil GET /social/posts/{postId}/insights.
  • Untuk menampilkan daftar unggahan suatu merek alih-alih mengambil satu unggahan, gunakan 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