Posts
List posts
Get many posts
Request
- Method: GET
- URL:
https://app.socialk.it/core/api/<workspaceUuid>/posts - Authorization:
Bearer <token>
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | integer | 50 | Max number of results to return |
page | integer | 1 | Page number for pagination |
status | string | Filter by status: draft, failed, needs_approval, trash, published, scheduled | |
keyword | string | Filter posts by keyword in content | |
accounts | string | Filter posts by account IDs (comma-separated) | |
tags | string | Filter posts by tags (comma-separated) |
Response
{
"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": "SocialKit User",
"username": "socialkitUse3",
"image": "https://example.com/avatar/user.jpg",
"provider": "twitter",
"data": null,
"authorized": true,
"created_at": "2024-03-29 09:55:31",
"external_url": "https://example.com/socialkitUse3/post/123",
"errors": []
}
],
"versions": [
{
"account_id": 0,
"is_original": true,
"content": [
{
"body": "<div>Create your dream SaaS easily with SocialKit! 💻✨</div>",
"media": [
{
"id": "1",
"name": "blue.png",
"mime_type": "image/png",
"type": "image",
"url": "https://app.socialk.it/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi.png",
"thumb_url": "https://app.socialk.it/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": "SocialKit User"
},
"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": "SocialKit User",
"username": "socialkitUse4",
"image": null,
"provider": "linkedin",
"data": null,
"authorized": true,
"created_at": "2024-03-29 09:49:22",
"external_url": "https://example.com/feed/update/id",
"errors": []
},
{
"id": 1,
"uuid": "85347d5e-9724-4cb6-b91c-82d6d6d4e992",
"name": "SocialKit",
"username": "getsocialkit",
"image": "https://example.com/avatar/socialkit.jpg",
"provider": "facebook_page",
"data": {
"suffix": {
"value": "Page",
"edited": false
}
},
"authorized": true,
"created_at": "2024-03-27 11:30:45",
"external_url": "https://example.com/id",
"errors": []
}
],
"versions": [
{
"account_id": 0,
"is_original": true,
"content": [
{
"body": "<div>Optimize your team's social media strategy with SocialKit 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.socialk.it/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7.mp4",
"thumb_url": "https://app.socialk.it/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": "SocialKit User"
},
"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.socialk.it/core/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts?page=1",
"last": "https://app.socialk.it/core/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": "« Previous",
"active": false
},
{
"url": "https://app.socialk.it/core/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "https://app.socialk.it/core/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts",
"per_page": 20,
"to": 3,
"total": 3
}
}