{ "meta": { "count": 25, "next_page": 3, "previous_page": 1 }, "data": [ { "url": "http://www.example.com/blog/this-is-a-blog-post", "created": "2020-10-08T18:29:19.987936Z", "updated": "2020-10-09T15:49:54.580309Z", "published": "2020-10-08T18:08:00Z", "author": { "first_name": "API", "last_name": "Test", "email": "apitest@buttercms.com", "slug": "api-test", "bio": "This is my bio.", "title": "API", "linkedin_url": "https://www.linkedin.com/in/API", "facebook_url": "https://www.facebook.com/API", "twitter_handle": "buttercmsapi", "profile_image": "https://buttercms.com/api.png" }, "categories": [ { "name": "test category", "slug": "test-category" } ], "tags": [ { "name": "test tag", "slug": "test-tag" } ], "featured_image": null, "featured_image_alt": "", "slug": "this-is-a-blog-post", "title": "This is a blog post", "body": "<p class=\"\">This is a blog post to test the API.</p>", "summary": "This is a blog post to test the API.", "seo_title": "This is a blog post", "meta_description": "This is a blog post to test the API.", "status": "published" } ]}
Blog posts
List All Posts
Retrieve a paginated list of published blog posts sorted by publication date, with filtering and performance options.
GET
/
posts
/
List All Posts
curl --request GET \ --url https://api.buttercms.com/v2/posts/ \ --header 'Authorization: <api-key>'
{ "meta": { "count": 25, "next_page": 3, "previous_page": 1 }, "data": [ { "url": "http://www.example.com/blog/this-is-a-blog-post", "created": "2020-10-08T18:29:19.987936Z", "updated": "2020-10-09T15:49:54.580309Z", "published": "2020-10-08T18:08:00Z", "author": { "first_name": "API", "last_name": "Test", "email": "apitest@buttercms.com", "slug": "api-test", "bio": "This is my bio.", "title": "API", "linkedin_url": "https://www.linkedin.com/in/API", "facebook_url": "https://www.facebook.com/API", "twitter_handle": "buttercmsapi", "profile_image": "https://buttercms.com/api.png" }, "categories": [ { "name": "test category", "slug": "test-category" } ], "tags": [ { "name": "test tag", "slug": "test-tag" } ], "featured_image": null, "featured_image_alt": "", "slug": "this-is-a-blog-post", "title": "This is a blog post", "body": "<p class=\"\">This is a blog post to test the API.</p>", "summary": "This is a blog post to test the API.", "seo_title": "This is a blog post", "meta_description": "This is a blog post to test the API.", "status": "published" } ]}
Retrieve a paginated list of all published blog posts, automatically sorted
by publication date with the newest posts appearing first. This endpoint is
ideal for building blog listing pages, RSS feeds, or content archives.Performance Optimization: Use the exclude_body=true parameter when
building post listing pages to significantly reduce response size by
excluding the full post content. This improves loading performance while
still providing titles, summaries, metadata, and author information needed
for listing displays.
Authorizations
readTokenAuthHeaderreadTokenAuthQuery
Authorization
string
header
required
Set the Authorization header to Token your_read_api_token.
Example: Authorization: Token abc123def456
Note: The header value includes the Token prefix. Authorization: Bearer ... is not accepted and returns 401.
You can access your API token from your settings page.
Query Parameters
page
integer
default:1
Page number for page-based pagination.
Mutually exclusive with limit/offset parameters.
Required range: x >= 1
page_size
integer
default:10
Number of items per page for page-based pagination.
Mutually exclusive with limit/offset parameters.
Required range: 1 <= x <= 100
limit
integer
default:10
Maximum number of items to return for offset-based pagination.
Mutually exclusive with page/page_size parameters.
Values above 100 are capped at 100; values below 1 or invalid fall back to the default of 10 (the request is not rejected).
Required range: 1 <= x <= 100
offset
integer
default:0
Number of items to skip before starting to return results.
Mutually exclusive with page/page_size parameters.
Required range: x >= 0
preview
enum<integer>
default:0
Set to 1 to return the latest draft version of a page. Useful for previewing changes before publishing live. i.e. &preview=1. If you are trying to view a scheduled page for which the most recent page version is published, you must pass the preview parameter to see the scheduled changes.
Set to 1 to access unpublished/draft collection items. Useful for staging environments.
Available options:
0,
1
locale
string
Return only posts in the given locale (e.g. en, es). When omitted, defaults to your organization's default locale.
Returns 400 if the value is not a locale configured on your organization.
Maximum string length: 10
exclude_body
boolean
default:false
When true, excludes the full post body from the response.
Performance benefit: Significantly reduces response size when displaying lists of blog posts.
author_slug
string
Filter posts by an author's slug.
category_slug
string
Filter posts by a category's slug.
tag_slug
string
Filter posts by a tag's slug.
auth_token
string
Your ButterCMS read API token
Response
Success - Blog Posts Retrieved
Returns a list of blog posts matching the specified criteria. Posts are
sorted by publish date with the most recent posts first.
Option 1
Option 2
Blog posts response using page-based pagination (default)
meta
object
required
Show child attributes
data
object[]
required
Array of blog post objects sorted by publish date (newest first)
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ButterCMS Docs","colors":{"primary":"#0505e5","light":"#5050ff","dark":"#0000a0"},"logo":{"light":"https://cdn.buttercms.com/nDD3LeMXQxiR9aJRpRLE","dark":"https://cdn.buttercms.com/nDD3LeMXQxiR9aJRpRLE","href":"https://buttercms.com"},"favicon":"https://mintcdn.com/buttercms/ADHjuou5Js2KRBnv/favicon.svg?fit=max\u0026auto=format\u0026n=ADHjuou5Js2KRBnv\u0026q=85\u0026s=719e07eca4e3b3446e3ba6621a6095f0","navbar":{"links":[{"href":"https://buttercms.com/sales/","label":"Request a Demo"}],"primary":{"type":"button","label":"Start for Free","href":"https://app.buttercms.com/join/"}},"seo":{"metatags":{"canonical":"https://buttercms.com/docs","robots":"noindex, nofollow"}},"integrations":{"gtm":{"tagId":"GTM-W7DPCL97"}},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"buttercms","hasAudioNarration":false,"actualSubdomain":"buttercms","customDomains":["buttercms.com"],"gitSource":{"type":"github","owner":"buttercms","repo":"buttercms","deployBranch":"master","contentDirectory":"unified-docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afd6c61c83bd67fa977217d","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Frameworks","count":79},{"language":"default","tag":"Build your app","count":74},{"language":"default","tag":"Create content","count":74},{"language":"default","tag":"API Reference","count":63},{"language":"default","tag":"Creating and editing content","count":24},{"language":"default","tag":"Core concepts","count":23},{"language":"default","tag":"Starter projects","count":21},{"language":"default","tag":"All starter projects","count":20},{"language":"default","tag":"Webhooks API","count":19},{"language":"default","tag":"How-to recipes","count":18}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".mermaid .node rect,.mermaid .node circle,.mermaid .node ellipse,.mermaid .node polygon{fill:#f0f4ff!important;stroke:#0505e5!important;stroke-width:2px!important}.mermaid .node .label,.mermaid .node text,.mermaid .nodeLabel{font-family:'Open Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif!important;fill:#000022!important;font-size:14px!important;font-weight:500!important}.mermaid .cluster rect{fill:#f8fafc!important;stroke:#5050ff!important;stroke-width:2px!important;rx:8px!important;ry:8px!important}.mermaid .cluster text,.mermaid .cluster .nodeLabel{fill:#0505e5!important;font-weight:600!important;font-size:15px!important}.mermaid .edgePath .path,.mermaid .flowchart-link{stroke:#5050ff!important;stroke-width:2px!important}.mermaid .arrowheadPath,.mermaid marker path{fill:#5050ff!important;stroke:#5050ff!important}.mermaid .edgeLabel,.mermaid .edgeLabel rect{background-color:#ffffff!important;fill:#ffffff!important}.mermaid .edgeLabel p,.mermaid .edgeLabel>p,.mermaid .edgeLabel div,.mermaid .edgeLabel>div{background:#f8fafc!important}.mermaid .edgeLabel text,.mermaid .edgeLabel .label{fill:#000022!important;font-size:12px!important}.mermaid .actor{fill:#f0f4ff!important;stroke:#0505e5!important;stroke-width:2px!important}.mermaid .actor-line{stroke:#5050ff!important;stroke-width:1px!important}.mermaid text.actor{fill:#000022!important;font-weight:600!important}.mermaid .messageText{fill:#000022!important;font-size:13px!important}.mermaid .messageLine0,.mermaid .messageLine1{stroke:#5050ff!important;stroke-width:1.5px!important}.mermaid .note{fill:#fbe700!important;stroke:#c4b800!important}.mermaid .noteText{fill:#000022!important}.mermaid .statediagram-state rect{fill:#f0f4ff!important;stroke:#0505e5!important;stroke-width:2px!important;rx:6px!important}.mermaid .state-start,.mermaid .state-end{fill:#0505e5!important}.mermaid .pieTitleText{fill:#0505e5!important;font-weight:600!important;font-size:16px!important}.mermaid .classGroup rect{fill:#f0f4ff!important;stroke:#0505e5!important}.mermaid .classGroup text{fill:#000022!important}.mermaid .er.entityBox{fill:#f0f4ff!important;stroke:#0505e5!important}.mermaid .section{fill:#f0f4ff!important}.mermaid .task{fill:#5050ff!important;stroke:#0505e5!important}.mermaid .taskText{fill:#ffffff!important}.mermaid,pre:has(.mermaid),div:has(>.mermaid){max-width:100%!important;min-width:100%!important;padding:1.5rem!important}.mermaid svg{width:100%!important;max-width:100%!important;height:auto!important;min-height:200px!important;max-height:800px!important}.dark .mermaid .edgeLabel p,.dark .mermaid .edgeLabel>p,.dark .mermaid .edgeLabel div,.dark .mermaid .edgeLabel>div{background:#1a1a2e!important}.dark .mermaid{background:#1a1a2e!important}.dark .mermaid .node rect,.dark .mermaid .node circle,.dark .mermaid .node ellipse{fill:#2a2a4a!important;stroke:#5050ff!important}.dark .mermaid .node text,.dark .mermaid .nodeLabel{fill:#e0e0e0!important}.dark .mermaid .cluster rect{fill:#1e1e3a!important;stroke:#5050ff!important}.dark .mermaid .cluster text{fill:#8080ff!important}.dark .mermaid .edgePath .path,.dark .mermaid .flowchart-link{stroke:#7070ff!important}.dark .mermaid .arrowheadPath{fill:#7070ff!important}.dark .mermaid .edgeLabel rect{fill:#1a1a2e!important}.dark .mermaid .edgeLabel text{fill:#e0e0e0!important}.diagram-modal-toggle{display:none}.diagram-container{position:relative}.diagram-preview{position:relative;display:block;cursor:zoom-in;transition:opacity 0.2s ease}.diagram-preview:hover{opacity:0.95}.diagram-expand-hint{position:absolute;top:12px;right:12px;background:rgba(255, 255, 255, 0.95);color:#0505e5;padding:6px 12px;border-radius:6px;font-size:12px;font-weight:500;opacity:0;transition:opacity 0.2s ease;pointer-events:none;box-shadow:0 2px 8px rgba(0, 0, 0, 0.15);z-index:10}.diagram-preview:hover .diagram-expand-hint{opacity:1}.dark .diagram-expand-hint{background:rgba(30, 30, 46, 0.95);color:#8080ff}.diagram-modal-overlay{position:fixed;top:0;left:0;right:0;bottom:0;background:rgba(0, 0, 0, 0.9);display:none;align-items:center;justify-content:center;z-index:9999;padding:2rem;cursor:zoom-out}.diagram-modal-toggle:checked~.diagram-modal-overlay{display:flex;animation:fadeIn 0.2s ease}.diagram-modal-content{max-width:90vw;max-height:90vh;background:#ffffff;border-radius:12px;padding:2rem;box-shadow:0 20px 60px rgba(0, 0, 0, 0.5);cursor:default;overflow:auto}.dark .diagram-modal-content{background:#1a1a2e}.diagram-modal-toggle:checked~*{overflow:hidden}.mermaid-lightbox-wrapper{position:relative;cursor:zoom-in;transition:all 0.2s ease}.mermaid-lightbox-wrapper:hover{opacity:0.95}.mermaid-expand-icon{position:absolute;top:12px;right:12px;width:32px;height:32px;display:flex;align-items:center;justify-content:center;background:rgba(255, 255, 255, 0.95);border-radius:6px;box-shadow:0 2px 8px rgba(0, 0, 0, 0.15);opacity:0;transition:opacity 0.2s ease, transform 0.2s ease;pointer-events:none;z-index:10}.mermaid-lightbox-wrapper:hover .mermaid-expand-icon{opacity:1;transform:scale(1.05)}.mermaid-expand-icon svg{width:18px;height:18px;color:#0505e5}.dark .mermaid-expand-icon{background:rgba(30, 30, 46, 0.95)}.dark .mermaid-expand-icon svg{color:#8080ff}.mermaid-lightbox-overlay{position:fixed;top:0;left:0;right:0;bottom:0;background:rgba(0, 0, 0, 0.9);display:flex;align-items:center;justify-content:center;z-index:9999;padding:2rem;animation:fadeIn 0.2s ease;cursor:zoom-out}@keyframes fadeIn{from{opacity:0}to{opacity:1}}.mermaid-lightbox-content{max-width:90vw;max-height:90vh;background:#ffffff;border-radius:12px;padding:2rem;box-shadow:0 20px 60px rgba(0, 0, 0, 0.5);cursor:default;overflow:auto}.dark .mermaid-lightbox-content{background:#1a1a2e}.mermaid-lightbox-content .mermaid{padding:0!important}.mermaid-lightbox-content .mermaid svg{max-height:85vh!important;width:auto!important;max-width:85vw!important}.mermaid-lightbox-close{position:fixed;top:1.5rem;right:1.5rem;width:48px;height:48px;display:flex;align-items:center;justify-content:center;background:rgba(255, 255, 255, 0.95);border:none;border-radius:50%;cursor:pointer;box-shadow:0 4px 12px rgba(0, 0, 0, 0.3);transition:all 0.2s ease;z-index:10000}.mermaid-lightbox-close:hover{transform:scale(1.1);background:#ffffff}.mermaid-lightbox-close svg{width:24px;height:24px;color:#000022}.dark .mermaid-lightbox-close{background:rgba(30, 30, 46, 0.95)}.dark .mermaid-lightbox-close:hover{background:#1e1e3a}.dark .mermaid-lightbox-close svg{color:#e0e0e0}.mermaid-scroll-zoom{overflow:auto;max-height:500px;border:1px solid #e5e7eb;border-radius:12px;background:#ffffff;margin:1rem 0;cursor:grab;position:relative}.mermaid-scroll-zoom:active{cursor:grabbing}.dark .mermaid-scroll-zoom{border-color:#374151;background:#1a1a2e}.mermaid-scroll-zoom .mermaid{padding:1.5rem!important;min-width:100%;width:max-content}.mermaid-scroll-zoom .mermaid svg{min-width:120%;max-width:none!important;max-height:none!important;height:auto!important;transform-origin:top left}.mermaid-zoom-hint{text-align:center;font-size:12px;color:#6b7280;margin:0.5rem 0 1rem 0;font-style:italic}.dark .mermaid-zoom-hint{color:#9ca3af}.mermaid-scroll-zoom::-webkit-scrollbar{width:8px;height:8px}.mermaid-scroll-zoom::-webkit-scrollbar-track{background:#f1f1f1;border-radius:4px}.mermaid-scroll-zoom::-webkit-scrollbar-thumb{background:#c1c1c1;border-radius:4px}.mermaid-scroll-zoom::-webkit-scrollbar-thumb:hover{background:#a1a1a1}.dark .mermaid-scroll-zoom::-webkit-scrollbar-track{background:#2a2a4a}.dark .mermaid-scroll-zoom::-webkit-scrollbar-thumb{background:#4a4a6a}.dark .mermaid-scroll-zoom::-webkit-scrollbar-thumb:hover{background:#5a5a7a}@media (max-width: 768px){.mermaid-lightbox-overlay{padding:1rem}.mermaid-lightbox-content{max-width:95vw;max-height:95vh;padding:1rem}.mermaid-lightbox-content .mermaid svg{max-height:90vh!important;max-width:90vw!important}.mermaid-lightbox-close{width:40px;height:40px;top:1rem;right:1rem}.mermaid-lightbox-close svg{width:20px;height:20px}.mermaid-expand-icon{opacity:0.8}}"}]}
{"page":{"pagePath":"api-reference/blog-posts/list-all-posts","slug":"/api-reference/blog-posts/list-all-posts","pageMetadata":{"title":"List All Posts","description":"Retrieve a paginated list of published blog posts sorted by publication date, with filtering and performance options.","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /posts/","href":"/api-reference/blog-posts/list-all-posts","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve a paginated list of published blog posts sorted by publication date, with filtering and performance options.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Retrieve a paginated list of all published blog posts, automatically sorted\nby publication date with the newest posts appearing first. This endpoint is\nideal for building blog listing pages, RSS feeds, or content archives.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Performance Optimization`}),`: Use the `,_jsx(_components.code,{children:`exclude_body=true`}),` parameter when\nbuilding post listing pages to significantly reduce response size by\nexcluding the full post content. This improves loading performance while\nstill providing titles, summaries, metadata, and author information needed\nfor listing displays.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List All Posts","description":"Retrieve a paginated list of published blog posts sorted by publication date, with filtering and performance options.","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /posts/","href":"/api-reference/blog-posts/list-all-posts","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Blog posts"],"summary":"List All Posts","description":"Retrieve a paginated list of published blog posts sorted by publication date, with filtering and performance options.","x-mint":{"metadata":{"description":"Retrieve a paginated list of published blog posts sorted by publication date, with filtering and performance options."},"content":"Retrieve a paginated list of all published blog posts, automatically sorted\nby publication date with the newest posts appearing first. This endpoint is\nideal for building blog listing pages, RSS feeds, or content archives.\n\n**Performance Optimization**: Use the `exclude_body=true` parameter when\nbuilding post listing pages to significantly reduce response size by\nexcluding the full post content. This improves loading performance while\nstill providing titles, summaries, metadata, and author information needed\nfor listing displays.\n"},"operationId":"listAllPosts","security":["92d4d238-b693-44e9-84f2-7d08ad0ab263","0487360e-11aa-491f-acd7-cb0faa7af6eb"],"parameters":["1164cda6-35d7-4e0f-8ead-94e94da4df5a","265db264-6014-4668-b58c-d45b7514b73b","c483f143-4d2f-43ee-9e18-d89d0be2432a","f07d2769-4f26-4192-a2ab-528562928b24","5bdfaddc-2665-4a2b-b585-1c39683e7a1f","e6e75601-a5b9-4b5f-86c0-476fee23aa49","03d7a5b6-9c45-47fa-ba26-978bed3f6c4f","b67ecd47-3126-4552-a7a6-1451d34683c9","2279bbc8-8717-484a-8dd6-cb1bfdcde9f0","13971d98-17c2-415d-b3bf-83ecf26f9e2a","484f14a9-9674-4b82-813e-94b2441eea55"],"responses":{"200":"8c264aea-3f58-4a8a-b3d3-a3ae6846b8dc","400":"0662d33f-9b96-4f19-8062-70f8a73fec2f","401":"e2b64d4f-7328-4696-b91b-618528c96bfd"},"method":"get","type":"path","servers":["5245510f-95b6-4fd0-b4e8-4159dcc1f97b"],"path":"/posts/","baseUrlOptions":["https://api.buttercms.com/v2"],"title":"List All Posts","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"1164cda6-35d7-4e0f-8ead-94e94da4df5a":{"name":"page","in":"query","description":"Page number for page-based pagination.\n\n**Mutually exclusive with limit/offset parameters.**\n","required":false,"schema":{"type":"integer","default":1,"minimum":1,"isRequired":false,"description":"Page number for page-based pagination.\n\n**Mutually exclusive with limit/offset parameters.**\n","uniqueKey":"","typeLabel":"integer"},"example":2},"265db264-6014-4668-b58c-d45b7514b73b":{"name":"page_size","in":"query","description":"Number of items per page for page-based pagination.\n\n**Mutually exclusive with limit/offset parameters.**\n","required":false,"schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"isRequired":false,"description":"Number of items per page for page-based pagination.\n\n**Mutually exclusive with limit/offset parameters.**\n","uniqueKey":"","typeLabel":"integer"},"example":5},"c483f143-4d2f-43ee-9e18-d89d0be2432a":{"name":"limit","in":"query","description":"Maximum number of items to return for offset-based pagination.\n\n**Mutually exclusive with page/page_size parameters.**\n\nValues above 100 are capped at 100; values below 1 or invalid fall back to the default of 10 (the request is not rejected).\n","required":false,"schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"isRequired":false,"description":"Maximum number of items to return for offset-based pagination.\n\n**Mutually exclusive with page/page_size parameters.**\n\nValues above 100 are capped at 100; values below 1 or invalid fall back to the default of 10 (the request is not rejected).\n","uniqueKey":"","typeLabel":"integer"},"example":5},"f07d2769-4f26-4192-a2ab-528562928b24":{"name":"offset","in":"query","description":"Number of items to skip before starting to return results.\n\n**Mutually exclusive with page/page_size parameters.**\n","required":false,"schema":{"type":"integer","minimum":0,"default":0,"isRequired":false,"description":"Number of items to skip before starting to return results.\n\n**Mutually exclusive with page/page_size parameters.**\n","uniqueKey":"","typeLabel":"integer"},"example":10},"5bdfaddc-2665-4a2b-b585-1c39683e7a1f":{"name":"preview","in":"query","description":"Set to 1 to return the latest draft version of a page. Useful for previewing changes before publishing live. i.e. `\u0026preview=1`. If you are trying to view a scheduled page for which the most recent page version is published, you must pass the preview parameter to see the scheduled changes.\n\nSet to `1` to access unpublished/draft collection items. Useful for staging environments.\n","required":false,"schema":{"type":"integer","enum":[0,1],"default":0,"isRequired":false,"description":"Set to 1 to return the latest draft version of a page. Useful for previewing changes before publishing live. i.e. `\u0026preview=1`. If you are trying to view a scheduled page for which the most recent page version is published, you must pass the preview parameter to see the scheduled changes.\n\nSet to `1` to access unpublished/draft collection items. Useful for staging environments.\n","uniqueKey":"","typeLabel":"enum\u003cinteger>"},"example":1},"e6e75601-a5b9-4b5f-86c0-476fee23aa49":{"name":"locale","in":"query","description":"Return only posts in the given locale (e.g. `en`, `es`). When omitted, defaults to your organization's default locale.\n\nReturns `400` if the value is not a locale configured on your organization.\n","required":false,"schema":{"type":"string","maxLength":10,"isRequired":false,"description":"Return only posts in the given locale (e.g. `en`, `es`). When omitted, defaults to your organization's default locale.\n\nReturns `400` if the value is not a locale configured on your organization.\n","uniqueKey":"","typeLabel":"string"},"example":"en"},"03d7a5b6-9c45-47fa-ba26-978bed3f6c4f":{"name":"exclude_body","in":"query","description":"When `true`, excludes the full post body from the response.\n\n**Performance benefit**: Significantly reduces response size when displaying lists of blog posts.\n","schema":{"type":"boolean","default":false,"description":"When `true`, excludes the full post body from the response.\n\n**Performance benefit**: Significantly reduces response size when displaying lists of blog posts.\n","uniqueKey":"","typeLabel":"boolean"},"example":true},"b67ecd47-3126-4552-a7a6-1451d34683c9":{"name":"author_slug","in":"query","description":"Filter posts by an author's slug.","schema":{"type":"string","description":"Filter posts by an author's slug.","uniqueKey":"","typeLabel":"string"},"example":"api-test"},"2279bbc8-8717-484a-8dd6-cb1bfdcde9f0":{"name":"category_slug","in":"query","description":"Filter posts by a category's slug.","schema":{"type":"string","description":"Filter posts by a category's slug.","uniqueKey":"","typeLabel":"string"},"example":"test-category"},"13971d98-17c2-415d-b3bf-83ecf26f9e2a":{"name":"tag_slug","in":"query","description":"Filter posts by a tag's slug.","schema":{"type":"string","description":"Filter posts by a tag's slug.","uniqueKey":"","typeLabel":"string"},"example":"test-tag"},"484f14a9-9674-4b82-813e-94b2441eea55":{"name":"auth_token","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"Your ButterCMS read API token\n","uniqueKey":"","typeLabel":"string"},"description":"Your ButterCMS read API token\n","example":"your_api_token"}},"responses":{"8c264aea-3f58-4a8a-b3d3-a3ae6846b8dc":{"description":"**Success - Blog Posts Retrieved**\n\nReturns a list of blog posts matching the specified criteria. Posts are\nsorted by publish date with the most recent posts first.\n","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Blog posts response using page-based pagination (default)","required":["meta","data"],"properties":{"meta":{"type":"object","properties":{"previous_page":{"oneOf":[{"type":"integer","description":"Previous page number if it exists","uniqueKey":"oneOf.0.meta.previous_page.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Previous page number if it exists","uniqueKey":"oneOf.0.meta.previous_page.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.meta.previous_page","typeLabel":"integer | null"},"next_page":{"oneOf":[{"type":"integer","description":"Next page number if it exists","uniqueKey":"oneOf.0.meta.next_page.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Next page number if it exists","uniqueKey":"oneOf.0.meta.next_page.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.meta.next_page","typeLabel":"integer | null"},"count":{"type":"integer","description":"Total number of items","uniqueKey":"oneOf.0.meta.count","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"oneOf.0.meta","typeLabel":"object"},"data":{"type":"array","items":{"type":"object","description":"Complete blog post object with all fields and related data","properties":{"url":{"oneOf":[{"type":"string","format":"uri","description":"Full URL to the blog post. Null when no blog base URL is configured for your account.","example":"http://www.example.com/blog/this-is-a-blog-post","uniqueKey":"oneOf.0.data.items.[INDEX].url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"Full URL to the blog post. Null when no blog base URL is configured for your account.","example":"http://www.example.com/blog/this-is-a-blog-post","uniqueKey":"oneOf.0.data.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.items.[INDEX].url","typeLabel":"string\u003curi> | null"},"created":{"type":"string","format":"date-time","description":"Timestamp when the blog post was created","example":"2020-10-08T18:29:19.987936Z","uniqueKey":"oneOf.0.data.items.[INDEX].created","typeLabel":"string\u003cdate-time>"},"updated":{"type":"string","format":"date-time","description":"Timestamp when the blog post was last updated","example":"2020-10-09T15:49:54.580309Z","uniqueKey":"oneOf.0.data.items.[INDEX].updated","typeLabel":"string\u003cdate-time>"},"published":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp when the blog post was published","example":"2020-10-08T18:08:00Z","uniqueKey":"oneOf.0.data.items.[INDEX].published.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp when the blog post was published","example":"2020-10-08T18:08:00Z","uniqueKey":"oneOf.0.data.items.[INDEX].published.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.items.[INDEX].published","typeLabel":"string\u003cdate-time> | null"},"author":{"type":"object","description":"Author information for blog posts","properties":{"first_name":{"type":"string","description":"Author's first name","example":"API","uniqueKey":"oneOf.0.data.items.[INDEX].author.first_name","typeLabel":"string"},"last_name":{"type":"string","description":"Author's last name","example":"Test","uniqueKey":"oneOf.0.data.items.[INDEX].author.last_name","typeLabel":"string"},"email":{"oneOf":[{"type":"string","format":"email","description":"Author's email address. Returned as `null` unless **Include author email addresses in Blog API responses** is enabled under Settings → General.","example":"apitest@buttercms.com","uniqueKey":"oneOf.0.data.items.[INDEX].author.email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","description":"Author's email address. Returned as `null` unless **Include author email addresses in Blog API responses** is enabled under Settings → General.","example":"apitest@buttercms.com","uniqueKey":"oneOf.0.data.items.[INDEX].author.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.items.[INDEX].author.email","typeLabel":"string\u003cemail> | null"},"slug":{"type":"string","description":"Author's URL-friendly slug","example":"api-test","uniqueKey":"oneOf.0.data.items.[INDEX].author.slug","typeLabel":"string"},"bio":{"type":"string","description":"Author's biography","example":"This is my bio.","uniqueKey":"oneOf.0.data.items.[INDEX].author.bio","typeLabel":"string"},"title":{"type":"string","description":"Author's professional title","example":"API","uniqueKey":"oneOf.0.data.items.[INDEX].author.title","typeLabel":"string"},"linkedin_url":{"type":"string","format":"uri","description":"Author's LinkedIn profile URL. Empty string if not set, never null.","example":"https://www.linkedin.com/in/API","uniqueKey":"oneOf.0.data.items.[INDEX].author.linkedin_url","typeLabel":"string\u003curi>"},"facebook_url":{"type":"string","format":"uri","description":"Author's Facebook profile URL. Empty string if not set, never null.","example":"https://www.facebook.com/API","uniqueKey":"oneOf.0.data.items.[INDEX].author.facebook_url","typeLabel":"string\u003curi>"},"twitter_handle":{"type":"string","description":"Author's Twitter handle","example":"buttercmsapi","uniqueKey":"oneOf.0.data.items.[INDEX].author.twitter_handle","typeLabel":"string"},"instagram_url":{"type":"string","format":"uri","description":"Author's Instagram profile URL. Empty string if not set, never null.","example":"https://www.instagram.com/API","uniqueKey":"oneOf.0.data.items.[INDEX].author.instagram_url","typeLabel":"string\u003curi>"},"pinterest_url":{"type":"string","format":"uri","description":"Author's Pinterest profile URL. Empty string if not set, never null.","example":"https://www.pinterest.com/API","uniqueKey":"oneOf.0.data.items.[INDEX].author.pinterest_url","typeLabel":"string\u003curi>"},"profile_image":{"type":"string","format":"uri","description":"URL to author's profile image. Empty string if not set, never null.","example":"https://buttercms.com/api.png","uniqueKey":"oneOf.0.data.items.[INDEX].author.profile_image","typeLabel":"string\u003curi>"}},"uniqueKey":"oneOf.0.data.items.[INDEX].author","typeLabel":"object"},"categories":{"type":"array","items":{"type":"object","description":"Category information for blog posts","properties":{"name":{"type":"string","description":"Display name of the category","example":"test category","uniqueKey":"oneOf.0.data.items.[INDEX].categories.items.[INDEX].name","typeLabel":"string"},"slug":{"type":"string","description":"URL-friendly slug of the category","example":"test-category","uniqueKey":"oneOf.0.data.items.[INDEX].categories.items.[INDEX].slug","typeLabel":"string"}},"uniqueKey":"oneOf.0.data.items.[INDEX].categories.items.[INDEX]","typeLabel":"object"},"description":"Array of categories assigned to the blog post","uniqueKey":"oneOf.0.data.items.[INDEX].categories","typeLabel":"object[]"},"tags":{"type":"array","items":{"type":"object","description":"Tag information for blog posts","properties":{"name":{"type":"string","description":"Display name of the tag","example":"test tag","uniqueKey":"oneOf.0.data.items.[INDEX].tags.items.[INDEX].name","typeLabel":"string"},"slug":{"type":"string","description":"URL-friendly slug of the tag","example":"test-tag","uniqueKey":"oneOf.0.data.items.[INDEX].tags.items.[INDEX].slug","typeLabel":"string"}},"uniqueKey":"oneOf.0.data.items.[INDEX].tags.items.[INDEX]","typeLabel":"object"},"description":"Array of tags assigned to the blog post","uniqueKey":"oneOf.0.data.items.[INDEX].tags","typeLabel":"object[]"},"featured_image":{"oneOf":[{"type":"string","format":"uri","description":"URL to the featured image, null if no featured image","example":null,"uniqueKey":"oneOf.0.data.items.[INDEX].featured_image.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"URL to the featured image, null if no featured image","example":null,"uniqueKey":"oneOf.0.data.items.[INDEX].featured_image.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.items.[INDEX].featured_image","typeLabel":"string\u003curi> | null"},"featured_image_alt":{"type":"string","description":"Alt text for the featured image","example":"","uniqueKey":"oneOf.0.data.items.[INDEX].featured_image_alt","typeLabel":"string"},"slug":{"type":"string","description":"URL-friendly slug for the blog post","example":"this-is-a-blog-post","uniqueKey":"oneOf.0.data.items.[INDEX].slug","typeLabel":"string"},"title":{"type":"string","description":"Title of the blog post","example":"This is a blog post","uniqueKey":"oneOf.0.data.items.[INDEX].title","typeLabel":"string"},"body":{"type":"string","description":"HTML content body of the blog post (excluded if exclude_body=true)","example":"\u003cp class=\"\">This is a blog post to test the API.\u003c/p>","uniqueKey":"oneOf.0.data.items.[INDEX].body","typeLabel":"string"},"summary":{"type":"string","description":"Plain text summary of the blog post","example":"This is a blog post to test the API.","uniqueKey":"oneOf.0.data.items.[INDEX].summary","typeLabel":"string"},"seo_title":{"type":"string","description":"SEO-optimized title for the blog post","example":"This is a blog post","uniqueKey":"oneOf.0.data.items.[INDEX].seo_title","typeLabel":"string"},"meta_description":{"type":"string","description":"Meta description for SEO and social sharing","example":"This is a blog post to test the API.","uniqueKey":"oneOf.0.data.items.[INDEX].meta_description","typeLabel":"string"},"status":{"type":"string","enum":["draft","published","scheduled"],"description":"Publication status of the blog post","example":"published","uniqueKey":"oneOf.0.data.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"scheduled":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp when the blog post is scheduled to be published. If not scheduled, this field will be null","example":null,"uniqueKey":"oneOf.0.data.items.[INDEX].scheduled.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp when the blog post is scheduled to be published. If not scheduled, this field will be null","example":null,"uniqueKey":"oneOf.0.data.items.[INDEX].scheduled.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.items.[INDEX].scheduled","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"oneOf.0.data.items.[INDEX]","typeLabel":"object"},"description":"Array of blog post objects sorted by publish date (newest first)","isRequired":true,"uniqueKey":"oneOf.0.data","typeLabel":"object[]"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Blog posts response using offset-based pagination (alternative)","required":["meta","data"],"properties":{"meta":{"type":"object","description":"Pagination metadata for limit/offset pagination","properties":{"count":{"type":"integer","description":"Total number of items","example":25,"uniqueKey":"oneOf.1.meta.count","typeLabel":"integer"},"next_offset":{"oneOf":[{"type":"integer","description":"Offset for the next page, null if no next page","example":20,"uniqueKey":"oneOf.1.meta.next_offset.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Offset for the next page, null if no next page","example":20,"uniqueKey":"oneOf.1.meta.next_offset.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.meta.next_offset","typeLabel":"integer | null"},"previous_offset":{"oneOf":[{"type":"integer","description":"Offset for the previous page, null if no previous page","example":null,"uniqueKey":"oneOf.1.meta.previous_offset.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Offset for the previous page, null if no previous page","example":null,"uniqueKey":"oneOf.1.meta.previous_offset.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.meta.previous_offset","typeLabel":"integer | null"}},"isRequired":true,"uniqueKey":"oneOf.1.meta","typeLabel":"object"},"data":{"type":"array","items":{"type":"object","description":"Complete blog post object with all fields and related data","properties":{"url":{"oneOf":[{"type":"string","format":"uri","description":"Full URL to the blog post. Null when no blog base URL is configured for your account.","example":"http://www.example.com/blog/this-is-a-blog-post","uniqueKey":"oneOf.1.data.items.[INDEX].url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"Full URL to the blog post. Null when no blog base URL is configured for your account.","example":"http://www.example.com/blog/this-is-a-blog-post","uniqueKey":"oneOf.1.data.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.data.items.[INDEX].url","typeLabel":"string\u003curi> | null"},"created":{"type":"string","format":"date-time","description":"Timestamp when the blog post was created","example":"2020-10-08T18:29:19.987936Z","uniqueKey":"oneOf.1.data.items.[INDEX].created","typeLabel":"string\u003cdate-time>"},"updated":{"type":"string","format":"date-time","description":"Timestamp when the blog post was last updated","example":"2020-10-09T15:49:54.580309Z","uniqueKey":"oneOf.1.data.items.[INDEX].updated","typeLabel":"string\u003cdate-time>"},"published":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp when the blog post was published","example":"2020-10-08T18:08:00Z","uniqueKey":"oneOf.1.data.items.[INDEX].published.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp when the blog post was published","example":"2020-10-08T18:08:00Z","uniqueKey":"oneOf.1.data.items.[INDEX].published.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.data.items.[INDEX].published","typeLabel":"string\u003cdate-time> | null"},"author":{"type":"object","description":"Author information for blog posts","properties":{"first_name":{"type":"string","description":"Author's first name","example":"API","uniqueKey":"oneOf.1.data.items.[INDEX].author.first_name","typeLabel":"string"},"last_name":{"type":"string","description":"Author's last name","example":"Test","uniqueKey":"oneOf.1.data.items.[INDEX].author.last_name","typeLabel":"string"},"email":{"oneOf":[{"type":"string","format":"email","description":"Author's email address. Returned as `null` unless **Include author email addresses in Blog API responses** is enabled under Settings → General.","example":"apitest@buttercms.com","uniqueKey":"oneOf.1.data.items.[INDEX].author.email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","description":"Author's email address. Returned as `null` unless **Include author email addresses in Blog API responses** is enabled under Settings → General.","example":"apitest@buttercms.com","uniqueKey":"oneOf.1.data.items.[INDEX].author.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.data.items.[INDEX].author.email","typeLabel":"string\u003cemail> | null"},"slug":{"type":"string","description":"Author's URL-friendly slug","example":"api-test","uniqueKey":"oneOf.1.data.items.[INDEX].author.slug","typeLabel":"string"},"bio":{"type":"string","description":"Author's biography","example":"This is my bio.","uniqueKey":"oneOf.1.data.items.[INDEX].author.bio","typeLabel":"string"},"title":{"type":"string","description":"Author's professional title","example":"API","uniqueKey":"oneOf.1.data.items.[INDEX].author.title","typeLabel":"string"},"linkedin_url":{"type":"string","format":"uri","description":"Author's LinkedIn profile URL. Empty string if not set, never null.","example":"https://www.linkedin.com/in/API","uniqueKey":"oneOf.1.data.items.[INDEX].author.linkedin_url","typeLabel":"string\u003curi>"},"facebook_url":{"type":"string","format":"uri","description":"Author's Facebook profile URL. Empty string if not set, never null.","example":"https://www.facebook.com/API","uniqueKey":"oneOf.1.data.items.[INDEX].author.facebook_url","typeLabel":"string\u003curi>"},"twitter_handle":{"type":"string","description":"Author's Twitter handle","example":"buttercmsapi","uniqueKey":"oneOf.1.data.items.[INDEX].author.twitter_handle","typeLabel":"string"},"instagram_url":{"type":"string","format":"uri","description":"Author's Instagram profile URL. Empty string if not set, never null.","example":"https://www.instagram.com/API","uniqueKey":"oneOf.1.data.items.[INDEX].author.instagram_url","typeLabel":"string\u003curi>"},"pinterest_url":{"type":"string","format":"uri","description":"Author's Pinterest profile URL. Empty string if not set, never null.","example":"https://www.pinterest.com/API","uniqueKey":"oneOf.1.data.items.[INDEX].author.pinterest_url","typeLabel":"string\u003curi>"},"profile_image":{"type":"string","format":"uri","description":"URL to author's profile image. Empty string if not set, never null.","example":"https://buttercms.com/api.png","uniqueKey":"oneOf.1.data.items.[INDEX].author.profile_image","typeLabel":"string\u003curi>"}},"uniqueKey":"oneOf.1.data.items.[INDEX].author","typeLabel":"object"},"categories":{"type":"array","items":{"type":"object","description":"Category information for blog posts","properties":{"name":{"type":"string","description":"Display name of the category","example":"test category","uniqueKey":"oneOf.1.data.items.[INDEX].categories.items.[INDEX].name","typeLabel":"string"},"slug":{"type":"string","description":"URL-friendly slug of the category","example":"test-category","uniqueKey":"oneOf.1.data.items.[INDEX].categories.items.[INDEX].slug","typeLabel":"string"}},"uniqueKey":"oneOf.1.data.items.[INDEX].categories.items.[INDEX]","typeLabel":"object"},"description":"Array of categories assigned to the blog post","uniqueKey":"oneOf.1.data.items.[INDEX].categories","typeLabel":"object[]"},"tags":{"type":"array","items":{"type":"object","description":"Tag information for blog posts","properties":{"name":{"type":"string","description":"Display name of the tag","example":"test tag","uniqueKey":"oneOf.1.data.items.[INDEX].tags.items.[INDEX].name","typeLabel":"string"},"slug":{"type":"string","description":"URL-friendly slug of the tag","example":"test-tag","uniqueKey":"oneOf.1.data.items.[INDEX].tags.items.[INDEX].slug","typeLabel":"string"}},"uniqueKey":"oneOf.1.data.items.[INDEX].tags.items.[INDEX]","typeLabel":"object"},"description":"Array of tags assigned to the blog post","uniqueKey":"oneOf.1.data.items.[INDEX].tags","typeLabel":"object[]"},"featured_image":{"oneOf":[{"type":"string","format":"uri","description":"URL to the featured image, null if no featured image","example":null,"uniqueKey":"oneOf.1.data.items.[INDEX].featured_image.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"URL to the featured image, null if no featured image","example":null,"uniqueKey":"oneOf.1.data.items.[INDEX].featured_image.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.data.items.[INDEX].featured_image","typeLabel":"string\u003curi> | null"},"featured_image_alt":{"type":"string","description":"Alt text for the featured image","example":"","uniqueKey":"oneOf.1.data.items.[INDEX].featured_image_alt","typeLabel":"string"},"slug":{"type":"string","description":"URL-friendly slug for the blog post","example":"this-is-a-blog-post","uniqueKey":"oneOf.1.data.items.[INDEX].slug","typeLabel":"string"},"title":{"type":"string","description":"Title of the blog post","example":"This is a blog post","uniqueKey":"oneOf.1.data.items.[INDEX].title","typeLabel":"string"},"body":{"type":"string","description":"HTML content body of the blog post (excluded if exclude_body=true)","example":"\u003cp class=\"\">This is a blog post to test the API.\u003c/p>","uniqueKey":"oneOf.1.data.items.[INDEX].body","typeLabel":"string"},"summary":{"type":"string","description":"Plain text summary of the blog post","example":"This is a blog post to test the API.","uniqueKey":"oneOf.1.data.items.[INDEX].summary","typeLabel":"string"},"seo_title":{"type":"string","description":"SEO-optimized title for the blog post","example":"This is a blog post","uniqueKey":"oneOf.1.data.items.[INDEX].seo_title","typeLabel":"string"},"meta_description":{"type":"string","description":"Meta description for SEO and social sharing","example":"This is a blog post to test the API.","uniqueKey":"oneOf.1.data.items.[INDEX].meta_description","typeLabel":"string"},"status":{"type":"string","enum":["draft","published","scheduled"],"description":"Publication status of the blog post","example":"published","uniqueKey":"oneOf.1.data.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"scheduled":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp when the blog post is scheduled to be published. If not scheduled, this field will be null","example":null,"uniqueKey":"oneOf.1.data.items.[INDEX].scheduled.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp when the blog post is scheduled to be published. If not scheduled, this field will be null","example":null,"uniqueKey":"oneOf.1.data.items.[INDEX].scheduled.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.data.items.[INDEX].scheduled","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"oneOf.1.data.items.[INDEX]","typeLabel":"object"},"description":"Array of blog post objects sorted by publish date (newest first)","isRequired":true,"uniqueKey":"oneOf.1.data","typeLabel":"object[]"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"page_based_pagination":{"title":"page_based_pagination","summary":"Page-based pagination (default)","description":"Using ?page=2\u0026page_size=5 parameters","value":{"meta":{"count":25,"next_page":3,"previous_page":1},"data":[{"url":"http://www.example.com/blog/this-is-a-blog-post","created":"2020-10-08T18:29:19.987936Z","updated":"2020-10-09T15:49:54.580309Z","published":"2020-10-08T18:08:00Z","author":{"first_name":"API","last_name":"Test","email":"apitest@buttercms.com","slug":"api-test","bio":"This is my bio.","title":"API","linkedin_url":"https://www.linkedin.com/in/API","facebook_url":"https://www.facebook.com/API","twitter_handle":"buttercmsapi","profile_image":"https://buttercms.com/api.png"},"categories":[{"name":"test category","slug":"test-category"}],"tags":[{"name":"test tag","slug":"test-tag"}],"featured_image":null,"featured_image_alt":"","slug":"this-is-a-blog-post","title":"This is a blog post","body":"\u003cp class=\"\">This is a blog post to test the API.\u003c/p>","summary":"This is a blog post to test the API.","seo_title":"This is a blog post","meta_description":"This is a blog post to test the API.","status":"published"}]}},"offset_based_pagination":{"title":"offset_based_pagination","summary":"Offset-based pagination","description":"Using ?limit=5\u0026offset=10 parameters","value":{"meta":{"count":25,"next_offset":15,"previous_offset":5},"data":[{"url":"http://www.example.com/blog/this-is-a-blog-post","created":"2020-10-08T18:29:19.987936Z","updated":"2020-10-09T15:49:54.580309Z","published":"2020-10-08T18:08:00Z","author":{"first_name":"API","last_name":"Test","email":"apitest@buttercms.com","slug":"api-test","bio":"This is my bio.","title":"API","linkedin_url":"https://www.linkedin.com/in/API","facebook_url":"https://www.facebook.com/API","twitter_handle":"buttercmsapi","profile_image":"https://buttercms.com/api.png"},"categories":[{"name":"test category","slug":"test-category"}],"tags":[{"name":"test tag","slug":"test-tag"}],"featured_image":null,"featured_image_alt":"","slug":"this-is-a-blog-post","title":"This is a blog post","body":"\u003cp class=\"\">This is a blog post to test the API.\u003c/p>","summary":"This is a blog post to test the API.","seo_title":"This is a blog post","meta_description":"This is a blog post to test the API.","status":"published"}]}},"exclude_body_response":{"title":"exclude_body_response","summary":"Response with exclude_body=true (lighter payload)","description":"Using page-based pagination with exclude_body parameter","value":{"meta":{"count":25,"next_page":3,"previous_page":1},"data":[{"url":"http://www.example.com/blog/this-is-a-blog-post","created":"2020-10-08T18:29:19.987936Z","updated":"2020-10-09T15:49:54.580309Z","published":"2020-10-08T18:08:00Z","author":{"first_name":"API","last_name":"Test","email":"apitest@buttercms.com","slug":"api-test","bio":"This is my bio.","title":"API","linkedin_url":"https://www.linkedin.com/in/API","facebook_url":"https://www.facebook.com/API","twitter_handle":"buttercmsapi","profile_image":"https://buttercms.com/api.png"},"categories":[{"name":"test category","slug":"test-category"}],"tags":[{"name":"test tag","slug":"test-tag"}],"featured_image":null,"featured_image_alt":"","slug":"this-is-a-blog-post","title":"This is a blog post","summary":"This is a blog post to test the API.","seo_title":"This is a blog post","meta_description":"This is a blog post to test the API.","status":"published"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"0662d33f-9b96-4f19-8062-70f8a73fec2f":{"description":"**Bad Request - Invalid Query Parameters**\n\nInvalid or malformed query parameters provided (e.g. a `locale` not\nconfigured for your organization).\n","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Response for validation errors (400 Bad Request). The shape varies by endpoint and check: a field-keyed object whose values are arrays of messages or single message strings, a bare array of messages, or a general `error` message.","example":{"title":["This field is required."],"slug":"You must specify a page slug."},"additionalProperties":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.additionalProperties.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.0.additionalProperties.oneOf.0","typeLabel":"string[]"},{"type":"string","uniqueKey":"oneOf.0.additionalProperties.oneOf.1","typeLabel":"string"}],"uniqueKey":"oneOf.0.additionalProperties","typeLabel":"string[] | string"},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"array","items":{"type":"string","uniqueKey":"oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Response for validation errors (400 Bad Request). The shape varies by endpoint and check: a field-keyed object whose values are arrays of messages or single message strings, a bare array of messages, or a general `error` message.","example":["'field1_key' is required"],"uniqueKey":"oneOf.1","typeLabel":"string[]"},{"type":"object","description":"Response for validation errors (400 Bad Request). The shape varies by endpoint and check: a field-keyed object whose values are arrays of messages or single message strings, a bare array of messages, or a general `error` message.","example":{"error":"Cannot create a new Collection Item. Collection Item Limit Reached."},"properties":{"error":{"type":"string","description":"Error message","uniqueKey":"oneOf.2.error","typeLabel":"string"}},"uniqueKey":"oneOf.2","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object · string[] · object"},"example":{"locale":["Locales were specified without being configured on your account: 'zz'."]},"examples":{"Example":{"title":"Example","value":{"locale":["Locales were specified without being configured on your account: 'zz'."]}}},"exampleType":"examples"}},"exampleType":"examples"},"e2b64d4f-7328-4696-b91b-618528c96bfd":{"description":"Unauthorized - Invalid or missing API token","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Error message describing what went wrong","example":"Authentication credentials were not provided.","uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missing_token":{"title":"missing_token","summary":"Missing API token (most Read endpoints)","description":"The message most Read API endpoints (Pages, Blog Posts, Blog metadata, Feeds, `/v2/content/?keys=` and single collection items) return for a missing token.","value":{"detail":"Incorrect authentication credentials."}},"missing_token_collections":{"title":"missing_token_collections","summary":"Missing API token (writes, collection by key, page search)","description":"Write requests, `GET /v2/content/{key}/` and `GET /v2/pages/search/` return this message instead for a missing token.","value":{"detail":"Authentication credentials were not provided."}},"invalid_token":{"title":"invalid_token","summary":"Invalid API token","value":{"detail":"Invalid token."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"92d4d238-b693-44e9-84f2-7d08ad0ab263":{"readTokenAuthHeader":{"type":"apiKey","in":"header","name":"Authorization","description":"Set the `Authorization` header to `Token your_read_api_token`.\n\nExample: `Authorization: Token abc123def456`\n\nNote: The header value includes the `Token` prefix. `Authorization: Bearer ...` is not accepted and returns 401.\n\nYou can access your API token from your settings page.\n","scopes":[],"schemeName":"readTokenAuthHeader"}},"0487360e-11aa-491f-acd7-cb0faa7af6eb":{"readTokenAuthQuery":{"type":"apiKey","in":"query","name":"auth_token","description":"Pass your API token via the `auth_token` parameter on every request: `?auth_token=your_read_api_token`.\n\nYou can access your API token from your settings page.\n\nRequests made with a missing or invalid token will get a 401 Unauthorized response. All requests must be made over HTTPS.\n","scopes":[],"schemeName":"readTokenAuthQuery"}}},"servers":{"5245510f-95b6-4fd0-b4e8-4159dcc1f97b":{"url":"https://api.buttercms.com/v2","description":"ButterCMS API v2"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Set the `Authorization` header to `Token your_read_api_token`.\n\nExample: `Authorization: Token abc123def456`\n\nNote: The header value includes the `Token` prefix. `Authorization: Bearer ...` is not accepted and returns 401.\n\nYou can access your API token from your settings page.\n","scopes":[],"schemeName":"readTokenAuthHeader"},"schema":{"title":"Authorization","type":"string","description":"Set the `Authorization` header to `Token your_read_api_token`.\n\nExample: `Authorization: Token abc123def456`\n\nNote: The header value includes the `Token` prefix. `Authorization: Bearer ...` is not accepted and returns 401.\n\nYou can access your API token from your settings page.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"readTokenAuthHeader","name":"Authorization"}],"title":"readTokenAuthHeader"},{"schemes":[{"scheme":{"type":"apiKey","in":"query","name":"auth_token","description":"Pass your API token via the `auth_token` parameter on every request: `?auth_token=your_read_api_token`.\n\nYou can access your API token from your settings page.\n\nRequests made with a missing or invalid token will get a 401 Unauthorized response. All requests must be made over HTTPS.\n","scopes":[],"schemeName":"readTokenAuthQuery"},"schema":{"title":"auth_token","type":"string","description":"Pass your API token via the `auth_token` parameter on every request: `?auth_token=your_read_api_token`.\n\nYou can access your API token from your settings page.\n\nRequests made with a missing or invalid token will get a 401 Unauthorized response. All requests must be made over HTTPS.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"readTokenAuthQuery","name":"auth_token"}],"title":"readTokenAuthQuery"}]},"originalFileLocation":"api/openapi/read_api.yaml"},"subdomain":"buttercms","siteName":"ButterCMS Docs","title":"List All Posts - ButterCMS Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T14:11:45.753Z","originalFileLocation":"api-reference/blog-posts/list-all-posts.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve a paginated list of published blog posts sorted by publication date, with filtering and performance options.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ButterCMS Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex, nofollow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List All Posts - ButterCMS Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a paginated list of published blog posts sorted by publication date, with filtering and performance options.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ButterCMS Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://buttercms.com/docs/api-reference/blog-posts/list-all-posts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://buttercms.mintlify.site/docs/_mintlify/api/og/v2?division=Blog+posts\u0026amp;title=List+All+Posts\u0026amp;description=Retrieve+a+paginated+list+of+published+blog+posts+sorted+by+publication+date%2C+with+filtering+and+performance+options.\u0026amp;theme=5b7441fa906780c0ab866249\u0026amp;signature=dc5f1c66317317c6d3546d1955466edf9fd3ccd3012a818e1c992a441c0a26e1\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List All Posts - ButterCMS Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a paginated list of published blog posts sorted by publication date, with filtering and performance options.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://buttercms.mintlify.site/docs/_mintlify/api/og/v2?division=Blog+posts\u0026amp;title=List+All+Posts\u0026amp;description=Retrieve+a+paginated+list+of+published+blog+posts+sorted+by+publication+date%2C+with+filtering+and+performance+options.\u0026amp;theme=5b7441fa906780c0ab866249\u0026amp;signature=dc5f1c66317317c6d3546d1955466edf9fd3ccd3012a818e1c992a441c0a26e1\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/buttercms/r9p2A1fiqo_BuZws/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ButterCMS Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0505e5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://buttercms.com/docs/api-reference/blog-posts/list-all-posts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/blog-posts/list-all-posts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://buttercms.com/#organization\",\"name\":\"ButterCMS Docs\",\"url\":\"https://buttercms.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://cdn.buttercms.com/nDD3LeMXQxiR9aJRpRLE\"}},{\"@type\":\"WebSite\",\"@id\":\"https://buttercms.com/docs#website\",\"name\":\"ButterCMS Docs\",\"url\":\"https://buttercms.com/docs\",\"publisher\":{\"@id\":\"https://buttercms.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://buttercms.com/docs/api-reference/blog-posts/list-all-posts#webpage\",\"url\":\"https://buttercms.com/docs/api-reference/blog-posts/list-all-posts\",\"name\":\"List All Posts\",\"description\":\"Retrieve a paginated list of published blog posts sorted by publication date, with filtering and performance options.\",\"dateModified\":\"2026-10-27T14:11:45.753Z\",\"isPartOf\":{\"@id\":\"https://buttercms.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://buttercms.com/docs/api-reference/blog-posts/list-all-posts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://buttercms.com/docs/api-reference/blog-posts/list-all-posts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Read API\",\"item\":\"https://buttercms.com/docs/api-reference/pages/get-multiple-pages\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List All Posts\",\"item\":\"https://buttercms.com/docs/api-reference/blog-posts/list-all-posts\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://buttercms.com/docs/api-reference/blog-posts/list-all-posts#apireference\",\"headline\":\"List All Posts\",\"name\":\"List All Posts\",\"description\":\"Retrieve a paginated list of published blog posts sorted by publication date, with filtering and performance options.\",\"url\":\"https://buttercms.com/docs/api-reference/blog-posts/list-all-posts\",\"mainEntityOfPage\":{\"@id\":\"https://buttercms.com/docs/api-reference/blog-posts/list-all-posts#webpage\"},\"dateModified\":\"2026-10-27T14:11:45.753Z\",\"publisher\":{\"@id\":\"https://buttercms.com/#organization\"},\"isPartOf\":{\"@id\":\"https://buttercms.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ButterCMS Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ButterCMS Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/blog-posts/list-all-posts.md","siteName":"ButterCMS Docs","nav":{"global":null,"tabs":[{"tab":"Quickstart","pages":[{"title":"Quickstart","href":""}]},{"tab":"Core concepts","pages":[{"title":"Core concepts","href":"/core-concepts/content-types/overview"}]},{"tab":"Create content","pages":[{"title":"Create content","href":"/create-content/overview"}]},{"tab":"Build your app","pages":[{"title":"Build your app","href":"/build-your-app/overview"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API overview","icon":"code","href":"/api/overview"},{"title":"API architecture \u0026 principles","icon":"sitemap","href":"/api/concepts/api-architecture-principles"},{"title":"Authentication \u0026 API tokens","icon":"key","href":"/api/concepts/authentication-api-tokens"},{"title":"Request/response format","icon":"code","href":"/api/concepts/request-response-format"},{"title":"REST endpoints \u0026 URLs","icon":"route","href":"/api/concepts/rest-endpoints-urls"},{"title":"HTTP status codes \u0026 errors","icon":"triangle-exclamation","href":"/api/concepts/http-status-codes-errors"},{"title":"Rate limits \u0026 throttling","icon":"gauge-high","href":"/api/concepts/rate-limits-throttling"},{"title":"Bulk Operations","icon":"layer-group","href":"/api/concepts/bulk-operations"},{"title":"Pages: key concepts","icon":"file","href":"/api/concepts/pages-key-concepts"},{"title":"Components: key concepts","icon":"layer-group","href":"/api/concepts/pages-components"},{"title":"Collections: key concepts","icon":"table","href":"/api/concepts/collections-key-concepts"},{"title":"Blog Posts: key concepts","icon":"newspaper","href":"/api/concepts/blog-posts-key-concepts"},{"title":"Webhooks: key concepts","icon":"bell","href":"/api/concepts/webhooks-overview"}]},{"group":"Read API","expanded":true,"pages":[{"group":"Pages","pages":[{"title":"Get multiple Pages","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /pages/{page_type}/","href":"/api-reference/pages/get-multiple-pages"},{"title":"Get a single Page","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /pages/{page_type}/{page_slug}/","href":"/api-reference/pages/get-a-single-page"},{"title":"Search Pages","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /pages/search/","href":"/api-reference/pages/search-pages"}]},{"group":"Collections","pages":[{"title":"Retrieve Multiple Collections by Key","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /content/","href":"/api-reference/collections/retrieve-multiple-collections-by-key"},{"title":"Retrieve Collection","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /content/{collection_key}/","href":"/api-reference/collections/retrieve-collection"},{"title":"Retrieve Collection Item","description":"Retrieve a single Collection item by its numeric item ID.","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /content/{collection_key}/{item_id}/","href":"/api-reference/collections/retrieve-collection-item"}]},{"group":"Blog posts","pages":[{"title":"List All Posts","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /posts/","href":"/api-reference/blog-posts/list-all-posts"},{"title":"Retrieve Single Post","description":"Retrieve a specific blog post by slug with complete content, metadata, and next/previous post navigation.","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /posts/{slug}/","href":"/api-reference/blog-posts/retrieve-single-post"},{"title":"Search Posts","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /posts/search/","href":"/api-reference/blog-posts/search-posts"}]},{"group":"Blog metadata","pages":[{"title":"List All Authors","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /authors/","href":"/api-reference/blog-metadata/list-all-authors"},{"title":"Retrieve Author","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /authors/{slug}/","href":"/api-reference/blog-metadata/retrieve-author"},{"title":"List All Categories","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /categories/","href":"/api-reference/blog-metadata/list-all-categories"},{"title":"Retrieve Category","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /categories/{slug}/","href":"/api-reference/blog-metadata/retrieve-category"},{"title":"List All Tags","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /tags/","href":"/api-reference/blog-metadata/list-all-tags"},{"title":"Retrieve Tag","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /tags/{slug}/","href":"/api-reference/blog-metadata/retrieve-tag"}]},{"group":"Feeds and utilities","pages":[{"title":"RSS Feed","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /feeds/rss/","href":"/api-reference/feeds-and-utilities/rss-feed"},{"title":"Atom Feed","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /feeds/atom/","href":"/api-reference/feeds-and-utilities/atom-feed"},{"title":"Sitemap","deprecated":null,"version":null,"openapi":"/api/openapi/read_api.yaml get /feeds/sitemap/","href":"/api-reference/feeds-and-utilities/sitemap"}]}]},{"group":"Write API","expanded":true,"pages":[{"group":"Pages","pages":[{"title":"Create Page via Write API","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml post /pages/","href":"/api-reference/pages/create-page-via-write-api"},{"title":"Update Page via Write API (PUT)","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml put /pages/{page_type}/{page_slug}/","href":"/api-reference/pages/update-page-via-write-api-put"},{"title":"Update Page via Write API","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml patch /pages/{page_type}/{page_slug}/","href":"/api-reference/pages/update-page-via-write-api"}]},{"group":"Collections","pages":[{"title":"Create Collection Item","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml post /content/","href":"/api-reference/collections/create-collection-item"},{"title":"Update Collection Item (Full)","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml put /content/{collection_key}/{item_id}/","href":"/api-reference/collections/update-collection-item-full"},{"title":"Delete Collection Item","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml delete /content/{collection_key}/{item_id}/","href":"/api-reference/collections/delete-collection-item"},{"title":"Update Collection Item (Partial)","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml patch /content/{collection_key}/{item_id}/","href":"/api-reference/collections/update-collection-item-partial"}]},{"group":"Blog posts","pages":[{"title":"Create Blog Post via Write API","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml post /posts/","href":"/api-reference/blog-posts/create-blog-post-via-write-api"},{"title":"Delete Blog Post via Write API","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml delete /posts/{slug}/","href":"/api-reference/blog-posts/delete-blog-post-via-write-api"},{"title":"Update Blog Post via Write API","deprecated":null,"version":null,"openapi":"/api/openapi/write_api.yaml patch /posts/{slug}/","href":"/api-reference/blog-posts/update-blog-post-via-write-api"}]}]},{"group":"Webhooks API","expanded":true,"pages":[{"group":"Page events","pages":[{"title":"Page published","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook page-published","href":"/api-reference/page-events/page-published"},{"title":"Page draft saved","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook page-draft-saved","href":"/api-reference/page-events/page-draft-saved"},{"title":"Page unpublished","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook page-unpublished","href":"/api-reference/page-events/page-unpublished"},{"title":"Page deleted","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook page-deleted","href":"/api-reference/page-events/page-deleted"},{"title":"Page any activity","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook page-any-activity","href":"/api-reference/page-events/page-any-activity"}]},{"group":"Post events","pages":[{"title":"Blog post published","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-published","href":"/api-reference/post-events/blog-post-published"},{"title":"Blog post draft saved","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-draft-saved","href":"/api-reference/post-events/blog-post-draft-saved"},{"title":"Blog post deleted","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-deleted","href":"/api-reference/post-events/blog-post-deleted"},{"title":"Blog post any activity","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-any-activity","href":"/api-reference/post-events/blog-post-any-activity"},{"title":"Localized blog post published","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-locale-published","href":"/api-reference/post-events/localized-blog-post-published"},{"title":"Localized blog post draft saved","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-locale-draft-saved","href":"/api-reference/post-events/localized-blog-post-draft-saved"},{"title":"Localized blog post deleted","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook blog-post-locale-deleted","href":"/api-reference/post-events/localized-blog-post-deleted"}]},{"group":"Collection events","pages":[{"title":"Collection item published","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook collection-item-published","href":"/api-reference/collection-events/collection-item-published"},{"title":"Collection item draft saved","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook collection-item-draft-saved","href":"/api-reference/collection-events/collection-item-draft-saved"},{"title":"Collection item unpublished","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook collection-item-unpublished","href":"/api-reference/collection-events/collection-item-unpublished"},{"title":"Collection item deleted","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook collection-item-deleted","href":"/api-reference/collection-events/collection-item-deleted"},{"title":"Collection item any activity","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook collection-item-any-activity","href":"/api-reference/collection-events/collection-item-any-activity"}]},{"group":"Media events","pages":[{"title":"Media video uploaded","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook media-video-uploaded","href":"/api-reference/media-events/media-video-uploaded"},{"title":"Media updated","version":null,"deprecated":null,"openapi":"/api/openapi/webhooks.yaml webhook media-updated","href":"/api-reference/media-events/media-updated"}]}]},{"group":"Image API","pages":[{"title":"Image transformations","icon":"wand-magic-sparkles","href":"/api/image-api/image-transformations"},{"title":"Responsive images","icon":"mobile","href":"/api/image-api/responsive-images"},{"title":"Security \u0026 authentication","icon":"shield","href":"/api/image-api/security-authentication"}]}]},{"tab":"Frameworks","pages":[{"title":"Frameworks","href":"/frameworks/tab-overview"}]},{"tab":"Support","pages":[{"title":"Support","href":"/support/account-management/account-settings"}]}]},"basePath":"","title":"List All Posts - ButterCMS Docs","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","CodeSnippet-CTZvgJfu.js","getApiPlaygroundDisplay-BK2o1XYu.js","Page--B9YZ09u.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}