Get Post Output

Setup

GET https://embed-api.postnitro.ai/post/output/{embedPostId}

Retrieves the generated output for a completed post. Call this once Check Post Status reports the post status as COMPLETED.

Headers

embed-api-key: your-api-key-here (required)

Path Parameters

Parameter	Type	Required	Description
`embedPostId`	string	Yes	ID of the embed post to retrieve

Example Request


curl --location 'https://embed-api.postnitro.ai/post/output/[embed-post-id]' \
--header 'embed-api-key: pn-your-api-key'

Response

The result object always includes designId, name, size, and editorUrl. Rendered artifact fields (type, mimeType, data) are present only for PNG, PDF, and MP4 — a DESIGN response skips rendering, so it omits them.

If the post was initiated with generateImages, the AI images are baked into the design itself — the output shape below is unchanged. Observe them via the rendered file in result.data (PNG/PDF) or by opening result.editorUrl (any response type).

For DESIGN Response Type


{
    "success": true,
    "data": {
        "embedPost": {
            "id": "post123",
            "postType": "CAROUSEL",
            "responseType": "DESIGN",
            "status": "COMPLETED",
            "credits": 4,
            "createdAt": "2025-08-03T13:40:49.098Z",
            "updatedAt": "2025-08-03T13:40:53.425Z"
        },
        "result": {
            "designId": "design123",
            "name": "Welcome to the Carousel!",
            "size": {
                "id": "4:5",
                "dimensions": {
                    "width": 1080,
                    "height": 1350
                }
            },
            "editorUrl": "https://postnitro.ai/app/carousel-maker/<workspace-identifier>/<designId>"
        }
    }
}

For PNG Response Type:


{
    "success": true,
    "data": {
        "embedPost": {
            "id": "post123",
            "postType": "CAROUSEL",
            "responseType": "PNG",
            "status": "COMPLETED",
            "credits": 4,
            "createdAt": "2025-08-03T13:40:49.098Z",
            "updatedAt": "2025-08-03T13:40:53.425Z"
        },
        "result": {
            "designId": "design123",
            "name": "Welcome to the Carousel!",
            "size": {
                "id": "4:5",
                "dimensions": {
                    "width": 1080,
                    "height": 1350
                }
            },
            "editorUrl": "https://postnitro.ai/app/carousel-maker/<workspace-identifier>/<designId>",
            "type": "png",
            "mimeType": "image/png",
            "data": [
                "image_1_from_postnitro.png",
                "image_2_from_postnitro.png",
                "image_3_from_postnitro.png",
                "image_4_from_postnitro.png"
            ]
        }
    }
}

For PDF Response Type:


{
    "success": true,
    "data": {
        "embedPost": {
            "id": "post123",
            "postType": "CAROUSEL",
            "responseType": "PDF",
            "status": "COMPLETED",
            "credits": 4,
            "createdAt": "2025-08-03T13:59:07.502Z",
            "updatedAt": "2025-08-03T13:59:12.181Z"
        },
        "result": {
            "designId": "design123",
            "name": "Welcome to the Carousel!",
            "size": {
                "id": "4:5",
                "dimensions": {
                    "width": 1080,
                    "height": 1350
                }
            },
            "editorUrl": "https://postnitro.ai/app/carousel-maker/<workspace-identifier>/<designId>",
            "type": "pdf",
            "mimeType": "application/pdf",
            "data": "document_from_postnitro.pdf"
        }
    }
}

For MP4 Response Type:

Returned for postType: "VIDEO" posts rendered with responseType: "MP4". data is a single URL to the rendered video.


{
    "success": true,
    "data": {
        "embedPost": {
            "id": "post123",
            "postType": "VIDEO",
            "responseType": "MP4",
            "status": "COMPLETED",
            "credits": 4,
            "createdAt": "2025-08-03T13:59:07.502Z",
            "updatedAt": "2025-08-03T13:59:41.774Z"
        },
        "result": {
            "designId": "design123",
            "name": "3 habits of fast teams",
            "size": {
                "id": "9:16",
                "dimensions": {
                    "width": 1080,
                    "height": 1920
                }
            },
            "editorUrl": "https://postnitro.ai/app/video-maker/<workspace-identifier>/<designId>",
            "type": "mp4",
            "mimeType": "video/mp4",
            "data": "video_from_postnitro.mp4"
        }
    }
}

Rendering a video takes longer than a PNG or PDF — keep polling Check Post Status until the post is COMPLETED.

Result Object Details

Field	Type	Description
`designId`	string	Design ID to be used in the scheduling API call
`name`	string	Design name (from template or “Untitled”)
`size`	object	Design aspect ratio (e.g., “4:5”) and dimensions
`editorUrl`	string	Deep link to open the design in the web editor. Present for all response types. `null` if the workspace or `postType` can’t be resolved
`type`	string	File type in lowercase (“png”, “pdf”, or “mp4”). Omitted for `DESIGN`
`mimeType`	string	MIME type for the file. Omitted for `DESIGN`
`data`	string/array	PNG: Array of URLs (one per slide) PDF: Single URL MP4: Single URL. Omitted for `DESIGN`

`editorUrl` structure


<domain>/app/<editor-type>/<workspace-identifier>/<designId>

<editor-type> is derived from postType:

`postType`	editor type
`IMAGE`	`image-maker`
`CAROUSEL`	`carousel-maker`
`VIDEO`	`video-maker`