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

# Semantic Search

`GET /api/search/semantic`

## 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/semantic`
- Auth: none declared

Semantic search using pgvector embedding similarity.

语义搜索。基于向量相似度在 34.7 万段经文中检索语义最相关的内容。支持按朝代、分类、语言和数据源筛选。

## Query parameters

- `q` string: 语义搜索关键词
- `size` integer: 返回数量
- `dynasty` string, nullable: 朝代筛选
- `category` string, nullable: 分类筛选
- `lang` string, nullable: 语言筛选 (lzh/pi/sa/bo/en)
- `sources` string, nullable: 数据源筛选，逗号分隔 (cbeta,suttacentral,gretil)
- `canon` string, nullable: 藏经筛选，逗号分隔 (taisho/xuzang/pali/kangyur/gretil…)
- `section` string, nullable: 大正藏部类筛选，逗号分隔 (agama/prajna/avatamsaka/vinaya…)

## Response `200`

Successful Response

- SemanticSearchResponse: 语义搜索响应
  - `total` integer, required
  - `results` SemanticSearchHit[], required
    - `text_id` integer, required
    - `juan_num` integer, required
    - `title_zh` string, required
    - `translator` string, nullable
    - `dynasty` string, nullable
    - `category` string, nullable
    - `source_code` string, nullable
    - `cbeta_id` string, nullable
    - `cbeta_url` string, nullable
    - `has_content` boolean
    - `snippet` string, required
    - `similarity_score` number, required
  - `error` string, 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)