Retrieve Tag

Retrieve a specific blog post tag by slug with tag details and optional recent posts integration.

GET /tags/{slug}

Retrieve Tag

cURL

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

200

basic_tag

{
  "data": {
    "name": "API Development",
    "slug": "api-development"
  }
}

Retrieve a specific blog post tag by its unique slug identifier, providing detailed tag information and optional recent posts integration. Tags provide granular categorization and labeling for blog content, enabling detailed content organization and enhanced discovery capabilities.

Tag Information: The tag object contains the display name (e.g., “API Development”) and URL-friendly slug identifier (e.g., “api-development”) that can be used for building tag-based navigation, content filtering, and topic-specific landing pages.

Recent Posts Integration: Use the include=recent_posts parameter to enrich the response with the tag’s recent blog posts. This adds a recent_posts array containing up to 10 of the most recently published posts tagged with this tag, perfect for creating comprehensive tag pages that showcase both tag information and the latest related content.

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.

Path Parameters

slug · string · required

The unique slug identifier of the tag to retrieve.

Query Parameters

auth_token · string

Your ButterCMS read API token

include · enum<string>

Include additional data in the response.

When set to recent_posts, the tag object will include a recent_posts array containing the latest blog posts tagged with this tag (up to 10 posts, ordered by most recent first).

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

Tag retrieved successfully

Response structure for retrieving a single tag

data · object

Single tag object

Show child attributes