Skip to main content
GET
/
publisher
/
{publisher_id}
/
posts
Post Listing
curl --request GET \
  --url https://cds.thepublive.com/publisher/{publisher_id}/posts/ \
  --header 'Authorization: Basic <encoded-value>'
{
  "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
}
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.
​
publisher_id
string
required
Your Publisher ID
​
page
integer
default:"1"
Page number (max: 1000)
​
limit
integer
default:"10"
Items per page (max: 50)
​
sort_by
string
default:"created_at"
Field to sort by
​
sort_order
string
default:"desc"
Sort 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.
{
  "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
}