curl "https://api.marblecms.com/v1/cm6ytuq9x0000i803v0isidst/posts"

{
  "posts": [
    {
      "id": "clt92n38p000108l48zkj41an",
      "slug": "introducing-marblecms",
      "title": "Introducing MarbleCMS",
      "content": "...",
      "description": "The modern headless CMS for modern web applications.",
      "coverImage": "...",
      "publishedAt": "2024-03-05T00:00:00.000Z",
      "authors": [
        {
          "id": "clt92f96m000008l4gken6v2t",
          "name": "John Doe",
          "image": "..."
        }
      ],
      "category": {
        "id": "clt92hrnp000208l43kbo28d0",
        "name": "Announcements",
        "slug": "announcements"
      },
      "tags": [
        {
          "id": "clt92k3c1000408l47h5f0b5y",
          "name": "Product",
          "slug": "product"
        }
      ],
      "attribution": null
    }
  ],
  "pagination": {
    "limit": 10,
    "currentPage": 1,
    "previousPage": null,
    "nextPage": 2,
    "totalPages": 13,
    "totalItems": 125
  }
}

curl "https://api.marblecms.com/v1/cm6ytuq9x0000i803v0isidst/posts"

{
  "posts": [
    {
      "id": "clt92n38p000108l48zkj41an",
      "slug": "introducing-marblecms",
      "title": "Introducing MarbleCMS",
      "content": "...",
      "description": "The modern headless CMS for modern web applications.",
      "coverImage": "...",
      "publishedAt": "2024-03-05T00:00:00.000Z",
      "authors": [
        {
          "id": "clt92f96m000008l4gken6v2t",
          "name": "John Doe",
          "image": "..."
        }
      ],
      "category": {
        "id": "clt92hrnp000208l43kbo28d0",
        "name": "Announcements",
        "slug": "announcements"
      },
      "tags": [
        {
          "id": "clt92k3c1000408l47h5f0b5y",
          "name": "Product",
          "slug": "product"
        }
      ],
      "attribution": null
    }
  ],
  "pagination": {
    "limit": 10,
    "currentPage": 1,
    "previousPage": null,
    "nextPage": 2,
    "totalPages": 13,
    "totalItems": 125
  }
}

​
Query Parameters

Use query parameters to paginate, sort, and filter the results.
​
limit
integer | "all"
default:"10"
Maximum number of items to return. Use all to return all posts in a single response.
​
page
integer
default:"1"
Page number to return. Applicable when limit is set to a number.
​
order
string
default:"desc"
Sort order by publishedAt. Accepted values: asc, desc.
​
category
string
Filter by category slug.
​
tags
string
Comma-separated list of tag slugs to filter by, e.g. tags=product,engineering.
​
query
string
Full-text search across title and content.
Responses include a pagination object with limit, currentPage, previousPage, nextPage, totalPages, and totalItems. For advanced usage and error cases (like invalid page numbers), see the full guide on Pagination.