Retrieve a paginated list of published blog posts sorted by publication date, with filtering and performance options.
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.Set the Authorization header to Token your_read_api_token.
Example: Authorization: Token abc123def456
Note: The header value includes the Token prefix.
You can access your API token from your settings page.
Page number for page-based pagination.
Mutually exclusive with limit/offset parameters.
x >= 1Number of items per page for page-based pagination.
Mutually exclusive with limit/offset parameters.
1 <= x <= 100Maximum number of items to return for offset-based pagination.
Mutually exclusive with page/page_size parameters.
1 <= x <= 100Number of items to skip before starting to return results.
Mutually exclusive with page/page_size parameters.
x >= 0Set 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.
0, 1 When true, excludes the full post body from the response.
Performance benefit: Significantly reduces response size when displaying lists of blog posts.
Filter posts by an author's slug.
Filter posts by a category's slug.
Filter posts by a tag's slug.
Your ButterCMS read API token
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.