/api/v4/bulk-posts/{postId}Buscar uma publicação em massa por ID
Retorna uma única campanha de publicação em massa (para vários locais) com seu conteúdo, o status de publicação por local e as análises de engajamento.
Parâmetros
Caminho
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| postId | string | obrigatório | Base64-encoded bulk post ID (the `id` returned by POST /bulk-posts or listed by GET /locations/{locationId}/bulk-posts). |
Respostas
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.
É o equivalente em massa de GET /posts/{postId}. Retorna a mesma estrutura SocialPostView para uma campanha publicada em vários locais ao mesmo tempo, portanto publishedLocationsCount é maior que 1 e socialPostAnalyticsByLocationId contém uma linha por loja.
Caso de uso: acompanhar uma publicação em toda a rede. Depois de executar POST /bulk-posts para uma oferta comemorativa em todas as lojas, consulte GET /bulk-posts/{postId} periodicamente até que socialPostInfo.status seja SUCCESS. Em seguida, leia socialPostAnalyticsByLocationId para ver quais lojas geraram mais cliques e examine publishDetails (além de siteStats.status de cada local) para encontrar qualquer loja em que um site tenha retornado ERROR.
Observações.
postIdé oidcodificado em Base64 retornado pela chamada de criação em massa ou pela listagem em massa, e não um número inteiro sem codificação.socialPostAnalyticsBySiteagrega os dados de todos os locais da campanha;socialPostAnalyticsByLocationIddetalha os mesmos números por loja.
Este exemplo foi criado a partir do esquema da API. A conta usada como fonte de dados reais (Jenny Home) não tem campanhas em massa, então não havia um ID real para buscar; um ID desconhecido ou inválido retorna {"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"