---
title: "List Social Account Posts"
method: GET
path: "/social_accounts/{id}/posts"
tags: ["Social Accounts"]
---

# List Social Account Posts

`GET /social_accounts/{id}/posts`

Lists the existing posts of a connected Facebook page, Instagram account, or TikTok account.

## Query parameters

- `account_id` string, required
- `post_id` string
- `first` integer
- `after` string

## Response `200`

single post returned when post_id is given

- object
  - `data` SocialAccountPost[], required
    - `call_to_action` 'learn_more' | 'shop_now' | 'sign_up' | 'subscribe' | 'get_started' | 'book_now' | 'apply_now' | 'contact_us' | 'download' | 'order_now' | 'buy_now' | 'get_quote' | 'message_page' | 'whatsapp_message' | 'instagram_message' | 'call_now' | 'get_directions' | 'send_updates' | 'get_offer' | 'watch_more' | 'listen_now' | 'play_game' | 'open_link' | 'no_button' | 'get_offer_view' | 'get_event_tickets' | 'see_menu' | 'request_time' | 'event_rsvp' | 'see_details' | 'view_instagram_profile' | 'null', nullable, required — The post's call-to-action button, for example shop_now (Facebook only; null for Instagram and TikTok).
    - `destination_url` string, nullable, required — The URL the post's call-to-action drives to (Facebook only; null for Instagram and TikTok).
    - `embed_url` string, nullable, required — An iframe-embeddable URL for previewing the post inline (the platform's player or post embed). For TikTok this is the only preview, since media_url is null; for Facebook and Instagram it supplements media_url. Null when no public embed is available.
    - `id` string, required — The platform's own identifier for the post or media. Use it to reference the post on an ad.
    - `media_url` string, nullable, required — The URL of the post's media — the image for image posts, the playable video file for video posts. Null for TikTok, which exposes no raw file (use embed_url). Meta URLs are signed and expire after roughly 24 hours, so don't store them.
    - `restrictions` string[], required
    - `thumbnail_url` string, nullable, required — Poster image for video posts (always set for TikTok, which is video-only); null for image posts, where media_url is already the image.
  - `page_info` object, required
    - `end_cursor` string, nullable, required
    - `has_next_page` boolean, required

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `404` — Resource not found

## Changes

- **2026-08-19** `23dfbe1a0d1f` — 3 warning
  - added the new `instagram_destination` enum value to the `data/items/restrictions/items/` response property for the response status `200`
  - added the new `messenger_destination` enum value to the `data/items/restrictions/items/` response property for the response status `200`
  - added the new `whatsapp_destination` enum value to the `data/items/restrictions/items/` response property for the response status `200`
- **2026-08-12** `6fb1c04bf255` — 2 warning
  - added the new `copyrighted_music` enum value to the `data/items/restrictions/items/` response property for the response status `200`
  - added the new `promotion_ineligible` enum value to the `data/items/restrictions/items/` response property for the response status `200`
- **2026-08-07** `f1020c3ecda4` — 3 info
  - added the optional property `error/code` to the response with the `400` status
  - added the optional property `error/code` to the response with the `401` status
  - added the optional property `error/code` to the response with the `404` status
- **2026-07-31** `099fdc3be422` — 1 info
  - added the required property `data/items/restrictions` to the response with the `200` status
- **2026-07-26** `60bbb4a6ffbc` — 1 breaking, 1 info
  - for the `query` request parameter `first`, default value was changed from `25` to `20`
  - added the required property `data/items/embed_url` to the response with the `200` status

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/social_accounts/:id/posts/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/9e320991dd2f/schema)