**版本：202601**

# 查询文章列表

**GET** `/openapi/2026-01/articles`

分页返回文章列表，支持可选过滤条件。

## 请求

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

  每页记录数,默认 10
- `author` string

  作者
- `keyword` string

  关键词,模糊匹配文章标题/内容
- `published` boolean

  发布状态过滤:true 仅已发布、false 仅草稿、不传则全部
- `page` int32

  页码（从 1 开始），与 cursor 互斥

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `articles` object[]

    文章列表

    *   Array \[

    - `id` string

      文章 ID
    - `title` string

      文章标题
    - `excerpt` string

      文章内容的简短摘要或预览
    - `content` string

      文章完整内容
    - `image` object

      与文章关联的图片，包含 src、width、height 和 alt 属性

      - `src` string

        图片 URL
      - `width` int32

        宽度
      - `height` int32

        高度
      - `path` string

        路径
    - `published` boolean

      文章是否已发布
    - `handle` string

      文章的 URL 友好标识符
    - `seo_title` string

      自定义 SEO 标题
    - `seo_description` string

      SEO meta 描述
    - `seo_keywords` string[]

      SEO 关键词
    - `author` string

      文章作者
    - `published_at` string

      文章发布时间，ISO 8601 格式
    - `blog_ids` string[]

      该文章所属博客的 ID
    - `created_at` string

      文章创建时间，ISO 8601 格式
    - `updated_at` string

      文章最后更新时间，ISO 8601 格式
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录
  - `count` int32

    文章总数（底层返回）

```json
{
  "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
  }
}
```