Tags API

Endpoints for retrieving tags and their associated posts.

GET/tags

Retrieves a list of all tags for your organization.

Response

Returns an array of tag objects.

json

[
  {
    "name": "Next.js",
    "slug": "next-js"
  },
  {
    "name": "Security",
    "slug": "security"
  },
  {
    "name": "Prisma",
    "slug": "prisma"
  }
]

GET/tags/{slug}

Retrieves a single tag and a paginated list of its published posts.

Path Parameters

slugRequiredThe unique slug of the tag.

Query Parameters

pageOptionalPage number for post pagination. Defaults to 1.
limitOptionalNumber of posts per page. Defaults to 10.

Response

Returns an object containing the tag details and a paginated list of posts.

json

{
  "tag": {
    "name": "Security",
    "slug": "security"
  },
  "posts": [
    {
      "title": "Securing Your Next.js App",
      "slug": "securing-next-js",
      "excerpt": "A comprehensive look at best practices for API and app security...",
      "publishedAt": "2025-07-21T14:30:00.000Z",
      "author": { "name": "Security Expert" }
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 10,
    "pages": 1
  }
}