---
title: "List published articles"
method: GET
path: "/api/v1/articles"
tags: ["Articles"]
---

# List published articles

`GET /api/v1/articles`

## Request

- Base URL: `https://saaskly.com`
- URL: `https://saaskly.com/api/v1/articles`
- Auth: none declared

## Query parameters

- `limit` integer
- `page` integer
- `sort` string
- `depth` integer
- `where` object
- `where[contentType][equals]` 'comparison' | 'buying-guide' | 'review' | 'news' | 'opinion'

## Response `200`

Paginated result

- object
  - `docs` Article[], required
    - `id` integer, required
    - `title` string, required
    - `slug` string, required
    - `contentType` 'comparison' | 'buying-guide' | 'review' | 'news' | 'opinion', required
    - `excerpt` string, nullable
    - `body` RichText: Lexical editor JSON. Prefer the `.md` mirror for prose.
    - `categories` union[]
      - union
        - integer
        - Category
          - `id` integer, required
          - `name` string, required
          - `slug` string, required
          - `description` string, nullable
          - `updatedAt` string, date-time
    - `publishedDate` string, date-time, nullable
    - `sponsored` boolean
    - `updatedAt` string, date-time
  - `totalDocs` integer, required
  - `limit` integer, required
  - `page` integer, required
  - `totalPages` integer, required
  - `hasNextPage` boolean, required
  - `hasPrevPage` boolean, required
  - `nextPage` integer, nullable
  - `prevPage` integer, nullable
  - `pagingCounter` integer

## Other responses

- `400`: Error
- `403`: Error
- `404`: Error
- `429`: Too many requests — 300 per 60 s per client IP. Wait `Retry-After` seconds.
- `500`: Error

---

[API](https://skmtc.dev/saaskly/apis/saaskly-public-read-api.md) · [All operations](https://skmtc.dev/saaskly/apis/saaskly-public-read-api/llms.txt) · [OpenAPI document](https://skmtc.dev/saaskly/apis/saaskly-public-read-api/revisions/93e336357193?raw)