The Content Delivery Service (CDS) provides read-only access to your published content. Use these APIs to power your website, mobile app, or any frontend application.
Base URL: https://cds.thepublive.com/publisher/{publisher_id}/
All CDS endpoints are GET requests. Authentication requires HTTP Basic Auth.
Site Configuration
| Endpoint | Description |
|---|
| Publisher Data | Publisher profile, branding, and configuration |
| Navbar | Navigation menu structure |
| Footer | Footer configuration and links |
| Active Slots | Advertisement slot configuration |
| Newsletter Groups | Newsletter group listings |
| Content Types | Available content types |
Content
| Endpoint | Description |
|---|
| Identify content | Resolve a path to the matching entity type |
| Category Listing | List all categories |
| Category Details | Get a single category by ID or slug |
| Tag Listing | List all tags |
| Tag Details | Get a single tag by ID or slug |
| Author Listing | List all authors |
| Author Details | Get a single author by ID or slug |
Posts
| Endpoint | Description |
|---|
| Post Listing | List and filter posts with advanced queries |
| Post Details | Get a single post by ID or slug |
| Post Details by URL | Get a post by its legacy/relative URL |
| Live Blog Updates | Get live blog update entries for a post |
Static Files
| Endpoint | Description |
|---|
| ads.txt | Publisher’s ads.txt file |
| robots.txt | Publisher’s robots.txt file |
| service-worker.js | Push notification service worker script |
| Push Notification HTML | iZooto permission UI HTML files |
Sitemaps
| Endpoint | Description |
|---|
| All-content Sitemap | Master sitemap index for all content |
| Web Content Sitemap | Index linking to paginated article sitemaps |
| News Sitemap | Google News sitemap |
| Category Sitemap | Sitemap of all category pages |
| Web Story Sitemap | Index linking to paginated web story sitemaps |
| Paginated Sitemaps | Date-stamped article and web story sitemap pages |
All list endpoints support pagination:
| Parameter | Type | Default | Max |
|---|
page | integer | 1 | 1000 |
limit | integer | 10 | 50 |