/api/v4/bulk-posts/{postId}Ambil postingan massal berdasarkan ID
Mengembalikan satu kampanye postingan massal (multilokasi) beserta kontennya, status publikasi per lokasi, dan analitik interaksi.
Parameter
Path
| Nama | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| postId | string | wajib | Base64-encoded bulk post ID (the `id` returned by POST /bulk-posts or listed by GET /locations/{locationId}/bulk-posts). |
Respons
200The campaign's content, per-location publish details, and analytics.
{ "data": { "socialPostView": { "socialPostId": "U29jaWFsUG9zdDo1MTA4OA==", "socialPostInfo": { "id": "U29jaWFsUG9zdDo1MTA4OA==", "name": "Diwali Offer - All Stores", "status": "SUCCESS", "type": "OFFER", "createdAt": "2026-06-20", "scheduledStartDate": "2026-06-22", "scheduledEndDate": "2026-07-06", "views": 4210, "clicks": 318, "shares": 12, "reactions": 87, "comments": 4, "sites": ["GOOGLE", "FACEBOOK"], "message": [ { "site": "GOOGLE", "message": "Festive savings across all our stores this week." }, { "site": "FACEBOOK", "message": "Festive savings across all our stores this week!" } ], "cta": [ { "type": { "value": "GET_OFFER", "label": "Get offer" }, "url": "https://jennyhome.example/diwali", "site": "GOOGLE", "tinyUrl": "https://tiny.cc/jh-diwali" } ], "contextInfo": { "couponCode": "DIWALI25", "redeemUrl": "https://jennyhome.example/diwali", "termsConditions": "Valid in-store only. Cannot be combined with other offers.", "title": "25% off storewide", "discount": "25%", "startDay": "2026-06-22", "endDay": "2026-07-06" }, "mediaUrl": [ { "url": "https://cdn.listingsapi.com/posts/51088/diwali.jpg", "site": "GOOGLE", "type": "IMAGE" } ], "publishDetails": [ { "site": "GOOGLE", "status": "PUBLISHED", "createdDate": "2026-06-20", "publishedDate": "2026-06-22", "submissionError": null }, { "site": "FACEBOOK", "status": "PUBLISHED", "createdDate": "2026-06-20", "publishedDate": "2026-06-22", "submissionError": null } ], "postLinks": [ { "site": "GOOGLE", "link": "https://www.google.com/maps/place/?post=51088" } ], "locationIds": [1800289, 1800290, 1800291] }, "publishedLocationsCount": 3, "socialPostAnalyticsBySite": [ { "site": "GOOGLE", "views": 3120, "clicks": 240, "reactions": 61, "shares": 0, "comments": 0 }, { "site": "FACEBOOK", "views": 1090, "clicks": 78, "reactions": 26, "shares": 12, "comments": 4 } ], "socialPostAnalyticsByLocationId": [ { "locationId": 1800289, "siteStats": [ { "site": "GOOGLE", "status": "PUBLISHED", "views": 1040, "clicks": 80, "reactions": 20, "shares": 0, "comments": 0 }, { "site": "FACEBOOK", "status": "PUBLISHED", "views": 360, "clicks": 26, "reactions": 9, "shares": 4, "comments": 1 } ] } ] } }}401Unauthenticated, missing or invalid API key.
Versi massal dari GET /posts/{postId}. Mengembalikan struktur SocialPostView yang sama untuk kampanye yang dipublikasikan ke beberapa lokasi sekaligus, sehingga publishedLocationsCount lebih besar dari 1 dan socialPostAnalyticsByLocationId memuat satu baris per toko.
Kasus penggunaan: melacak peluncuran di seluruh jaringan toko. Setelah memanggil POST /bulk-posts untuk penawaran hari raya di seluruh toko, lakukan polling pada GET /bulk-posts/{postId} hingga socialPostInfo.status bernilai SUCCESS. Kemudian baca socialPostAnalyticsByLocationId untuk melihat toko mana yang menghasilkan klik terbanyak, dan periksa publishDetails (beserta siteStats.status setiap lokasi) untuk menemukan toko yang situsnya mengembalikan ERROR.
Catatan.
postIdadalahidyang dikodekan dalam Base64 dan dikembalikan oleh panggilan bulk-create atau daftar massal, bukan bilangan bulat mentah.socialPostAnalyticsBySitemengagregasikan data dari seluruh lokasi dalam kampanye;socialPostAnalyticsByLocationIdmerinci angka yang sama per toko.
Contoh ini dibuat berdasarkan skema API. Akun seed aktif (Jenny Home) tidak memiliki kampanye massal, sehingga tidak ada ID nyata yang dapat digunakan untuk mengambil data; ID yang tidak dikenal atau tidak valid mengembalikan {"data":null,"errors":[{"message":"An error occurred processing your request."}]}.
curl -X GET 'https://listingsapi.com/api/v4/bulk-posts/<postId>' \ -H "Authorization: API $LISTINGSAPI_KEY"