---
title: "getSocialMediaPost"
method: GET
path: "/api/v4/social/posts/{postId}"
tags: ["Social"]
---

# getSocialMediaPost

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

## Request

- Base URL: `https://listingsapi.com`
- URL: `https://listingsapi.com/api/v4/social/posts/{postId}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-RapidAPI-Key` and API key in header `X-RapidAPI-Host`
- TypeScript: <https://skmtc.dev/listingsapi/apis/listings-api/docs/api/v4/social/posts/:postId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns one social post with its content, schedule and the live per-channel publish status, link and error.

## Path parameters

- `postId` string, required

## Response `200`

Successful response

- object
  - `data` object, required
    - `getSocialMediaPost` SocialMediaPostDetailsType
      - `name` string
      - `customDataFlag` boolean
      - `status` 'DRAFT' | 'PENDING' | 'SCHEDULED' | 'PUBLISHED' | 'FAILED' | 'ARCHIVED' | 'REJECTED'
      - `initialContent` string
      - `initialMedia` string[]
      - `initialVideo` string[]
      - `socialConnectedChannel` SocialMediaPlatformType
        - `twitter` SocialMediaPlatformDetailsType
          - `socialConnectedAccountIds` string[]
          - `message` string
          - `images` string[]
          - `video` string[]
          - `extraParams` ChannelExtraParamsType
            - `twitterThread` boolean
            - `threads` string[]
            - `contentImageLink` string
          - `socialPostAiContentId` string
        - `instagram` SocialMediaPlatformDetailsType
          - `socialConnectedAccountIds` string[]
          - `message` string
          - `images` string[]
          - `video` string[]
          - `extraParams` ChannelExtraParamsType
            - `twitterThread` boolean
            - `threads` string[]
            - `contentImageLink` string
          - `socialPostAiContentId` string
        - `linkedin` SocialMediaPlatformDetailsType
          - `socialConnectedAccountIds` string[]
          - `message` string
          - `images` string[]
          - `video` string[]
          - `extraParams` ChannelExtraParamsType
            - `twitterThread` boolean
            - `threads` string[]
            - `contentImageLink` string
          - `socialPostAiContentId` string
        - `facebook` SocialMediaPlatformDetailsType
          - `socialConnectedAccountIds` string[]
          - `message` string
          - `images` string[]
          - `video` string[]
          - `extraParams` ChannelExtraParamsType
            - `twitterThread` boolean
            - `threads` string[]
            - `contentImageLink` string
          - `socialPostAiContentId` string
        - `pinterest` SocialMediaPlatformDetailsType
          - `socialConnectedAccountIds` string[]
          - `message` string
          - `images` string[]
          - `video` string[]
          - `extraParams` ChannelExtraParamsType
            - `twitterThread` boolean
            - `threads` string[]
            - `contentImageLink` string
          - `socialPostAiContentId` string
      - `connectedChannels` SocialPostConnectedChannelInfoType[]
        - `id` string
        - `displayName` string
        - `userName` string
        - `userImage` string
        - `liveLink` string
        - `status` 'SCHEDULED' | 'SUCCESS' | 'ARCHIVED' | 'ERROR'
        - `reason` string
        - `error` string
        - `socialPlatformId` integer
        - `platform` 'FACEBOOK' | 'INSTAGRAM' | 'TWITTER' | 'LINKEDIN' | 'PINTEREST': Supported social platforms.
        - `archived` boolean
        - `payload` string: Custom scalar JSONString
        - `instagramBusinessAccountId` InstagramBusinessAccountIdType
          - `idType` string
          - `id` string
      - `globalPostSchedule` string
      - `postAutomationId` string
      - `approvalState` 'INIT' | 'SUBMITTED_FOR_REVIEW' | 'APPROVED' | 'REJECTED' | 'PUBLISHED' | 'SCHEDULED' | 'ARCHIVED'
      - `actionOn` string
      - `comment` string
      - `contentGeneratorId` string
      - `socialPostAiContentId` string
      - `requestId` string
  - `errors` ApiError[]: Present when the operation reported a request-level failure. Writes can also report validation nested under `data.<field>.errors` on a 200.
    - `message` string, required: Human-readable reason, prefixed with the `SYxxxxx` code where one applies.
    - `code` string: The `SYxxxxx` error code on its own, when one applies.
    - `contextInfo` object[]: Key/value pairs naming the field or value that failed.
      - `key` string
      - `value` string

## Other responses

- `400`: Bad request: a malformed filter, an invalid enum value, or a malformed ID. The body carries an `errors` array, or a single `error` object when the request was rejected before it ran (e.g. `SY90001` on `reviewDetails` with no `interactionIds`).
- `401`: Unauthorized — the API key is missing, malformed, or revoked (`SY90005`).
- `403`: Forbidden — the key is valid but not permitted for this resource or operation (`SY90003`).
- `429`: Rate limit exceeded. Wait `retry_after_seconds` (or the `Retry-After` header) and retry with backoff.
- `500`: Server error. The body carries a single `error` object with code `INTERNAL_SERVER_ERROR`.

## Changes

- **2026-09-25** `91249a5e08be`: 1 breaking, 1 info
  - added `#/components/schemas/ApiErrorObject` to the response body `oneOf` list for the response status `400`
  - removed `#/components/schemas/GatewayError` from the response body `oneOf` list for the response status `400`
- **2026-09-17** `e438640d6a00`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/listingsapi/apis/listings-api/changes/api/v4/social/posts/:postId/get.md)

---

[API](https://skmtc.dev/listingsapi/apis/listings-api.md) - [All operations](https://skmtc.dev/listingsapi/apis/listings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/listingsapi/apis/listings-api/revisions/2658a20b9b66?raw)