---
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

---

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