Categories
Retrieve all available categories from your Vine workspace
The Categories API returns all categories for the workspace attached to the API key. Use it to build navigation, section pages, content groupings, and CMS-driven filtering UIs.
Endpoint
GET /api/public/v1/{API_KEY}/categoriesQuery Parameters
None right now.
Example Request
curl "https://vinecms.tech/api/public/v1/{API_KEY}/categories"Example Response
{
"ok": true,
"categories": [
{
"id": "category_id",
"name": "Product",
"slug": "product"
}
]
}Response Fields
Each category object contains:
id(string): internal category identifiername(string): display nameslug(string): URL-friendly category slug
Use Cases
- category navigation
- section landing pages
- taxonomy selectors
- content grouping in external apps
Example Usage
const response = await fetch(
'https://vinecms.tech/api/public/v1/{API_KEY}/categories'
);
const data = await response.json();
data.categories.forEach((category) => {
console.log(category.slug, category.name);
});