List blog posts
Tool ID: kocodesk_blog_posts_list
Summary
List the blog posts on your site, newest first, with optional search and paging.
When to use it
- To find a post before editing it.
- To review what has been published recently.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| KocoDesk credentials | Yes |
| Blog plugin enabled for the site | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
q |
No | Search words in the title, slug or teaser. |
page |
No | Page number (default 1). |
per_page |
No | Results per page, 1 to 100 (default 50). |
language |
No | Language to read titles in (default is the primary language). |
What you get back
For each post: id, title, slug, teaser, publish date, featured and hidden flags, category ids, and whether a translation exists. The response also tells you the total number of posts so your assistant can page through them.
Example prompts
List my most recent blog posts.
Find the blog post about the spring product launch.
Show me all hidden or unpublished blog posts.
Tips
- The ids returned here are the ones to use with every other blog tool.
- Both published and hidden posts are listed; check the
hiddenflag and publish date to tell them apart.