List articles

GET 
/openapi/2026-01/articles

Retrieve a list of articles with optional filtering.

Request

Query Parameters

cursor string

Cursor for pagination

page_size int32

Page size, default 10

author string

Optional filter for author name

keyword string

Optional keyword to fuzzy-match article title/content

published boolean

Optional published-status filter: true = published only, false = drafts only, omit = all

page int32

Page number (1-based). Mutually exclusive with cursor

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

articles object[]

List of articles

Array [

idstring

Article ID

titlestring

Title of the article

excerptstring

Short summary or preview of the article content

contentstring

Full content of the article

image object

Image associated with the article containing src, width, height, and alt

srcstring

Image URL

widthint32

Width

heightint32

Height

pathstring

Path

publishedboolean

Whether the article is published or not

handlestring

URL-friendly identifier for the article

seo_titlestring

Custom SEO title

seo_descriptionstring

SEO meta description

seo_keywordsstring[]

SEO keywords

authorstring

Author of the article

published_atstring

ISO 8601 timestamp when article was published

blog_idsstring[]

Array of blog IDs this article belongs to

created_atstring

ISO 8601 timestamp when article was created

updated_atstring

ISO 8601 timestamp when article was last updated

]

cursorstring

Cursor for the next page

has_moreboolean

Whether there are more records

countint32

Total number of articles (from the backend)

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "articles": [
      {
        "id": "string",
        "title": "string",
        "excerpt": "string",
        "content": "string",
        "image": {
          "src": "string",
          "width": 0,
          "height": 0,
          "path": "string"
        },
        "published": true,
        "handle": "string",
        "seo_title": "string",
        "seo_description": "string",
        "seo_keywords": [
          "string"
        ],
        "author": "string",
        "published_at": "string",
        "blog_ids": [
          "string"
        ],
        "created_at": "string",
        "updated_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true,
    "count": 0
  }
}