Skip to main content
This page explains the fundamental building blocks of Publive’s content architecture.

​
Content Entities

​
Posts

Posts are the primary content entity in Publive. Each post represents a piece of content (article, video, gallery, etc.) with associated metadata. Post Types:
TypeDescription
ArticleStandard text-based article
VideoVideo content with embedded player
Web StoryVisual story format
GalleryImage gallery
LiveBlogReal-time live blog with updates
CustomPageCustom page layout
BlankPageBlank page template
Post Statuses:
StatusDescription
DraftWork in progress, not published
PublishedLive and publicly accessible
ScheduledWill be published at a future date/time
Approval PendingSubmitted for review in maker-checker workflow

​
Categories

Categories provide hierarchical organization for your content. Every post must have a primary_category to be published. Categories support parent-child relationships for nested navigation. Key fields: name, english_name, slug, parent_category, child_categories, category_brand_color, SEO metadata.

​
Tags

Tags provide flat, cross-cutting labels for content. Unlike categories, tags have no hierarchy. Posts can have multiple tags for flexible content discovery. Key fields: name, english_name, slug, SEO metadata.

​
Authors (Contributors)

Authors represent content creators. Posts reference authors through the contributors field, which accepts comma-separated author IDs. Key fields: name, slug, email, description, social media links (linkedin, twitter, instagram, facebook), avatar.

​
Media Library

The Media Library stores all media assets (images, videos, files) used across your content. Media items are referenced by ID in post fields like banner_url. Key fields: filename, path (URL), alt_text, caption, source, type (Image/Video/File), meta_data (dimensions).

​
Two APIs, Two Purposes

​
Content Delivery Service (CDS)

Base URL: https://cds.thepublive.com/publisher/{publisher_id}/ Read-only API for your frontend. Use this to:
  • Fetch published posts, categories, tags, and authors
  • Power your website navigation (navbar, footer)
  • Query content with advanced filters (__eq, __contains, __in, __gte, etc.)

​
Content Management Service (CMS)

Base URL: https://cms.thepublive.com/publisher/{publisher_id}/ Full CRUD API for managing content. Use this to:
  • Create, update, and delete posts, categories, tags, and media
  • Manage content workflows and publishing states
  • Integrate with your editorial tools and automation pipelines

​
Pagination

Both APIs support pagination with these query parameters:
ParameterTypeDefaultMaxDescription
pageinteger11000Page number
limitinteger1050Items per page
Paginated responses include: 
{
  "count": 245,
  "next": "https://cms.thepublive.com/publisher/123/category/?page=2&limit=10",
  "previous": null,
  "results": [...]
}

​
Response Format

​
CDS API Responses

{
  "status": "ok",
  "data": [...],
  "message": "",
  "page_no": 1,
  "per_page": 10,
  "Cache-Tags": ["PA.123", "CAT.456"]
}

​
CMS API Responses

{
  "count": 100,
  "next": "...?page=2",
  "previous": null,
  "results": [...]
}

​
Cache Tags (CDS)

CDS responses include Cache-Tags for CDN cache invalidation:
Tag FormatEntity
PA.{id}Publisher
CAT.{id}Category
TAG.{id}Tag
MEM.{id}Author/Member
PP.{id}Post