Tags

The Tags API returns all tags for the workspace attached to the API key. Use it to build tag clouds, topic navigation, search facets, or external taxonomy tooling.

Endpoint

GET https://vinecms.tech/api/public/v1/{API_KEY}/tags

Query Parameters

None right now.

Example Request

curl "https://vinecms.tech/api/public/v1/{API_KEY}/tags"

Example Response

{
  "ok": true,
  "tags": [
    {
      "id": "tag_id",
      "name": "Updates",
      "slug": "updates"
    }
  ]
}

Response Fields

Each tag object contains:

• id (string): internal tag identifier
• name (string): display name
• slug (string): URL-friendly tag slug

Use Cases

• Tag Clouds: Display all tags with post counts
• Filter Menus: Build dropdown or checkbox filters for posts
• Navigation: Create tag-based navigation links
• Search: Use tags to enhance search functionality

Example Usage

const response = await fetch(
  'https://vinecms.tech/api/public/v1/{API_KEY}/tags'
);
const data = await response.json();

data.tags.forEach((tag) => {
  console.log(`${tag.name} (${tag.slug})`);
});

Related Endpoints

• Posts
• Categories