Skip to main content
GET https://cds.thepublive.com/publisher/{publisher_id}/categories/ Returns a paginated list of all categories with their hierarchical structure.

​
Headers

NameTypeRequiredDescription
usernamestringYesAPI Key
passwordstringYesAPI Secret

​
Query Parameters

NameTypeDefaultDescription
pageinteger1Page number (max: 1000)
limitinteger10Items per page (max: 50)

​
Response Fields

Each category contains:
FieldTypeDescription
idintegerUnique category identifier
namestringCategory name
slugstringURL-friendly slug
parent_categoryobject/nullParent category details (if nested)
category_brand_colorstring/nullBrand color (hex)
absolute_urlstringFull public URL path
{
  "status": "ok",
  "data": [
    {
      "id": 100,
      "name": "News",
      "slug": "news",
      "parent_category": null,
      "category_brand_color": "#EF4444",
      "absolute_url": "/news"
    },
    {
      "id": 101,
      "name": "Politics",
      "slug": "politics",
      "parent_category": {
        "id": 100,
        "name": "News",
        "slug": "news"
      },
      "category_brand_color": null,
      "absolute_url": "/news/politics"
    }
  ],
  "message": "",
  "page_no": 1,
  "per_page": 10
}