/api/v1/post/category

Returns category detail with child categories, breadcrumb, post feed, and routing info. Returns an error object if the category does not exist.

Endpoint Info

Base URLapi.bizkithub.com

AuthBearer Token

Methods1

Authentication Required

This endpoint requires a valid API key passed as a query parameter or Bearer token.

Get your API key

Parameters

4 query parameters

apiKeystringrequired

Your BizKitHub API key (passed as GET parameter).

Key format: A 32-character string matching: ^(PROD|DEV_|ROOT)[A-Za-z0-9]{28}$
Prefixes: PROD (production key), DEV_ (individual developer), ROOT (system key with no limits). Learn more

slugstringrequired

localestringrequired

Communication locale code used to filter content.

Supported locales: cs, en, fr, it, pl, de, sk, sv, es, zh, ja, uk, da.

Length: 2 - 2

identityIdstring

Logged user identity (from your frontend cookies). Learn more

Example Request

JavaScript fetch

const response = await fetch("https://api.bizkithub.com/api/v1/post/category?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&slug=novinky&locale=cs&identityId=Z9CPkS2o3UV163VQn5OUv0T8BQi8Fvdg", {
  method: "GET",
  headers: {
    "Content-Type": "application/json"
  }
});

const data = await response.json();
console.log(data);

get

Example Response

200Success

{
  "name": "Novinky",
  "description": "Nejnovější zprávy a aktuality ze světa kyberbezpečnosti.",
  "route": {
    "slug": "Novinky",
    "locale": "cs",
    "canonical": false
  },
  "routes": [
    {
      "slug": "novinky",
      "locale": "cs"
    }
  ],
  "children": [
    {
      "slug": "example_slug",
      "name": "example_name",
      "description": "example_description",
      "postCount": 0
    }
  ],
  "breadcrumb": [
    {
      "name": "Novinky",
      "slug": "novinky",
      "children": []
    }
  ],
  "postFeed": [
    {
      "slug": "kyber-cena-roku-2025-nejvetsi-vecer-ceske-kyberbezpecnosti-letos",
      "title": "KYBER CENA ROKU 2025: největší večer české kyberbezpečnosti letošního roku.",
      "content": "Žijeme ve světě, kde je..."
    }
  ],
  "parent": {
    "name": "example_name",
    "slug": "example_slug"
  }
}

cURL

Command line example

curl -X GET "https://api.bizkithub.com/api/v1/post/category?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&slug=novinky&locale=cs&identityId=Z9CPkS2o3UV163VQn5OUv0T8BQi8Fvdg" \
  -H "Content-Type: application/json"

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key

Back to API Documentation API Reference