Posts

List Posts

Retrieve a list of published posts from the blog. You can specify page number and size, and include tag or author information.

The post body (content_html) is not included in list responses. Request it explicitly with fields[posts] when you need it.

get/posts

Query parameters

pageinteger

Example:1

Page number (starting from 1) JSON:API style page[number] is also accepted.

limitinteger

Example:10

Items per page JSON:API style page[size] is also accepted.

fields[posts]string

Example:title,slug,content_html

Comma-separated post fields to return. Unknown names are ignored. Include content_html to request the post body, which is omitted by default.

includestring

Example:tags,authors

Specify related resources to include, separated by commas

Available values for Posts:

tags - Post tags
authors - Post authors

filter[slug]string

Example:my-post

Filter by slug. Returns only posts with an exact match.

filter[published]boolean

Example:true

Filter by published status.

filter[published_at_gte]string date-time

Example:2024-01-01

Return only posts published on or after this date. (ISO 8601 format)

filter[published_at_lte]string date-time

Example:2024-12-31

Return only posts published on or before this date. (ISO 8601 format)

filter[tag_id]integer

Example:123

Return only posts with the specified tag.

filter[author_id]string uuid

Example:550e8400-e29b-41d4-a716-446655440000

Return only posts by the specified author.

filter[content_type]'tiptap' | 'notion'

Example:tiptap

Filter by content type.

sort'published_at' | 'created_at' | 'updated_at' | 'title'

Example:published_at

Sort field.

order'asc' | 'desc'

Example:desc

Sort direction.

Response

Post list retrieved successfully

Changes

No recorded changes to this endpoint across all 1 revision of this API.