Fetch social media posts
Retrieve a paginated list of social media posts for a specific workspace with filtering options
Path parameters
Workspace ID
Query parameters
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" ]
Filter posts from this date (YYYY-MM-DD)
Filter posts to this date (YYYY-MM-DD)
Page number for pagination
Number of items per page
Filter by approver user IDs. Returns posts where these users are assigned as approvers.
[ "690d926bde7774c0dd0fc242" ]
Filter by users who requested approval. Returns posts submitted for review by these users.
[ "690d926bde7774c0dd0fc242" ]
Filter posts by label IDs.
[ "66a1f2e4c8b9a1234567890b" ]
Filter posts by campaign (folder) IDs.
[ "66a1f2e4c8b9a1234567890c" ]
Filter posts by content category IDs.
[ "625d06734ceb636c2f5e7743" ]
Filter posts by the user IDs who created them.
[ "690d926bde7774c0dd0fc242" ]
Filter posts by comment resolution status. all (default) returns all posts regardless of comment state.
Response
Posts retrieved successfully
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.