Get a Post

GET

/posts/{postId}

Retrieves detailed information about a specific post by its ID. This endpoint returns the complete post data including all configurations, media, captions, labels, and network-specific settings. Use this to view or edit a single post's details.

Notes

The post must belong to your workspace, otherwise a 404 error will be returned.

Network-specific objects (facebook, instagram, linkedIn, tiktok) only appear in the response when the post is configured for those networks.

Posts can have different captions and media for different social networks - check the net property in each array item.

Use this endpoint to retrieve the current state of a post before updating it with PUT /posts/:postId.

Request

Path Params

Header Params

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.swonkie.dev/v2/posts/UG9zdElkMTIzNDU2Nzg51352' \
--header 'X-API-ID: {{apiId}}' \
--header 'X-API-KEY: {{apiKey}}'

Response Example

{
    "id": "UG9zdElkMTIzNDU2Nzg5",
    "type": "MEDIA",
    "stage": "SCHEDULED",
    "publishAt": "2026-02-01T10:00:00.000Z",
    "budget": 0,
    "profiles": [
        {
            "id": "Tjg3YjhSU2xZREFqM1RqOTRnZTdpZz09",
            "name": "Brand Official Page",
            "username": "brandofficial",
            "picture": "https://storage.example.com/profiles/abc123.jpg",
            "net": {
                "code": "facebook",
                "name": "Facebook"
            },
            "publishStatus": "PENDING"
        },
        {
            "id": "SW5zdGFncmFtSWQxMjM0NTY=",
            "name": "Brand Instagram",
            "username": "brand_insta",
            "picture": "https://storage.example.com/profiles/def456.jpg",
            "net": {
                "code": "instagram",
                "name": "Instagram"
            },
            "publishStatus": "PENDING"
        }
    ],
    "captions": [
        {
            "plainText": "Excited to announce our new product! 🚀 #innovation #tech",
            "net": null,
            "firstComment": {
                "plainText": "Tell us what you think in the comments!"
            }
        }
    ],
    "medias": [
        {
            "id": "TWVkaWFJZDk4NzY1NDMyMQ==",
            "url": "https://storage.example.com/media/product.jpg",
            "type": "image/jpeg",
            "net": null
        }
    ],
    "links": [],
    "labels": [
        {
            "id": "TGFiZWxJZDExMTExMTEx",
            "name": "Product Launch",
            "color": "#FF5733"
        }
    ],
    "facebook": {
        "netLocation": null,
        "carousels": null,
        "carouselEndCard": false
    },
    "instagram": {
        "netLocation": null,
        "shareToFeed": true
    },
    "briefing": {
        "markdown": "# Campaign Brief\n\nThis is a major product launch targeting Q1 2026."
    }
}

Modified at 2026-03-11 19:13:35

List Posts

Create a Post

Get a Post

Notes#

Request

Responses

Notes