Skip to main content
GET
/
publisher
/
{publisher_id}
/
categories
Category Listing
curl --request GET \
  --url https://cds.thepublive.com/publisher/{publisher_id}/categories/ \
  --header 'Authorization: Basic <encoded-value>'
{
  "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
}
Returns a paginated list of all categories with their hierarchical structure.
​
publisher_id
string
required
Your Publisher ID
​
page
integer
default:"1"
Page number (max: 1000)
​
limit
integer
default:"10"
Items per page (max: 50)
{
  "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
}
Last modified on April 13, 2026