📝 Posts

Fetch social media posts

Retrieve a paginated list of social media posts for a specific workspace with filtering options

get/api/v1/workspaces/{workspace_id}/posts

Path parameters

workspace_idstring required
Example:610a1e660cb41530ca40d372

Workspace ID

Query parameters

status[]string[]

Filter by post status using array notation. Example: status[]=draft&status[]=scheduled&status[]=published. Use notification_sent / notification_declined for mobile push-notification publishing flow, and processing for posts currently being published.

[
  "scheduled",
  "published"
]
date_fromstring date
Example:2026-01-01

Filter posts from this date (YYYY-MM-DD)

date_tostring date
Example:2026-12-31

Filter posts to this date (YYYY-MM-DD)

pageinteger
Example:1

Page number for pagination

per_pageinteger
Example:10

Number of items per page

approval_assigned_to[]string[]

Filter by approver user IDs. Returns posts where these users are assigned as approvers.

[
  "690d926bde7774c0dd0fc242"
]
approval_requested_by[]string[]

Filter by users who requested approval. Returns posts submitted for review by these users.

[
  "690d926bde7774c0dd0fc242"
]
labels[]string[]

Filter posts by label IDs.

[
  "66a1f2e4c8b9a1234567890b"
]
campaigns[]string[]

Filter posts by campaign (folder) IDs.

[
  "66a1f2e4c8b9a1234567890c"
]
content_category[]string[]

Filter posts by content category IDs.

[
  "625d06734ceb636c2f5e7743"
]
created_by[]string[]

Filter posts by the user IDs who created them.

[
  "690d926bde7774c0dd0fc242"
]
comment_status'resolved' | 'unresolved' | 'all'
Example:unresolved

Filter posts by comment resolution status. all (default) returns all posts regardless of comment state.

Response

Posts retrieved successfully

statusboolean
messagestring
current_pageinteger
per_pageinteger
totalinteger
last_pageinteger
frominteger
tointeger

Example response

{
  "status": true,
  "message": "Posts retrieved successfully",
  "current_page": 1,
  "per_page": 10,
  "total": 25,
  "last_page": 3,
  "from": 1,
  "to": 10,
  "data": [
    {
      "id": "61e006a89be9dd0cd07ec692",
      "workspace_id": "610a1e660cb41530ca40d372",
      "post_url": "https://app.contentstudio.io/my-workspace/publisher/planner/list-view?plan_ids=61e006a89be9dd0cd07ec692",
      "common": {
        "content": {
          "text": "Check out our latest product launch! ",
          "media": {
            "images": [
              {
                "url": "https://example.com/image1.jpg"
              }
            ],
            "video": {
              "url": "https://example.com/video.mp4",
              "thumbnail": "https://example.com/thumb.jpg",
              "duration": "00:34"
            }
          }
        }
      },
      "accounts": [
        {
          "id": "350830594784444",
          "platform": "facebook",
          "name": "My Business Page",
          "username": "@mybusiness",
          "posting_status": "success",
          "post_link": "https://facebook.com/350830594784444/posts/123"
        }
      ],
      "scheduling": {
        "publish_type": "scheduled",
        "execute_time": "2025-07-25T15:30:00Z"
      },
      "created_at": "2026-01-05T10:30:00Z",
      "updated_at": "2026-01-05T10:30:00Z",
      "created_by": "John Doe",
      "content_category_id": "66a1f2e4c8b9a1234567890d",
      "labels": [
        {
          "id": "66a1f2e4c8b9a1234567890b",
          "name": "Marketing",
          "color": "color_1"
        }
      ],
      "campaign": {
        "id": "66a1f2e4c8b9a1234567890c",
        "name": "Summer Campaign",
        "color": "color_9"
      },
      "first_comment": {
        "message": "Don't forget to check our website!",
        "accounts": [
          "66a1f2e4c8b9a1234567890e"
        ]
      },
      "gmb_options": {
        "topic_type": "STANDARD"
      },
      "youtube_options": {
        "privacy_status": "public",
        "category": "22"
      },
      "tiktok_options": {
        "privacy_level": "PUBLIC_TO_EVERYONE"
      },
      "twitter_options": {
        "has_threaded_tweets": true,
        "threaded_tweets": [
          {
            "message": "Part 1 of the thread",
            "media": [
              "https://example.com/media.jpg"
            ]
          }
        ]
      },
      "threads_options": {
        "has_multi_threads": true,
        "multi_threads": [
          {
            "message": "Part 1 of the thread",
            "media": [
              "https://example.com/media.jpg"
            ]
          }
        ]
      },
      "facebook_options": {
        "carousel": {
          "is_carousel_post": true,
          "call_to_action": "NO_BUTTON"
        }
      },
      "linkedin_options": {
        "title": "Q3 Product Highlights",
        "is_carousel": true,
        "accounts": [
          "105256406"
        ],
        "post_type": "poll",
        "poll": {
          "question": "Which framework do you prefer?",
          "options": [
            "Vue"
          ],
          "duration": "SEVEN_DAYS"
        }
      },
      "approval": {
        "status": "pending_approval",
        "approve_option": "anyone",
        "notes": "Please review before publishing",
        "approvers": [
          {
            "user_id": "66a1f2e4c8b9a1234567890d",
            "name": "Jane Smith",
            "email": "jane@example.com",
            "status": "pending",
            "last_action_time": "2026-01-10T15:30:00Z",
            "last_action_note": "Looks good, approved!"
          }
        ]
      },
      "approval_workflow": {
        "workflow_id": "66a1f2e4c8b9a1234567890d",
        "workflow_name": "Marketing Approval",
        "status": "pending",
        "current_level": 1,
        "total_levels": 2,
        "submitted_at": "2026-01-10T15:30:00Z",
        "levels": [
          {
            "level_number": 1,
            "title": "Editors",
            "rule": "anyone",
            "members": [
              {
                "user_id": "627a078300a7d866600e7d02",
                "status": "pending"
              }
            ]
          }
        ]
      },
      "external_actions": [
        {
          "name": "h2",
          "email": "hello@yopmail.com",
          "action": "approve"
        }
      ],
      "external_comments": [
        {
          "name": "h2",
          "email": "hello@yopmail.com",
          "comment": "Looks good"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.