List All Tags

Retrieve a complete list of blog post tags with optional recent post data for tag-based navigation.

GET /tags

List All Tags

cURL

curl --request GET \
  --url https://api.buttercms.com/v2/tags/ \
  --header 'Authorization: <api-key>'

200

basic_tags

{
  "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

readTokenAuthHeaderreadTokenAuthQuery

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

200

application/json

Tags retrieved successfully

Response structure for listing all tags

data · object[]

Array of tag objects

Show child attributes