v1

latestOpenAPI 3.1.0MIT2026-07-243952451019.0 KB
Blogs::Post

List Blog Posts

List posts for the given blog.

get/blogs/{blog_id}/posts

Path parameters

blog_idinteger required

Query parameters

afterstring

ID of item after which the collection should be returned. More examples and info about pagination in our guides.

sort_order'asc' | 'desc'

Sort order of a list response. Use 'desc' to reverse the default 'asc' (ascending) sort order. Examples in our guides.

sort_property'id' | 'updated_at'

Sort property of a list response. The default is id and thus the created_at order. If you sort by other properties, we additionally sort by id implicitly as a secondary sort property, so that you can rely on the sort order to be deterministic even if the main sort property ends up with the same values.

expand[]string[]

Expand additional data in the response. Use expand[]=markup to include the PML markup for the post's visual content. Markup is opt-in on every endpoint (show, list, create, update) because PML serialization runs per post. See the Expanding guide for available fields and examples.

Response

OK

idinteger

Post ID

public_idstring

The public identifier of the post

blog_idinteger

Blog ID that the post belongs to

titlestring

Title of the post

published_atstring date-time nullable

Date and time the post was published

current_pathstring

The URL path for the post

urlstring

The full public URL of the post

visibility'draft' | 'public' | 'members_only' | 'scheduled'

Visibility status of the post. One of draft, public, members_only, or scheduled.

excerpt_contentstring nullable

Short summary of the blog post

seo_titlestring nullable

SEO page title

seo_descriptionstring nullable

SEO page description

image_idinteger nullable

Featured image ID

image_urlstring nullable

URL of the featured image

markupstring

Expandable The PML (Page Markup Language) representation of the post's visual content. Only returned when expand[]=markup is provided. Empty string when the post has no visual content yet. See the Page Markup Skill for the full DSL reference.

created_atstring date-time

Created at

updated_atstring date-time

Updated at

Example response

[
  {
    "id": 1,
    "public_id": "xYzAbC",
    "blog_id": 1,
    "title": "Getting started with your blog",
    "published_at": "2025-06-01T10:00:00.000Z",
    "current_path": "/blog/getting-started",
    "url": "https://myworkspace.myclickfunnels.com/blog/getting-started",
    "visibility": "public",
    "excerpt_content": "An introduction to what you'll find on this blog.",
    "seo_title": "Getting started with your blog",
    "seo_description": "Learn how to make the most of your new blog.",
    "image_id": 42,
    "image_url": "https://example.myclickfunnels.com/uploads/image/42/file/example.jpg",
    "categories": [
      {
        "name": "Tutorials"
      }
    ],
    "tags": [
      {
        "name": "beginner"
      }
    ],
    "authors": [
      {
        "first_name": "Jane",
        "last_name": "Smith",
        "email_address": "jane@example.com"
      }
    ],
    "created_at": "2025-01-01T00:00:00.000Z",
    "updated_at": "2025-06-01T10:00:00.000Z"
  }
]