---
title: "List social posts"
method: GET
path: "/social/posts"
tags: ["Social"]
---

# List social posts

`GET /social/posts`

## Request

- Base URL: `https://api.rendley.com/v1`
- URL: `https://api.rendley.com/v1/social/posts`
- Auth: API key in header `Authorization`

One page of the workspace's scheduled, published and failed posts, one per account, by publish time.

## Query parameters

- `workspace_id` string, uuid, required
- `status` 'scheduled' | 'published' | 'failed'
- `channels` string
- `order` 'newest' | 'oldest'
- `page` integer
- `limit` integer

## Response `200`

OK

- object
  - `data` SocialSocialPostResponse[]: Success data
    - `account_username` string
    - `caption` string
    - `created_at` string
    - `error` string
    - `error_code` string: account_expired, media_rejected or rate_limited when the failure is a known kind.
    - `id` string
    - `metrics` SocialPostMetrics
      - `comments` integer
      - `likes` integer
      - `saves` integer
      - `shares` integer
      - `views` integer
    - `platform` string
    - `platform_options` SocialPlatformOptions
      - `instagram` SocialInstagramOptions
        - `placement` 'reels' | 'timeline' | 'stories': reels (default), timeline (feed) or stories.
        - `share_to_feed` boolean: A reel also shows in the feed, not only in the Reels tab.
      - `tiktok` SocialTiktokOptions
        - `allow_comment` boolean
        - `allow_duet` boolean
        - `allow_stitch` boolean
        - `is_ai_generated` boolean
        - `privacy_status` 'public' | 'private': public (default) or private.
      - `youtube` SocialYoutubeOptions
        - `made_for_kids` boolean
        - `privacy_status` 'public' | 'unlisted' | 'private': public (default), unlisted or private.
        - `tags` string[], required
        - `title` string: Video title; defaults to the caption, so it is required when the caption is longer than 100 characters.
    - `project_id` string
    - `result` object
    - `scheduled_at` string
    - `status` string
    - `thumbnail_url` string
  - `error` HttpResponseAPIError
    - `code` string
    - `fields` HttpResponseFieldError[]
      - `field` string
      - `message` string
    - `message` string
  - `meta` object: Meta data
    - `page` integer
    - `per_page` integer
    - `total_results` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/rendley/apis/rendley-api.md) - [All operations](https://skmtc.dev/rendley/apis/rendley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rendley/apis/rendley-api/revisions/7eb8713bbf78?raw)