---
title: "List blog posts for the authenticated website."
method: GET
path: "/api/v1/posts"
tags: ["Posts"]
---

# List blog posts for the authenticated website.

`GET /api/v1/posts`

## Request

- Base URL: `https://api.unicornplatform.com`
- URL: `https://api.unicornplatform.com/api/v1/posts`
- Auth: HTTP bearer

## Query parameters

- `page` integer
- `perPage` integer
- `includeHtml` boolean
- `published` boolean
- `slug` string
- `directory` string
- `updatedSince` string, date-time
- `q` string
- `sort` '-updatedAt' | 'updatedAt' | '-createdAt' | 'createdAt' | '-headline' | 'headline'

## Response `200`

Paginated post list.

- PostList
  - `items` Post[], required
    - `id` string, required
    - `headline` string, required
    - `metaTitle` string, required
    - `metaDescription` string, required
    - `thumbnailUrl` string, required
    - `html` string: Present when includeHtml is true, and included by default for detail endpoints.
    - `slug` string, required
    - `directory` string, required
    - `path` string, required
    - `url` string, required
    - `published` boolean, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `page` integer, required
  - `perPage` integer, required
  - `total` integer, required
  - `hasMore` boolean, required

## Other responses

- `400`: Invalid query parameter.
- `401`: Missing or invalid bearer token.
- `404`: The authenticated website has no active blog.

---

[API](https://skmtc.dev/unicornplatform/apis/unicorn-platform-partner-api.md) - [All operations](https://skmtc.dev/unicornplatform/apis/unicorn-platform-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unicornplatform/apis/unicorn-platform-partner-api/revisions/809eeac0c51c?raw)