Workspace Stats

The Stats API returns aggregate counts for the workspace attached to the API key. Use it for dashboards, landing page counters, public workspace summaries, or lightweight analytics displays.

Endpoint

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

Query Parameters

None right now.

Example Request

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

Example Response

{
  "ok": true,
  "stats": {
    "totalPosts": 12,
    "totalAuthors": 3,
    "totalCategories": 5,
    "totalTags": 9
  }
}

Response Fields

The stats object contains:

• totalPosts (number): number of posts that are both published and visible
• totalAuthors (number): number of authors in the workspace
• totalCategories (number): number of categories in the workspace
• totalTags (number): number of tags in the workspace

Use Cases

• Dashboard Counters: Display workspace metrics on a dashboard
• Landing Page Stats: Show impressive numbers on a marketing page
• Workspace Overview: Provide a quick summary of content volume
• Analytics: Track content growth over time

Example Usage

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

console.log(data.stats.totalPosts);

Related Endpoints

• Posts
• Authors
• Categories
• Tags