/api/v4/bulk-posts/{postId}Bir toplu gönderiyi ID ile getirin
İçeriği, konum başına yayın durumu ve etkileşim analizleriyle birlikte tek bir toplu (çok konumlu) gönderi kampanyası döndürür.
Parametreler
Yol
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| postId | string | zorunlu | Base64-encoded bulk post ID (the `id` returned by POST /bulk-posts or listed by GET /locations/{locationId}/bulk-posts). |
Yanıtlar
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.
GET /posts/{postId} işleminin toplu karşılığıdır. Aynı anda birden fazla konumda yayınlanan bir kampanya için aynı SocialPostView yapısını döndürür; dolayısıyla publishedLocationsCount 1'den büyüktür ve socialPostAnalyticsByLocationId her mağaza için bir satır içerir.
Kullanım senaryosu: zincir genelinde yayını takip etme. Tüm mağazalarda bir bayram teklifi için POST /bulk-posts çağrısını yaptıktan sonra, socialPostInfo.status değeri SUCCESS olana kadar GET /bulk-posts/{postId} öğesini düzenli aralıklarla sorgulayın. Ardından hangi mağazaların en çok tıklama aldığını görmek için socialPostAnalyticsByLocationId öğesini okuyun ve bir sitenin ERROR döndürdüğü mağazaları bulmak için publishDetails öğesini (ve her konumun siteStats.status öğesini) tarayın.
Notlar.
postId, ham bir tam sayı değil, toplu oluşturma çağrısının veya toplu listenin döndürdüğü Base64 ile kodlanmışiddeğeridir.socialPostAnalyticsBySite, kampanyadaki tüm konumların verilerini toplar;socialPostAnalyticsByLocationIdise aynı sayıların mağaza bazında dökümünü sunar.
Bu örnek, API şemasından oluşturulmuştur. Canlı örnek veri hesabında (Jenny Home) toplu kampanya bulunmadığından, sorgulanabilecek gerçek bir ID yoktu; bilinmeyen veya geçersiz bir ID, {"data":null,"errors":[{"message":"An error occurred processing your request."}]} döndürür.
curl -X GET 'https://listingsapi.com/api/v4/bulk-posts/<postId>' \ -H "Authorization: API $LISTINGSAPI_KEY"