Skip to main content
GET
/
tags
List All Tags
curl --request GET \
  --url https://api.buttercms.com/v2/tags/ \
  --header 'Authorization: <api-key>'
{
  "data": [
    {
      "name": "test tag",
      "slug": "test-tag"
    },
    {
      "name": "API Development",
      "slug": "api-development"
    },
    {
      "name": "Tutorial",
      "slug": "tutorial"
    },
    {
      "name": "Best Practices",
      "slug": "best-practices"
    },
    {
      "name": "JavaScript",
      "slug": "javascript"
    }
  ]
}
Retrieve a complete list of all blog post tags in your organization, providing granular categorization and labeling information for your blog content. This endpoint is essential for building tag-based navigation, content discovery features, and detailed content organization systems. Tag Information: Returns the tag name and URL-friendly slug for each tag that contains published posts. Tags offer more granular content categorization than categories, allowing for detailed topical organization and improved content discoverability. Recent Posts Integration: Use the include=recent_posts parameter to enrich the response with each tag’s most recent blog posts. This is particularly useful for creating tag cloud interfaces, topic-based landing pages, and tag archive pages that showcase recent activity for specific topics.

Authorizations

​
Authorization
string
header
required

Set the Authorization header to Token your_read_api_token.

Example: Authorization: Token abc123def456

Note: The header value includes the Token prefix.

You can access your API token from your settings page.

Query Parameters

​
auth_token
string

Your ButterCMS read API token

​
include
enum<string>

Include additional data in the response.

When set to recent_posts, each tag object will include a recent_posts array containing the latest blog posts tagged with that tag.

Available options:
recent_posts

Response

Tags retrieved successfully

Response structure for listing all tags

​
data
object[]

Array of tag objects