裁判文书API接口查询
检索中国裁判文书(官方公开,出处可回溯)。自然语言 query + 可选结构化 filters。
已开放
调用入口：POST /v1/data/query。
请求体字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| domain | string | 数据域（必填） | legal |
| type | string | 数据类型（必填） | case |
| query | string | 自然语言检索词 | 民间借贷 利息 |
| filters | object | 结构化过滤条件，见下方「常用 filters」 | — |
| top_k | integer | 分页参数：每页条数，取值范围 1–100，本能力默认 5 | 5 |
常用 filters
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| cause | string | 案由关键词(模糊) | 买卖合同纠纷 |
| case_type | string | 案件类型:刑事/民事/行政/执行/国家赔偿 | 民事 |
| court_level | string | 法院层级:基层/中级/高级/最高 | 中级 |
| trial_procedure | string | 审判程序:一审/二审/申请再审/再审/执行 | 二审 |
| province | string | 省级行政区 | 北京市 |
| year_start | integer | 裁判年份下界(含) | 2020 |
| year_end | integer | 裁判年份上界(含) | 2023 |
| offset | integer | 分页参数：偏移量（默认 0；配合顶层 top_k 翻页，建议为 top_k 的整数倍） | 0 |
返回字段（hits[]）
| 字段 | 类型 | 说明 |
|---|---|---|
| case_no | string | 案号 |
| court_name | string | 审理法院 |
| cause_of_action | string | 案由 |
| case_type | string | 案件类型 |
| judgment_date | string | 裁判日期 |
| judgment_result | string | 裁判结果 |
| summary | string | 案件摘要 |
| applied_laws | list | 引用法条 |
curl 请求示例
curl -sS -X POST https://data.devnors.com/v1/data/query \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domain":"legal", "type":"case", "query":"民间借贷 利息", "filters":{ "cause":"买卖合同纠纷", "case_type":"民事", "court_level":"中级", "trial_procedure":"二审", "province":"北京市", "year_start":2020, "year_end":2023, "offset":0 }, "top_k":5 }'将 YOUR_API_KEY 替换为控制台签发的密钥。完整字段与响应约定见 统一查询。