Skip to main content
GET
/
v1
/
posts
/
{identifier}
Get post
curl --request GET \
  --url https://api.marblecms.com/v1/posts/{identifier} \
  --header 'Authorization: <api-key>'
{
  "post": {
    "id": "cryitfjp5678mn09qrstuvwx",
    "slug": "getting-started-with-nextjs",
    "title": "Getting Started with Next.js",
    "content": "<p>Hello world</p>",
    "featured": false,
    "coverImage": "https://media.marblecms.com/cover.jpg",
    "description": "A beginner's guide to Next.js",
    "publishedAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-16T12:00:00Z",
    "attribution": {
      "author": "John Doe",
      "url": "https://original-source.com/article"
    },
    "authors": [
      {
        "id": "cryitfjp1234jl04vdnycek8",
        "name": "John Doe",
        "image": "https://media.marblecms.com/avatar.jpg",
        "bio": "Technical writer and developer",
        "role": "Editor",
        "slug": "john-doe",
        "socials": [
          {
            "url": "https://twitter.com/johndoe",
            "platform": "twitter"
          }
        ]
      }
    ],
    "category": {
      "id": "cryitfjp1234jl04vdnycek8",
      "name": "Technology",
      "slug": "technology",
      "description": "Tech news and tutorials"
    },
    "tags": [
      {
        "id": "cryitfjp1234jl04vdnycek8",
        "name": "JavaScript",
        "slug": "javascript",
        "description": "JavaScript tutorials"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Your Marble API key

Path Parameters

​
identifier
string
required

Post ID or slug

Example:

"my-post-slug"

Query Parameters

​
format
enum<string>

Content format (html or markdown)

Available options:
html,
markdown
Example:

"html"

​
status
enum<string>
default:published

Filter by post status. Use 'published' for live posts, 'draft' for unpublished posts, or 'all' for both.

Available options:
published,
draft,
all
Example:

"published"

Response

The requested post

​
post
object
required