---
title: "List a blog's published posts (paginated, 30/page)"
method: GET
path: "/blog/posts"
---

# List a blog's published posts (paginated, 30/page)

`GET /blog/posts`

## Request

- Base URL: `https://api.vakantio.de`
- URL: `https://api.vakantio.de/blog/posts`
- Auth: none required

A single blog's published posts in reverse-chronological order, 30 per page. No authentication required for public blogs.

## Query parameters

- `path` string, required
- `page` integer

## Response `200`

Post list

- object
  - `items` PostSummary[]
    - `_id` string
    - `title` string
    - `preview` string
    - `tags` string[]
    - `topics` string[]
    - `path` string: URL slug (assigned at first publish)
    - `fullPath` string: Public URL path: /<blogPath>/<slug>
    - `blogName` string
    - `likeCount` number
    - `commentCount` number
    - `datePublished` number: Unix ms
    - `dateTraveled` number: Unix ms
  - `totalCount` integer

## Other responses

- `4XX`: Client error — JSON body with a stable `error` code (e.g. not_found, not_authenticated, request_failed) and an optional `hint`.
- `5XX`: Server error — JSON body with `error: "server_error"`.

---

[API](https://skmtc.dev/vakantio/apis/vakantio-api.md) · [All operations](https://skmtc.dev/vakantio/apis/vakantio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vakantio/apis/vakantio-api/revisions/2e1306807326?raw)