BizKitHub
DocsAPI ReferencePost Category/bff/post-category/detail
getPost CategoryAdmin BFF

/bff/post-category/detail

Returns full detail of a post category including title, description, meta description, slug, parent info, post count, and all available translations.

Post CategorygetBffPost-categoryDetail

Parameters

2 query

Query parameters

· 2
idstringRequired

Category external ID.

Exampleabc123def456ghij
localestringOptional

Communication locale code — controls the language of textual data (product names, descriptions, articles, storefront UI, transactional e-mails).

Preferred format: BCP 47 language tag — language[-Script][-REGION]. Use the full tag whenever the script or region matters:

  • en-GB vs. en-US (British vs. American spelling)
  • pt-PT vs. pt-BR (European vs. Brazilian Portuguese)
  • zh-Hans vs. zh-Hant (Simplified vs. Traditional Chinese)
  • sr-Latn vs. sr-Cyrl (Latin vs. Cyrillic Serbian)

Backwards-compatible fallback: the bare two-letter ISO 639-1 code (cs, en, pl, …) is accepted indefinitely — legacy clients that only send the language subtag continue to work unchanged.

Resolution algorithm (server-side): the input is resolved against the supported locale list via the [RFC 4647 Lookup] progressive-fallback strategy — trailing subtags are stripped one by one until a supported locale is found. Example: en-GB-oxendict → en-GB → en (matched). If no subtag combination is supported, the request is rejected.

Currently supported locales: cs, en, fr, it, pl, de, sk, sv, es, zh, ja, uk, da, hu, ro, nl, pt, fi, nb, hr. Region-specific variants (e.g. en-GB, pt-BR) are accepted and resolved to their base language when the exact variant is not registered separately.

Length: 2–35
Examplecs

Response schema

1 status code documented

200Success
idstringRequired

Category external ID.

Exampleabc123def456ghij
titlestringRequired

Localized category name.

ExampleTech News
descriptionstringRequired

Category description.

ExampleLatest technology news and updates.
metaDescriptionstringRequired

SEO meta description.

ExampleTech news, tutorials, and insights.
slugstringRequired

URL slug.

Exampletech-news
parentIdstringOptional

Parent category external ID.

Exampleabc123def456ghij
parentTitlestringOptional

Parent category name.

ExampleTechnology
activebooleanRequired

Whether the category is active.

Exampletrue
insertedDateDate | string | string | numberRequired

When the category was created.

One of 4:
Variant 1
Date

When the category was created.

Variant 2
stringdate-time
Variant 3
stringdate
Variant 4
number
postCountnumberRequired

Number of posts in this category.

Example42
translationsobject[]Required

All available locale translations for this category.

Each array item:
localestringRequired

Locale code (e.g. "cs", "en").

Exampleen
namestringRequired

Category name in this locale.

ExampleTech News

Response example

application/json
{
  "id": "abc123def456ghij",
  "title": "Tech News",
  "description": "Latest technology news and updates.",
  "metaDescription": "Tech news, tutorials, and insights.",
  "slug": "tech-news",
  "parentId": "abc123def456ghij",
  "parentTitle": "Technology",
  "active": true,
  "postCount": 42,
  "translations": [
    {
      "locale": "en",
      "name": "Tech News"
    }
  ]
}

Request example

GET /bff/post-category/detail

get
curl -X GET "https://api.bizkithub.com/bff/post-category/detail?id=abc123def456ghij&locale=cs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key