---
title: "Blog index"
method: GET
path: "/api/v1/articles"
tags: ["Public read (v1)"]
---

# Blog index

`GET /api/v1/articles`

## Request

- Base URL: `https://dribba.com`
- URL: `https://dribba.com/api/v1/articles`
- Auth: none required

Published articles with metadata and the URL of their markdown representation. Paginated: pass `limit` to slice it and follow `next_cursor` until it is null.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Blog index

- ArticleList: Paginated blog index.
  - `count` integer, required: Items in this page.
  - `total` integer, required: Items in the whole collection.
  - `next_cursor` string, nullable, required: Cursor for the next page, or null when there are no more items. Opaque: pass it back verbatim.
  - `items` Article[], required
    - `slug` string, required
    - `title` string, required
    - `url` string, uri, required
    - `description` string, required
    - `category` string
    - `tags` string[]
    - `author` string
    - `publishedAt` string, date, nullable
    - `updatedAt` string, date, nullable
    - `readTime` string
    - `markdown_url` string, uri: Same article as text/markdown.

## Other responses

- `404`: The route or the resource does not exist
- `405`: Method not supported by this endpoint
- `429`: Rate limit exceeded
- `500`: Unexpected server error

---

[API](https://skmtc.dev/dribba/apis/dribba-public-api.md) · [All operations](https://skmtc.dev/dribba/apis/dribba-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dribba/apis/dribba-public-api/revisions/694a12831fd4?raw)