# Pages - Read

Retrieve pages from your ButterCMS account.

**Single Pages**: Use `*` as the page_type to get Single Pages (those without a Page Type) which represent unique pages on your site like your Homepage. Useful for creating your sitemap.xml.

**Page Type Pages**: Use the actual page type slug to get pages of that specific type. Page Types allow you to create many pages with the same structure.

**Note:** The fields of a page are defined by you, they are customizable. Sample responses below contain a basic set of fields for illustrative purposes.


## Get multiple Pages

 - [GET /pages/{page_type}/](https://api.docs.buttercms.com/pages-read/getmultiplepages.md): Retrieve a paginated list of pages for a given page type, or all Single Pages when using the wildcard * as the page type. This endpoint supports comprehensive filtering and sorting for Page Type collections.

Single Pages: Use * to retrieve Single Pages, which are unique pages like your Homepage, About page, or Contact page. This is particularly useful for generating sitemaps or building navigation structures that include your standalone pages.

Page Type Collections: Use the actual page type slug to retrieve all pages that follow the same structural template. This allows you to fetch collections like all news articles, product pages, or blog posts that share the same field schema.

> Important: Advanced filtering and ordering capabilities are only available for Page Type endpoints, not when retrieving Single Pages with the * wildcard. Use dotted notation for field filters (e.g., fields.title=Home).
See also: Architecture & Performance for guidance on levels, pagination, and performance best practices.

## Get a single Page

 - [GET /pages/{page_type}/{page_slug}/](https://api.docs.buttercms.com/pages-read/getsinglepage.md): Retrieve a specific page by its page type and slug. This endpoint is ideal for fetching individual pages for display on your website or application.

Page Type Flexibility: You can search across all page types using * as a wildcard, or optimize your query by providing a specific page type slug. Using the wildcard is useful when you know the page slug but aren't certain of its type, while specifying the page type can improve query performance. Use dotted notation for field filters (e.g., fields.title=Example).
See also: Architecture & Performance for guidance on levels, pagination, and performance best practices.

## Search Pages

 - [GET /pages/search/](https://api.docs.buttercms.com/pages-read/searchpages.md): Search for pages using a text query, returning a list of pages that match the search query sorted by relevancy. This endpoint provides flexible page discovery capabilities across your entire page structure.

Search Behavior: Only the direct content of the Pages is searched. Any references that the Page might include are ignored during search, but references are still included in the response based on the levels parameter provided. Pages are returned sorted by relevancy to the search query.

Page Type Filtering: You can optionally limit your search to a specific page type, or search only Single Pages using * as the page type parameter.

Empty Results: If no results are found, the API returns an empty array: "data": []
See also: Architecture & Performance for guidance on levels, pagination, and performance best practices.