PAparagraph-xyz
posts

Get post by ID

Changed on

Retrieve detailed information about a specific post

get/v1/posts/{postId}

Request

  • Base URL
    https://public.api.paragraph.com/api
  • URL
    https://public.api.paragraph.com/api/v1/posts/{postId}
  • Auth
    none required

Path parameters

postIdstring required

Unique identifier of the 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

imageAltstring

Alternative text describing the cover image, shown to screen readers and when the image fails to load

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

canonicalUrlstring uri

Canonical URL used in rendered metadata. This does not change the Paragraph permalink.

publishOnlineboolean

Whether the published post is visible on the public website

communityIdstring

Subscriber segment id selected for newsletter delivery

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.

Changes

  • 8108f2a53d2eRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • a38cc07e90d8Revision changes
    • info

      added the optional property to the response with the status