Skip to main content
GET
/
tags
/
{slug}
Retrieve Tag
curl --request GET \
  --url https://api.buttercms.com/v2/tags/{slug}/ \
  --header 'Authorization: <api-key>'
{
  "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

​
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

Response

Tag retrieved successfully

Response structure for retrieving a single tag

​
data
object

Single tag object