List Posts
Lists posts in Ghost.
This node is also exposed as an AI Agent tool.
This node has 1 input port and 1 output port.
Common Properties
Every node shares these.
- Name — the node's display name on the canvas.
- Color — the node's colour on the canvas.
- Delay Before (sec) — wait this long before the node runs.
- Delay After (sec) — wait this long after the node runs.
- Continue On Error — carry on instead of failing the flow. Defaults to false.
info
When Continue On Error is true the error is not raised at all, so a Catch node will not see it either.
Inputs
| Property | Field | Description |
|---|---|---|
| Client ID | inClientID | Client ID from Connect node |
Outputs
| Property | Field | Description |
|---|---|---|
| Pagination | outPagination | Pagination metadata (page，pages，total，limit) |
| Posts | outPosts | Array of post objects |
Options
| Property | Field | Description |
|---|---|---|
| Content Format | optFormats | Content format to return One of: html, mobiledoc, html.mobiledoc. |
| Credentials | optCredentials | Ghost Admin API credentials |
| Filter | optFilter | Ghost filter expression (e.g. tag:news+featured:true) |
| Include | optInclude | Related data to include One of: NONE, authors, tags, authors.tags. |
| Limit | optLimit | Number of posts per page (max 100) |
| Order | optOrder | Sort order (e.g. published_at DESC) |
| Page | optPage | Page number for pagination |
| Status | optStatus | Filter by post status One of: ALL, draft, published, scheduled. |
Requirements
- A Client ID from this package's Connect node, unless you set credentials directly on this node.
- Ghost Admin API Key — Admin API key for Ghost CMS authentication
url— Site URL (text, required). Your Ghost site URL (without trailing slash)value— Admin API Key (password, required). Admin API key in id:secret format from Ghost Admin > Integrations
Store these in a Vault and reference the vault item from the node, rather than typing the secret into the property.
Related nodes
Create Post · Get Post · Update Post · Delete Post
Elsewhere in the package: Connect · Disconnect · Create Page · Get Page · List Pages · Update Page · Delete Page · Create Member · Get Member · List Members and 6 more
See also
- Ghost — every node in this package
- Message object — how properties read values from
msg - Handling failure — Continue On Error, Catch and retries