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
​
locale
string

Filter the embedded recent_posts list to posts in the given locale (e.g. en, es). The tag itself is shared across locales and is always returned. When omitted, defaults to your organization's default locale.

Returns 400 if the value is not a locale configured on your organization.

Maximum string length: 10

Response

Tags retrieved successfully

Response structure for listing all tags

​
data
object[]

Array of tag objects