---
title: "Individual social post view page."
method: GET
path: "/api/v4/posts/{postId}"
tags: ["Posts"]
---

# Individual social post view page.

`GET /api/v4/posts/{postId}`

Returns a single social post campaign with its content, per-site publish status, and engagement analytics.

## Path parameters

- `postId` string, required

## Response `200`

Successful response

- SocialPostView
  - `socialPostId` string
  - `socialPostInfo` SocialPost — A newer multi-site/multi-location post campaign.
    - `id` string, required
    - `name` string, required
    - `status` 'INPROGRESS' | 'SCHEDULED' | 'SUCCESS' | 'ERROR' | 'DELETED' | 'EXPIRED', required — Social Post lifecycle statuses.
    - `type` 'EVENT' | 'OFFER' | 'ANNOUNCEMENT' | 'COVID19' | 'PRODUCT', required — Social Post types.
    - `createdAt` string, date, required
    - `deletedAt` string, date
    - `expiredAt` string, date
    - `scheduledStartDate` string, date
    - `scheduledEndDate` string, date
    - `views` integer
    - `clicks` integer
    - `shares` integer
    - `reactions` integer
    - `comments` integer
    - `sites` SitesType[], required
    - `message` PostMessage[]
      - `message` string
      - `site` 'GOOGLE' | 'FACEBOOK' — Sites a post can be published to.
    - `cta` PostCta[]
      - `type` SiteCtaTypes
        - `value` string
        - `label` string
      - `url` string
      - `site` 'GOOGLE' | 'FACEBOOK' — Sites a post can be published to.
      - `tinyUrl` string
    - `contextInfo` PostContextInfo
      - `couponCode` string
      - `redeemUrl` string
      - `termsConditions` string
      - `title` string
      - `discount` string
      - `locationType` string
      - `startDay` string, date
      - `startTime` string
      - `endDay` string, date
      - `endTime` string
    - `mediaUrl` SocialPostMedia[]
      - `url` string
      - `site` 'GOOGLE' | 'FACEBOOK' — Sites a post can be published to.
      - `type` 'IMAGE' | 'VIDEO' — Media type for social posts.
    - `publishDetails` SocialPostPublishDetail[]
      - `site` 'GOOGLE' | 'FACEBOOK' — Sites a post can be published to.
      - `status` 'PUBLISHING' | 'PUBLISHED' | 'DELETED' | 'EXPIRED' | 'ERROR' — Publish statuses per site.
      - `createdDate` string, date
      - `publishedDate` string, date
      - `deletedDate` string, date
      - `expiredDate` string, date
      - `submissionError` string
    - `postLinks` SocialPostPublishedLink[]
      - `site` 'GOOGLE' | 'FACEBOOK' — Sites a post can be published to.
      - `link` string
    - `locationIds` integer[], required
  - `publishedLocationsCount` integer
  - `socialPostAnalyticsBySite` SocialPostAnalyticsSitewise[]
    - `clicks` integer
    - `views` integer
    - `reactions` integer
    - `shares` integer
    - `comments` integer
    - `site` 'GOOGLE' | 'FACEBOOK' — Sites a post can be published to.
  - `socialPostAnalyticsByLocationId` SocialPostAnalyticsLocationwise[]
    - `locationId` integer
    - `siteStats` StatsAndStatus[]
      - `clicks` integer
      - `views` integer
      - `reactions` integer
      - `shares` integer
      - `comments` integer
      - `status` string
      - `site` 'GOOGLE' | 'FACEBOOK' — Sites a post can be published to.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Server error

---

[API](https://skmtc.net/listingsapi/apis/listings-api.md) · [All operations](https://skmtc.net/listingsapi/apis/listings-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/listingsapi/listings-api/versions/9274a1eac380/schema)