Sign in

v52

OpenAPI 3.1.0MITraw.githubusercontent.com2026-07-21450373.3 KB
posts

Get post by publication slug and post slug

Retrieve a post using its publication's slug and the post's slug. This is useful for building user-facing URLs.

get/v1/publications/slug/{publicationSlug}/posts/slug/{postSlug}

Path parameters

publicationSlugstring required

URL-friendly identifier of the publication, e.g. 'blog'

postSlugstring required

URL-friendly identifier of the post, e.g. 'my-first-post'

Query parameters

boolean
OR
string

Include full content fields (markdown, json, staticHtml). Default: false

Response

Post details retrieved successfully

idstring required

Unique identifier for the post

titlestring required

Title of the post

imageUrlstring uri

Optional URL to the post's main image

publishedAtstring

Epoch timestamp when the post was published

updatedAtstring

Epoch timestamp when the post was last updated

subtitlestring

Optional subtitle or brief summary

slugstring required

URL-friendly identifier for the post; accessible at paragraph.com/@[publicationSlug]/[slug]

staticHtmlstring

Rendered HTML content of the post

jsonstring

TipTap JSON representation of the post content structure. This is the source of truth that the staticHtml and markdown is generated from

markdownstring

Markdown source of the post content

coinIdstring

ID of the associated coin, if the post is coined

categoriesstring[]

Categories/tags associated with this post

authorIdsstring[]

IDs of the authors of this post

viewsnumber

Total views. Only included when fetching your own posts via GET /v1/posts

status'published' | 'draft' | 'scheduled' | 'archived'

Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state — publishedAt is preserved across unpublishing.