API reference/Blog
List blog posts
Try itA site's blog posts, newest first. status=draft or status=published narrows it.
GET
/api/v1/sites/{site_id}/postsAuthentication
An API key as Authorization: Bearer or x-api-key. It needs the blog:read scope — read blog posts and topics.
blog:readRead onlyMCP tool: list_posts
Parameters
Named placeholders go in the path; the rest in the query string.
site_idstringPath · required- The site's id.1 to 100 characters
statusstringQuery · optional- One of: draft, published
limitintegerQuery · optional- How many to return (1–100).1 to 100Default
50 cursorstringQuery · optional- next_cursor from the previous page.1 to 100 characters
Response
200 with JSON on success (schema on the right). Errors use the standard envelope.
curl -X GET 'https://websites.workflowcorp.com/api/v1/sites/SITE_ID/posts' \
-H "Authorization: Bearer $WEBSITEBUDDY_API_KEY"{
"site_id": "SITE_ID"
}{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"slug": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"draft",
"published"
]
},
"excerpt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"body": {
"type": "string",
"description": "The post as plain text with the console's marks (## heading, - list, > quote, a picture address on its own line)."
},
"category": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"author_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"seo_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The post's own Google title — null = the title is used."
},
"seo_description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The post's own Google description — null = the excerpt is used."
},
"og_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The picture shown when the post is shared — null = the cover picture."
},
"published_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The post on the live site — null while it's a draft."
},
"is_sample": {
"type": "boolean"
},
"created_at": {
"type": "string"
},
"updated_at": {
"type": "string"
}
},
"required": [
"id",
"title",
"slug",
"status",
"excerpt",
"body",
"category",
"cover_image_url",
"author_name",
"seo_title",
"seo_description",
"og_image_url",
"published_at",
"url",
"is_sample",
"created_at",
"updated_at"
],
"additionalProperties": false
}
},
"has_more": {
"type": "boolean"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"data",
"has_more",
"next_cursor"
],
"additionalProperties": false
}