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

{
  "id": "clt92k3c1000408l47h5f0b5y",
  "name": "Product",
  "slug": "product",
  "description": "All about product updates.",
  "count": {
    "posts": 8
  },
  "posts": {
    "data": [
      {
        "id": "clt92n38p000108l48zkj41an",
        "title": "Product Update: March 2024",
        "slug": "product-update-march-2024",
        "description": "What's new this month.",
        "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": 8
    }
  }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.marblecms.com/v1/tags/product"

{
  "id": "clt92k3c1000408l47h5f0b5y",
  "name": "Product",
  "slug": "product",
  "description": "All about product updates.",
  "count": {
    "posts": 8
  },
  "posts": {
    "data": [
      {
        "id": "clt92n38p000108l48zkj41an",
        "title": "Product Update: March 2024",
        "slug": "product-update-march-2024",
        "description": "What's new this month.",
        "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": 8
    }
  }
}

​
Authorizations

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

​
Path Parameters

​
identifier
string
required
The tag ID or slug.

​
Query Parameters

​
include
string
Include related data. Use posts to include posts with this tag.
​
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.