OnlySocial
  1. Posts
OnlySocial
  • 🐶 OnlySocial API Walk through
  • Only Social
    • Accounts
      • List Accounts
      • Get an account
    • Media
      • List media files
      • Get a media file
      • Upload a media file
      • Delete a media file
    • Tags
      • List Tags
      • Get a tag
      • Create a tag
      • Delete a tag
      • Update a tag
    • Posts
      • List posts
        GET
      • Get a post
        GET
      • Create a post
        POST
      • Delete a post
        DELETE
      • Delete multiple post
        DELETE
      • Schedule a post
        POST
      • Add a post to Queue
        POST
      • Update a post
        PUT
  1. Posts

List posts

GET
https://app.onlysocial.io/os/api/{workspaceUuid}/posts

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
workspaceUuid
string 
required
Example:
<workspaceUuid>
Query Params
page
string 
optional
Example:
1

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://app.onlysocial.io/os/api/<workspaceUuid>/posts?page=1'

Responses

🟢200Success
application/json
Body
object {0}
Example
{
    "data": [
        {
            "id": 3,
            "uuid": "8eb4e98d-2b93-44bd-a664-7a6438eff67b",
            "status": "draft",
            "accounts": [],
            "versions": [
                {
                    "account_id": 0,
                    "is_original": true,
                    "content": [
                        {
                            "body": "",
                            "media": [],
                            "url": ""
                        }
                    ],
                    "options": {
                        "tiktok": {
                            "privacy_level": {
                                "account-0": null
                            },
                            "allow_comments": {
                                "account-0": false
                            },
                            "allow_duet": {
                                "account-0": false
                            },
                            "allow_stitch": {
                                "account-0": false
                            },
                            "content_disclosure": {
                                "account-0": false
                            },
                            "brand_organic_toggle": {
                                "account-0": false
                            },
                            "brand_content_toggle": {
                                "account-0": false
                            }
                        },
                        "youtube": {
                            "title": null,
                            "status": "public"
                        },
                        "linkedin": {
                            "visibility": "PUBLIC"
                        },
                        "mastodon": {
                            "sensitive": false
                        },
                        "instagram": {
                            "type": "post"
                        },
                        "pinterest": {
                            "title": null,
                            "link": null,
                            "boards": {
                                "account-0": null
                            }
                        },
                        "facebook_page": {
                            "type": "post"
                        }
                    }
                }
            ],
            "tags": [
                {
                    "id": 2,
                    "uuid": "f9288040-0d50-4e40-83d6-10ef6dd31d9d",
                    "name": "release",
                    "hex_color": "#111827"
                },
                {
                    "id": 3,
                    "uuid": "a09367a5-dfc1-43d7-9557-70eb93e01e01",
                    "name": "news",
                    "hex_color": "#38bdf8"
                }
            ],
            "user": {
                "name": "Test User"
            },
            "scheduled_at": null,
            "published_at": null,
            "created_at": "2024-03-29 15:26:06",
            "trashed": false
        },
        {
            "id": 2,
            "uuid": "69288ffd-d4ef-4666-9320-4b9e120694fc",
            "status": "published",
            "accounts": [
                {
                    "id": 3,
                    "uuid": "ed1d7f93-ebca-4217-957c-a25fbb2c1075",
                    "name": "Dima Botezatu",
                    "username": "BotezatuDima",
                    "image": "https://example.com/avatar/dima.jpg",
                    "provider": "twitter",
                    "data": null,
                    "authorized": true,
                    "created_at": "2024-03-29 09:55:31",
                    "external_url": "https://twitter.com/BotezatuDima/status/23424241115453465",
                    "errors": []
                }
            ],
            "versions": [
                {
                    "account_id": 0,
                    "is_original": true,
                    "content": [
                        {
                            "body": "<div>Create your dream SaaS easily with Mixpost! 💻✨</div>",
                            "media": [
                                {
                                    "id": "1",
                                    "name": "blue.png",
                                    "mime_type": "image/png",
                                    "type": "image",
                                    "url": "https://app.onlysocial.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi.png",
                                    "thumb_url": "https://app.onlysocial.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi-thumb.png",
                                    "is_video": false,
                                    "created_at": "2024-03-29 15:33:23"
                                }
                            ],
                            "url": ""
                        }
                    ],
                    "options": {
                        "tiktok": {
                            "privacy_level": {
                                "account-0": null
                            },
                            "allow_comments": {
                                "account-0": false
                            },
                            "allow_duet": {
                                "account-0": false
                            },
                            "allow_stitch": {
                                "account-0": false
                            },
                            "content_disclosure": {
                                "account-0": false
                            },
                            "brand_organic_toggle": {
                                "account-0": false
                            },
                            "brand_content_toggle": {
                                "account-0": false
                            }
                        },
                        "youtube": {
                            "title": null,
                            "status": "public"
                        },
                        "linkedin": {
                            "visibility": "PUBLIC"
                        },
                        "mastodon": {
                            "sensitive": false
                        },
                        "instagram": {
                            "type": "post"
                        },
                        "pinterest": {
                            "title": null,
                            "link": null,
                            "boards": {
                                "account-0": null
                            }
                        },
                        "facebook_page": {
                            "type": "post"
                        }
                    }
                }
            ],
            "tags": [],
            "user": {
                "name": "Dima Botezatu"
            },
            "scheduled_at": "2024-03-29 09:55:57",
            "published_at": "2024-03-29 09:56:03",
            "created_at": "2024-03-29 09:55:34",
            "trashed": false
        },
        {
            "id": 1,
            "uuid": "b1b06706-ef95-42b7-8ac8-d648dc9a9d65",
            "status": "published",
            "accounts": [
                {
                    "id": 2,
                    "uuid": "cfbdc3eb-22cb-4d15-b2a0-63d5fcd5bd92",
                    "name": "Dima Botezatu",
                    "username": "dimabotezatu",
                    "image": null,
                    "provider": "linkedin",
                    "data": null,
                    "authorized": true,
                    "created_at": "2024-03-29 09:49:22",
                    "external_url": "https://linkedin.com/feed/update/urn:li:share:43536647554322",
                    "errors": []
                },
                {
                    "id": 1,
                    "uuid": "85347d5e-9724-4cb6-b91c-82d6d6d4e992",
                    "name": "Only Social",
                    "username": "onlysocial",
                    "image": "https://example.com/avatar/onlysocial.jpg",
                    "provider": "facebook_page",
                    "data": {
                        "suffix": {
                            "value": "Page",
                            "edited": false
                        }
                    },
                    "authorized": true,
                    "created_at": "2024-03-27 11:30:45",
                    "external_url": "https://facebook.com/3432042343434323/7179414779038416896",
                    "errors": []
                }
            ],
            "versions": [
                {
                    "account_id": 0,
                    "is_original": true,
                    "content": [
                        {
                            "body": "<div>Optimize your team's social media strategy with Mixpost or launch your SaaS quickly and start generating revenue effortlessly.</div>",
                            "media": [
                                {
                                    "id": "2",
                                    "name": "tea-reduced-file-size.mp4",
                                    "mime_type": "video/mp4",
                                    "type": "video",
                                    "url": "https://app.onlysocial.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7.mp4",
                                    "thumb_url": "https://app.onlysocial.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7-thumb.jpg",
                                    "is_video": true,
                                    "created_at": "2024-03-29 15:33:32"
                                }
                            ],
                            "url": ""
                        }
                    ],
                    "options": {
                        "tiktok": {
                            "privacy_level": {
                                "account-0": null
                            },
                            "allow_comments": {
                                "account-0": false
                            },
                            "allow_duet": {
                                "account-0": false
                            },
                            "allow_stitch": {
                                "account-0": false
                            },
                            "content_disclosure": {
                                "account-0": false
                            },
                            "brand_organic_toggle": {
                                "account-0": false
                            },
                            "brand_content_toggle": {
                                "account-0": false
                            }
                        },
                        "youtube": {
                            "title": null,
                            "status": "public"
                        },
                        "linkedin": {
                            "visibility": "PUBLIC"
                        },
                        "mastodon": {
                            "sensitive": false
                        },
                        "instagram": {
                            "type": "post"
                        },
                        "pinterest": {
                            "title": null,
                            "link": null,
                            "boards": {
                                "account-0": null
                            }
                        },
                        "facebook_page": {
                            "type": "post"
                        }
                    }
                }
            ],
            "tags": [
                {
                    "id": 1,
                    "uuid": "2323e1eb-b3a6-4183-990d-4d5afea04835",
                    "name": "motivation",
                    "hex_color": "#60a5fa"
                }
            ],
            "user": {
                "name": "Dima Botezatu"
            },
            "scheduled_at": "2024-03-29 09:50:56",
            "published_at": "2024-03-29 09:51:10",
            "created_at": "2024-03-29 09:50:46",
            "trashed": false
        }
    ],
    "links": {
        "first": "https://app.onlysocial.io/os/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts?page=1",
        "last": "https://app.onlysocial.io/os/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "https://app.onlysocial.io/os/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "https://app.onlysocial.io/os/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts",
        "per_page": 20,
        "to": 3,
        "total": 3
    }
}
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
Modified at 2024-06-28 15:50:47
Previous
Update a tag
Next
Get a post
Built with