Skip to main content
GET
/
v1
/
authors
/
:identifier
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.marblecms.com/v1/authors/john-doe"

{
  "id": "clt92f96m000008l4gken6v2t",
  "name": "John Doe",
  "slug": "john-doe",
  "image": "https://cdn.marblecms.com/avatars/john.jpg",
  "bio": "John is a software developer and writer.",
  "role": "Software Developer",
  "socials": [
    { "url": "https://twitter.com/johndoe", "platform": "x" }
  ],
  "count": {
    "posts": 15
  },
  "posts": {
    "data": [
      {
        "id": "clt92n38p000108l48zkj41an",
        "title": "Introducing Marble",
        "slug": "introducing-marblecms",
        "description": "The modern headless CMS.",
        "coverImage": "https://cdn.marblecms.com/images/cover.jpg",
        "publishedAt": "2024-03-05T00:00:00.000Z"
      }
    ],
    "pagination": {
      "limit": 20,
      "currentPage": 1,
      "nextPage": null,
      "previousPage": null,
      "totalPages": 1,
      "totalItems": 15
    }
  }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.marblecms.com/v1/authors/john-doe"

{
  "id": "clt92f96m000008l4gken6v2t",
  "name": "John Doe",
  "slug": "john-doe",
  "image": "https://cdn.marblecms.com/avatars/john.jpg",
  "bio": "John is a software developer and writer.",
  "role": "Software Developer",
  "socials": [
    { "url": "https://twitter.com/johndoe", "platform": "x" }
  ],
  "count": {
    "posts": 15
  },
  "posts": {
    "data": [
      {
        "id": "clt92n38p000108l48zkj41an",
        "title": "Introducing Marble",
        "slug": "introducing-marblecms",
        "description": "The modern headless CMS.",
        "coverImage": "https://cdn.marblecms.com/images/cover.jpg",
        "publishedAt": "2024-03-05T00:00:00.000Z"
      }
    ],
    "pagination": {
      "limit": 20,
      "currentPage": 1,
      "nextPage": null,
      "previousPage": null,
      "totalPages": 1,
      "totalItems": 15
    }
  }
}

​
Authorizations

​
Authorization
string
required
Your Marble API key. Include it in the header as: Bearer YOUR_API_KEY

​
Path Parameters

​
identifier
string
required
The author ID or slug.

​
Query Parameters

​
include
string
Include related data. Use posts to include the author’s posts.
​
limit
integer
default:"20"
When include=posts, the maximum number of posts to return.
​
page
integer
default:"1"
When include=posts, the page of posts to return.