Skip to main content
GET https://cds.thepublive.com/publisher/{publisher_id}/posts/ Returns a paginated list of published posts with support for advanced filtering, sorting, and search. This is the primary endpoint for fetching content on your frontend.

​
Headers

NameTypeRequiredDescription
usernamestringYesAPI Key
passwordstringYesAPI Secret

​
Query Parameters

NameTypeDefaultDescription
pageinteger1Page number (max: 1000)
limitinteger10Items per page (max: 50)
sort_bystringcreated_atField to sort by
sort_orderstringdescSort direction: asc or desc

​
Advanced Filtering

Append operator suffixes to filterable fields to build queries:
OperatorDescriptionExample
__eqEqualstype__eq=Article
__neqNot equalstype__neq=Video
__containsContains substringtitle__contains=election
__inIn list (comma-separated)type__in=Article,Video
__ninNot in listtype__nin=Gallery,LiveBlog
__gteGreater than or equalcreated_at__gte=2026-01-01
__lteLess than or equalcreated_at__lte=2026-12-31
__gtGreater thanword_count__gt=500
__ltLess thanword_count__lt=2000
Filterable Fields:
FieldDescription
titlePost title
typePost type (Article, Video, Web Story, Gallery, LiveBlog, CustomPage, BlankPage)
categories.idCategory ID
tags.idTag ID
contributors.idAuthor/contributor ID
primary_category.idPrimary category ID

​
Filter Examples

# Get all articles
/posts/?type__eq=Article

# Get posts in a specific category
/posts/?categories.id__eq=100

# Get posts by a specific author
/posts/?contributors.id__eq=5

# Search posts by title
/posts/?title__contains=budget

# Combine filters: articles in category, sorted by title
/posts/?type__eq=Article&primary_category.id__eq=100&sort_by=title&sort_order=asc
Tip: This endpoint replaces several deprecated endpoints. Use filters instead of /posts_by_category/, /posts_by_tag/, /posts_by_author/, and /search/. See Deprecated Endpoints.

​
Response Fields

Each post contains:
FieldTypeDescription
idintegerUnique post identifier
titlestringPost headline
slugstringURL-friendly slug
typestringPost type
banner_urlstringFeatured image URL
short_descriptionstringSummary / meta description
summarystringPost summary below title
primary_categoryobjectPrimary category (id, name, slug)
categoriesarrayAll assigned categories
tagsarrayAssigned tags
contributorsarrayAuthors/contributors
content_htmlstringFull HTML content
content_jsonarrayStructured content blocks
meta_dataobjectSEO, access type, schema data
media_file_bannerobjectBanner media details (id, filename, path, alt_text, meta_data)
word_countintegerArticle word count
access_typestringFree or Paid
language_codestringContent language code
blog_updatearrayLive blog updates (for LiveBlog type)
custom_entityobject/nullCustom entity data
hide_banner_imagebooleanWhether banner image is hidden
banner_descriptionstringBanner image caption
absolute_urlstringFull public URL path
formatted_first_published_at_datetimestringFirst published timestamp
formatted_last_published_at_datetimestringLast published timestamp
{
  "status": "ok",
  "data": [
    {
      "id": 12345,
      "title": "Union Budget 2026 Highlights",
      "slug": "union-budget-2026-highlights",
      "type": "Article",
      "banner_url": "https://cdn.publive.com/images/budget-2026.jpg",
      "short_description": "Key takeaways from the Union Budget 2026",
      "summary": "Here are the major announcements from the budget session.",
      "primary_category": {
        "id": 100,
        "name": "Business",
        "slug": "business"
      },
      "categories": [
        {"id": 100, "name": "Business", "slug": "business"},
        {"id": 101, "name": "Economy", "slug": "economy"}
      ],
      "tags": [
        {"id": 500, "name": "Budget 2026", "slug": "budget-2026"},
        {"id": 501, "name": "Finance", "slug": "finance"}
      ],
      "contributors": [
        {"id": 1, "name": "Jane Doe", "slug": "jane-doe"}
      ],
      "content_html": "<p>The Union Budget 2026 was presented today...</p>",
      "meta_data": {
        "access_type": "Free"
      },
      "media_file_banner": {
        "id": 999,
        "filename": "budget-2026.jpg",
        "path": "https://cdn.publive.com/images/budget-2026.jpg",
        "alt_text": "Union Budget 2026",
        "meta_data": {"width": 1200, "height": 630}
      },
      "word_count": 1250,
      "access_type": "Free",
      "hide_banner_image": false,
      "banner_description": "Budget session in Parliament",
      "language_code": "en",
      "custom_entity": null,
      "absolute_url": "/business/union-budget-2026-highlights-12345",
      "formatted_first_published_at_datetime": "2026-02-01T09:00:00Z",
      "formatted_last_published_at_datetime": "2026-02-01T12:30:00Z"
    }
  ],
  "message": "",
  "page_no": 1,
  "per_page": 10
}