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
}