# Blog Posts - Read

Retrieve blog posts from your ButterCMS account. List blog posts with pagination and filtering options, or retrieve individual posts by slug.


## List All Posts

 - [GET /posts/](https://api.docs.buttercms.com/blog-posts-read/listallposts.md): 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.

## Retrieve Single Post

 - [GET /posts/{slug}/](https://api.docs.buttercms.com/blog-posts-read/retrievesinglepost.md): Retrieve a specific blog post by its unique slug, including complete post content, metadata, and navigation information. This endpoint is ideal for building individual blog post pages with full content display.

Universal Access: This endpoint retrieves posts regardless of their publication status (published, draft, or scheduled), making it perfect for preview functionality and content management workflows. Note that draft and scheduled posts won't appear in listing endpoints unless preview mode is specifically enabled.

Navigation Support: The response includes a helpful meta object containing next_post and previous_post navigation links, allowing you to easily implement "Previous/Next" navigation on your blog post pages without additional API calls.

> Important: You must append a trailing slash to the URL path: /v2/posts/your-post-slug/. This is required for the endpoint to function correctly.