/api/v4/bulk-posts/{postId}Recupera un post collettivo tramite ID
Restituisce una singola campagna di post per più sedi con contenuti, stato di pubblicazione per sede e analisi del coinvolgimento.
Parametri
Percorso
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| postId | string | obbligatorio | Base64-encoded bulk post ID (the `id` returned by POST /bulk-posts or listed by GET /locations/{locationId}/bulk-posts). |
Risposte
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.
L'equivalente collettivo di GET /posts/{postId}. Restituisce la stessa struttura SocialPostView per una campagna pubblicata su più sedi contemporaneamente, quindi publishedLocationsCount è maggiore di 1 e socialPostAnalyticsByLocationId contiene una riga per negozio.
Caso d'uso: monitorare una pubblicazione su tutta la catena. Dopo aver eseguito POST /bulk-posts per un'offerta festiva in tutti i negozi, interroga periodicamente GET /bulk-posts/{postId} finché socialPostInfo.status non è SUCCESS. Poi leggi socialPostAnalyticsByLocationId per vedere quali negozi hanno generato più clic e controlla publishDetails (insieme a siteStats.status di ciascuna sede) per individuare eventuali negozi per i quali un sito ha restituito ERROR.
Note.
postIdè il valoreidcodificato in Base64 restituito dalla chiamata di creazione collettiva o dall'elenco collettivo, non un intero non codificato.socialPostAnalyticsBySiteaggrega i dati di tutte le sedi della campagna;socialPostAnalyticsByLocationIdsuddivide gli stessi numeri per negozio.
Questo esempio è costruito a partire dallo schema dell'API. L'account iniziale nell'ambiente live (Jenny Home) non ha campagne collettive, quindi non era disponibile alcun ID reale da recuperare; un ID sconosciuto o non valido restituisce {"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"