Skip to main content
GET
List posts

Authorizations

Authorization
string
header
required

Your Marble API key

Query Parameters

limit
integer

Number of posts per page (1-100)

Example:

10

page
integer

Page number

Example:

1

order
enum<string>
default:desc

Sort order by publishedAt

Available options:
asc,
desc
Example:

"desc"

categories
string[]

Category slugs to include

Example:
excludeCategories
string[]

Category slugs to exclude

Example:
tags
string[]

Tag slugs to include

Example:
excludeTags
string[]

Tag slugs to exclude

Example:
query
string

Search query for title and content

Example:

"nextjs"

format
enum<string>

Content format (html or markdown)

Available options:
html,
markdown
Example:

"html"

Filter by featured status

Available options:
true,
false
Example:

"true"

status
enum<string>
default:published

Filter by post status. Use 'published' for live posts, 'draft' for unpublished posts, or 'all' for both.

Available options:
published,
draft,
all
Example:

"published"

Response

Paginated list of posts

posts
object[]
required
pagination
object
required