STATIC API DOCUMENT

法律法规语义检索接口 API 文档

按自然语言query做法条级语义检索，可按时效性、一级效力级别和实施日期范围过滤。返回结果在extra.fatiao，每条主要是法条内容及所属法规信息，不是整部法规全文列表；如需法规详情需再用法规 ID 调详情接口。

接口详情页分类：法律法规 MCP Tool：yuandian_law_vector_search

接口概览

接口名称	法律法规语义检索接口
接口描述	按自然语言query做法条级语义检索，可按时效性、一级效力级别和实施日期范围过滤。返回结果在extra.fatiao，每条主要是法条内容及所属法规信息，不是整部法规全文列表；如需法规详情需再用法规 ID 调详情接口。
接口分类	法律法规
调用地址	`https://open.chineselaw.com/open/law_vector_search`
请求方式	POST

请求参数

3. 请求参数（Body）

3.1 字段说明

字段名	类型	是否必填	说明
`query`	string	是	待检索问题 / 查询文本
`rewrite_flag`	boolean	否	是否对查询做改写，默认为`true`
`fatiao_filter`	object	否	法律法规检索过滤条件，详细内容见字段说明
`return_num`	int	否	返回法律法规数量（默认为45，最大不超过检索回的法律法规总数）

3.1.1 `fatiao_filter`字段说明

以下字段均为可选字段

字段名	类型	是否必填	说明
`sxx`	string[]	否	时效性，见下表「时效性类别」
`effect1`	string[]	否	一级效力级别，见下表「一级效力级别类别」
`law_start`	string	否	过滤实施日期在此时间之后，含当前日期，`YYYY-MM-DD`
`law_end`	string	否	过滤实施日期在此时间之前，含当前日期，`YYYY-MM-DD`

3.1.2 时效性类别（`sxx`）

时效性类别
现行有效
失效
已被修改
部分失效
尚未生效

3.1.3 一级效力级别类别（`effect1`）

一级效力级别类别
宪法
法律
司法解释
行政法规
监察法规
部门规章
党内法规
军事法规规章
立法机关工作文件
行政机关工作文件
行业/团体规范
地方性法规
自治条例和单行条例
地方司法文件
地方政府规章
地方规范性文件
地方律协规定

响应参数

4. 返回信息

- 返回类型：JSON 字符串

- 成功/失败判断：看 msg 与 code（HTTP 401为鉴权失败）

- code说明

code	说明
201	接口调用成功
401	鉴权失败

4.1 通用返回结构

字段名	类型	说明
`msg`	string	返回状态说明
`code`	int	非 200/201 均为异常情形
`extra`	object	检索到的数据结果，只需要取`fatiao`字段值，其他字段值为其他数据源结果（为空list）

4.2 `extra`对象的`fatiao`字段，包含

字段名	类型	说明
`ftid`	string	法条id
`fgid`	string	法规id
`fgtitle`	string[]	法规名称
`num`	string	法条条目
`content`	string	内容
`type`	string	内容类型（1-法条、2-法规、3-题注）
`sxx`	string	时效性
`effect1`	string	一级效力级别
`effect2`	string	二级效力级别
`dy`	string	地域
`location`	string	地域含市
`start`	int	实施日期
`end`	int	失效日期
`score`	float	相似度评分

错误码

错误码	说明
401	鉴权失败

调用示例

CURL

curl --location --request POST 'https://open.chineselaw.com/open/law_vector_search' \
--header 'X-API-Key: 你的api_key' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'Accept: application/json' \
--data-raw '{"query":"入户盗窃","rewrite_flag":false,"fatiao_filter":{"effect1":["法律"],"law_start":"2018-01-01","law_end":"2025-12-31","sxx":["现行有效"]},"return_num":2}'

JAVA

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

class CaseVectorSearchExample {

    static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "https://open.chineselaw.com/open/law_vector_search";
        String body = "{\"query\":\"入户盗窃\",\"rewrite_flag\":false,\"fatiao_filter\":"
                + "{\"effect1\":[\"法律\"],\"law_start\":\"2018-01-01\",\"law_end\":\"2025-12-31\","
                + "\"sxx\":[\"现行有效\"]},\"return_num\":2}";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .timeout(Duration.ofSeconds(60))
                .header("X-API-Key", apiKey)
                .header("Content-Type", "application/json; charset=utf-8")
                .header("Accept", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(body))
                .build();

        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

PYTHON

import requests

url = "https://open.chineselaw.com/open/law_vector_search"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
}
payload = {
    "query": "入户盗窃",
    "rewrite_flag": False,
    "fatiao_filter": {
        "effect1": ["法律"],
        "law_start": "2018-01-01",
        "law_end": "2025-12-31",
        "sxx": ["现行有效"],
    },
    "return_num": 2,
}

response = requests.post(url, json=payload, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

JAVASCRIPT

const API_KEY = "你的api_key";
const url = "https://open.chineselaw.com/open/law_vector_search";

const res = await fetch(url, {
  method: "POST",
  headers: {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
  },
  body: JSON.stringify({
    query: "入户盗窃",
    rewrite_flag: false,
    fatiao_filter: {
      effect1: ["法律"],
      law_start: "2018-01-01",
      law_end: "2025-12-31",
      sxx: ["现行有效"],
    },
    return_num: 2,
  }),
});

if (!res.ok) throw new Error(`HTTP NULL`);
console.log(await res.json());

MCP Tool 名称

MCP Server	yuandian-law（法律法规 Server）
Streamable HTTP 入口	`https://open.chineselaw.com/mcp/law/stream`
MCP Tool	`yuandian_law_vector_search`

响应示例

{
    "msg": "成功(返回结构化数据)",
    "code": 201,
    "answer": "",
    "extra": {
        "fatiao": [
            {
                "ftid": "aecabfbe6b0843642509a7f1ff865413_264",
                "fgid": "aecabfbe6b0843642509a7f1ff865413",
                "fgtitle": "中华人民共和国刑法(2023修正)",
                "num": "第二百六十四条",
                "content": "　【盗窃罪】盗窃公私财物，数额较大的，或者多次盗窃、入户盗窃、携带凶器盗窃、扒窃的，处三年以下有期徒刑、拘役或者管制，并处或者单处罚金；数额巨大或者有其他严重情节的，处三年以上十年以下有期徒刑，并处罚金；数额特别巨大或者有其他特别严重情节的，处十年以上有期徒刑或者无期徒刑，并处罚金或者没收财产。",
                "sxx": "现行有效",
                "effect1": "法律",
                "tag": [],
                "effect2": "法律",
                "location": "中央",
                "start": 20240301,
                "end": 99999999,
                "dy": "中央",
                "score": 1.107480312,
                "type": 1
            },
            {
                "ftid": "aecabfbe6b0843642509a7f1ff865413_263",
                "fgid": "aecabfbe6b0843642509a7f1ff865413",
                "fgtitle": "中华人民共和国刑法(2023修正)",
                "num": "第二百六十三条",
                "content": "　【抢劫罪】以暴力、胁迫或者其他方法抢劫公私财物的，处三年以上十年以下有期徒刑，并处罚金；有下列情形之一的，处十年以上有期徒刑、无期徒刑或者死刑，并处罚金或者没收财产：\n（一）入户抢劫的；\n（二）在公共交通工具上抢劫的；\n（三）抢劫银行或者其他金融机构的；\n（四）多次抢劫或者抢劫数额巨大的；\n（五）抢劫致人重伤、死亡的；\n（六）冒充军警人员抢劫的；\n（七）持枪抢劫的；\n（八）抢劫军用物资或者抢险、救灾、救济物资的。",
                "sxx": "现行有效",
                "effect1": "法律",
                "tag": [],
                "effect2": "法律",
                "location": "中央",
                "start": 20240301,
                "end": 99999999,
                "dy": "中央",
                "score": 0.6297119999999999,
                "type": 1
            }
        ]
    },
    "messageId": "",
    "style": "",
    "request_id": ""
}

完整文档

1. 基本信息

- 接口名称：法律法规语义检索接口

- 接口用途：按自然语言query做法条级语义检索，可按时效性、一级效力级别和实施日期范围过滤。返回结果在extra.fatiao，每条主要是法条内容及所属法规信息，不是整部法规全文列表；如需法规详情需再用法规 ID 调详情接口。

2. 请求信息

- HTTP Method：POST

- URL：https://open.chineselaw.com/open/law_vector_search

- Content-Type：application/json; charset=utf-8

- X-API-Key：你的api_key

- 请求体：JSON

3. 请求参数（Body）

3.1 字段说明

字段名	类型	是否必填	说明
`query`	string	是	待检索问题 / 查询文本
`rewrite_flag`	boolean	否	是否对查询做改写，默认为`true`
`fatiao_filter`	object	否	法律法规检索过滤条件，详细内容见字段说明
`return_num`	int	否	返回法律法规数量（默认为45，最大不超过检索回的法律法规总数）

3.1.1 `fatiao_filter`字段说明

> 以下字段均为可选字段

字段名	类型	是否必填	说明
`sxx`	string[]	否	时效性，见下表「时效性类别」
`effect1`	string[]	否	一级效力级别，见下表「一级效力级别类别」
`law_start`	string	否	法条生效起始日期，`YYYY-MM-DD`
`law_end`	string	否	法条生效结束日期，`YYYY-MM-DD`

3.1.2 时效性类别（`sxx`）

时效性类别
现行有效
失效
已被修改
部分失效
尚未生效

3.1.3 一级效力级别类别（`effect1`）

一级效力级别类别
宪法
法律
司法解释
行政法规
监察法规
部门规章
党内法规
军事法规规章
立法机关工作文件
行政机关工作文件
行业/团体规范
地方性法规
自治条例和单行条例
地方司法文件
地方政府规章
地方规范性文件
地方律协规定

4. 返回信息

- 返回类型：JSON 字符串

- 成功/失败判断：看 msg 与 code（HTTP 401为鉴权失败）

- code说明

code	说明
201	接口调用成功
401	鉴权失败

4.1 通用返回结构

字段名	类型	说明
`msg`	string	返回状态说明
`code`	int	非 200/201 均为异常情形
`extra`	object	检索到的数据结果，只需要取`fatiao`字段值，其他字段值为其他数据源结果（为空list）

4.2 `extra`对象的`fatiao`字段，包含

字段名	类型	说明
`ftid`	string	法条id
`fgid`	string	法规id
`fgtitle`	string[]	法规名称
`num`	string	法条条目
`content`	string	内容
`type`	string	内容类型（1-法条、2-法规、3-题注）
`sxx`	string	时效性
`effect1`	string	一级效力级别
`effect2`	string	二级效力级别
`dy`	string	地域
`location`	string	地域含市
`start`	int	实施日期
`end`	int	失效日期
`score`	float	相似度评分

5. 示例

5.1 请求示例

{
  "query": "入户盗窃",
  "rewrite_flag": false,
  "fatiao_filter": {
    "effect1": ["法律"],
    "sxx": ["现行有效"],
    "law_start": "2018-01-01",
    "law_end": "2025-12-31"
  },
  "return_num": 2
}

5.2 成功响应示例

{
    "msg": "成功(返回结构化数据)",
    "code": 201,
    "answer": "",
    "extra": {
        "fatiao": [
            {
                "ftid": "aecabfbe6b0843642509a7f1ff865413_264",
                "fgid": "aecabfbe6b0843642509a7f1ff865413",
                "fgtitle": "中华人民共和国刑法(2023修正)",
                "num": "第二百六十四条",
                "content": "　【盗窃罪】盗窃公私财物，数额较大的，或者多次盗窃、入户盗窃、携带凶器盗窃、扒窃的，处三年以下有期徒刑、拘役或者管制，并处或者单处罚金；数额巨大或者有其他严重情节的，处三年以上十年以下有期徒刑，并处罚金；数额特别巨大或者有其他特别严重情节的，处十年以上有期徒刑或者无期徒刑，并处罚金或者没收财产。",
                "sxx": "现行有效",
                "effect1": "法律",
                "tag": [],
                "effect2": "法律",
                "location": "中央",
                "start": 20240301,
                "end": 99999999,
                "dy": "中央",
                "score": 1.107480312,
                "type": 1
            },
            {
                "ftid": "aecabfbe6b0843642509a7f1ff865413_263",
                "fgid": "aecabfbe6b0843642509a7f1ff865413",
                "fgtitle": "中华人民共和国刑法(2023修正)",
                "num": "第二百六十三条",
                "content": "　【抢劫罪】以暴力、胁迫或者其他方法抢劫公私财物的，处三年以上十年以下有期徒刑，并处罚金；有下列情形之一的，处十年以上有期徒刑、无期徒刑或者死刑，并处罚金或者没收财产：\n（一）入户抢劫的；\n（二）在公共交通工具上抢劫的；\n（三）抢劫银行或者其他金融机构的；\n（四）多次抢劫或者抢劫数额巨大的；\n（五）抢劫致人重伤、死亡的；\n（六）冒充军警人员抢劫的；\n（七）持枪抢劫的；\n（八）抢劫军用物资或者抢险、救灾、救济物资的。",
                "sxx": "现行有效",
                "effect1": "法律",
                "tag": [],
                "effect2": "法律",
                "location": "中央",
                "start": 20240301,
                "end": 99999999,
                "dy": "中央",
                "score": 0.6297119999999999,
                "type": 1
            }
        ]
    },
    "messageId": "",
    "style": "",
    "request_id": ""
}

6. 代码示例

6.1 CURL

curl --location --request POST 'https://open.chineselaw.com/open/law_vector_search' \
--header 'X-API-Key: 你的api_key' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'Accept: application/json' \
--data-raw '{"query":"入户盗窃","rewrite_flag":false,"fatiao_filter":{"effect1":["法律"],"law_start":"2018-01-01","law_end":"2025-12-31","sxx":["现行有效"]},"return_num":2}'

6.2 Python

import requests

url = "https://open.chineselaw.com/open/law_vector_search"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
}
payload = {
    "query": "入户盗窃",
    "rewrite_flag": False,
    "fatiao_filter": {
        "effect1": ["法律"],
        "law_start": "2018-01-01",
        "law_end": "2025-12-31",
        "sxx": ["现行有效"],
    },
    "return_num": 2,
}

response = requests.post(url, json=payload, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

6.3 Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

class CaseVectorSearchExample {

    static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "https://open.chineselaw.com/open/law_vector_search";
        String body = "{\"query\":\"入户盗窃\",\"rewrite_flag\":false,\"fatiao_filter\":"
                + "{\"effect1\":[\"法律\"],\"law_start\":\"2018-01-01\",\"law_end\":\"2025-12-31\","
                + "\"sxx\":[\"现行有效\"]},\"return_num\":2}";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .timeout(Duration.ofSeconds(60))
                .header("X-API-Key", apiKey)
                .header("Content-Type", "application/json; charset=utf-8")
                .header("Accept", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(body))
                .build();

        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

6.4 JavaScript

const API_KEY = "你的api_key";
const url = "https://open.chineselaw.com/open/law_vector_search";

const res = await fetch(url, {
  method: "POST",
  headers: {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
  },
  body: JSON.stringify({
    query: "入户盗窃",
    rewrite_flag: false,
    fatiao_filter: {
      effect1: ["法律"],
      law_start: "2018-01-01",
      law_end: "2025-12-31",
      sxx: ["现行有效"],
    },
    return_num: 2,
  }),
});

if (!res.ok) throw new Error(`HTTP NULL`);
console.log(await res.json());

法律法规语义检索接口 API 文档

接口概览

请求参数

3. 请求参数（Body）

3.1 字段说明

3.1.1 fatiao_filter字段说明

3.1.2 时效性类别（sxx）

3.1.3 一级效力级别类别（effect1）

响应参数

4. 返回信息

4.1 通用返回结构

4.2 **extra对象的fatiao**字段，包含

错误码

调用示例

CURL

JAVA

PYTHON

JAVASCRIPT

MCP Tool 名称

响应示例

完整文档

1. 基本信息

2. 请求信息

3. 请求参数（Body）

3.1 字段说明

3.1.1 fatiao_filter字段说明

3.1.2 时效性类别（sxx）

3.1.3 一级效力级别类别（effect1）

4. 返回信息

4.1 通用返回结构

4.2 **extra对象的fatiao**字段，包含

5. 示例

5.1 请求示例

5.2 成功响应示例

6. 代码示例

6.1 CURL

6.2 Python

6.3 Java

6.4 JavaScript

3.1.1 `fatiao_filter`字段说明

3.1.2 时效性类别（`sxx`）

3.1.3 一级效力级别类别（`effect1`）

4.2 `extra`对象的`fatiao`字段，包含

3.1.1 `fatiao_filter`字段说明

3.1.2 时效性类别（`sxx`）

3.1.3 一级效力级别类别（`effect1`）

4.2 `extra`对象的`fatiao`字段，包含