---
title: "Search"
method: GET
path: "/api/search"
tags: ["search"]
---

# Search

`GET /api/search`

## Request

- Base URL: `https://fojin.app` (the document declares no server; this is the origin it was published from)
- URL: `https://fojin.app/api/search`
- Auth: none declared

Search Buddhist texts by title, ID, translator, etc. with faceted filtering.

搜索佛教典籍。支持经名、编号、译者等多字段搜索，可按藏经、语言、朝代、部类和数据源筛选。

## Query parameters

- `q` string: 搜索关键词
- `page` integer: 页码
- `size` integer: 每页数量
- `dynasty` string, nullable: 朝代筛选，逗号分隔多选
- `category` string, nullable: 分类筛选
- `lang` string, nullable: 语言筛选，逗号分隔多选 (lzh/pi/sa/bo/en)
- `sources` string, nullable: 数据源筛选，逗号分隔 (cbeta,suttacentral,gretil)
- `sort` string, nullable: 排序方式 (relevance/title/dynasty)
- `canon` string, nullable: 藏经筛选，逗号分隔 (taisho/xuzang/pali/kangyur/gretil…)
- `section` string, nullable: 大正藏部类筛选，逗号分隔 (agama/prajna/avatamsaka/vinaya…)
- `facets` boolean: 同时返回 藏经/语言/朝代/部类 四组分面计数

## Response `200`

Successful Response

- SearchResponse
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required
  - `results` SearchHit[], required
    - `id` integer, required
    - `taisho_id` string, nullable
    - `cbeta_id` string, required
    - `title_zh` string, required
    - `translator` string, nullable
    - `dynasty` string, nullable
    - `category` string, nullable
    - `cbeta_url` string, nullable
    - `has_content` boolean
    - `source_code` string, nullable
    - `score` number, nullable
    - `highlight` object, nullable
    - `related_translations` RelatedTranslation[]
      - `id` integer, required
      - `title` string, required
      - `lang` string, required
      - `relation_type` string, required
  - `suggestion` string, nullable
  - `facets` object, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fojin/apis/fojin-api-buddhist-digital-text-platform.md) · [All operations](https://skmtc.dev/fojin/apis/fojin-api-buddhist-digital-text-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/fojin/apis/fojin-api-buddhist-digital-text-platform/revisions/969714238c61?raw)