Skip to main content
GET https://cds.thepublive.com/publisher/{publisher_id}/category/{identifier}/ Returns detailed information about a single category, including SEO metadata, Open Graph tags, and child categories.

​
Path Parameters

NameTypeDescription
identifierstring/integerCategory ID or slug

​
Headers

NameTypeRequiredDescription
usernamestringYesAPI Key
passwordstringYesAPI Secret

​
Response Fields

FieldTypeDescription
idintegerUnique category identifier
namestringCategory name
slugstringURL-friendly slug
contentstringCategory description (HTML)
category_brand_colorstring/nullBrand color (hex)
child_categoriesarrayList of child category objects
parent_categoryobject/nullParent category details
meta_titlestringSEO meta title
meta_descriptionstringSEO meta description
og_titlestringOpen Graph title
og_descriptionstringOpen Graph description
og_imagestringOpen Graph image URL
twitter_titlestringTwitter Card title
twitter_descriptionstringTwitter Card description
twitter_imagestringTwitter Card image URL
absolute_urlstringFull public URL path
{
  "status": "ok",
  "data": {
    "id": 100,
    "name": "News",
    "slug": "news",
    "content": "<p>Latest news and updates</p>",
    "category_brand_color": "#EF4444",
    "child_categories": [
      {
        "id": 101,
        "name": "Politics",
        "slug": "politics"
      },
      {
        "id": 102,
        "name": "Business",
        "slug": "business"
      }
    ],
    "parent_category": null,
    "meta_title": "News - My Publication",
    "meta_description": "Latest news and breaking stories",
    "og_title": "News - My Publication",
    "og_description": "Latest news and breaking stories",
    "og_image": "https://cdn.publive.com/images/news-og.jpg",
    "twitter_title": "News - My Publication",
    "twitter_description": "Latest news and breaking stories",
    "twitter_image": "https://cdn.publive.com/images/news-twitter.jpg",
    "absolute_url": "/news"
  },
  "message": ""
}