法律案例 API
最后更新: 2026-06-21
法律案例 API 让 Agent 用 legal_cases 检索类案、案由、年份和地区，归纳裁判口径，返回可引用的案号、裁判要旨和摘要，支撑法律分析与文书论证。
数据覆盖：覆盖 1985–2025,案件级全文陆续开放
| source | legal_cases |
|---|---|
| 典型 filters | judgment_year, cause_terms, region_name, case_type |
| query | 完整自然语言意图，如“交通事故车辆贬值损失赔偿是否支持” |
| 返回格式 | 默认 markdown，可请求 return.format=json |
| 适用任务 | 类案检索、裁判口径归纳、文书论证素材 |
什么时候用法律案例 API
filters 和 query 怎么分工
POST https://api.huohuaapi.com/v1/search
{
"source": "legal_cases",
"purpose": "查交通事故车辆贬值损失赔偿的裁判口径",
"filters": {
"case_type": "民事",
"judgment_year": "2023"
},
"query": "交通事故车辆贬值损失赔偿是否支持"
}把这个数据源接入你的 Agent
方式一(推荐):装成 Claude Code / Codex 技能,Agent 需要时自动调用。
curl -fsSL https://skills.huohuaapi.com/legal_cases/install.sh | sh方式二:直接调 API(token 到 控制台 开通该数据源)。
curl -s "https://api.huohuaapi.cn/v1/search" \
-H "Authorization: Bearer $HUOHUA_DATA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source":"legal_cases","query":"...","filters":{}}'默认入口 https://api.huohuaapi.cn/v1(国内直连),海外或连接失败改用 https://api.huohuaapi.com/v1;功能与计费一致。
收费 · ¥5 / 100 次:按成功返回计费(空结果/报错不扣费),从余额扣减,已含你的 token。使用前请先 登录 / 注册 获取 API Key;Agent 可直接用本页链接安装 skill。
和传统平台有什么不同
| 北大法宝、威科先行、聚法 等法律检索平台 | 火花数据API | |
|---|---|---|
| 面向对象 | 人(网页检索) | AI Agent(程序调用) |
| 接入方式 | 登录网页 / 通常需订阅 | API(/v1/search)+ 可安装 skill |
| 返回形态 | 网页结果,人工摘录 | 结构化、带来源、可直接引用的 markdown |
| 适用场景 | 人工查阅 | Agent 自动检索 + 生成 |
常见问题
用法律案例 API 需要先注册吗？
可以先免注册充值获取 API Key 再调用；已有账号则在控制台开通数据源后调用。
类案检索怎么查询？
用 legal_cases 按案由、年份、地区检索类案，返回可引用的案号、裁判要旨和摘要，供 Agent 归纳裁判口径。
和北大法宝、威科先行这类法律检索工具比有什么不同？
火花把法律检索做成给 Agent 调用的接口：用 /v1/search 传 source、filters、query，直接拿到可引用的结构化结果，而不是人工在网页里逐条查。
AI 法律检索、法律 AI 哪个好用，要不要法律数据库？
要可引用结果就别只问通用模型——用 legal_cases 这类法律案例数据库接口做 AI 法律检索，Agent 直接拿到带案号、裁判要旨的结构化结果，比纯模型臆造更可靠。
filters 和 query 怎么分工？
filters 放确定条件（年份、类型、地区、对象等）；query 放完整自然语言意图，承接难以参数化的语义。
返回结果能直接引用吗？
可以。默认返回带来源的 markdown，适合 Agent 直接引用；需要结构化时请求 return.format=json。
空结果或 invalid_filter 怎么排查？
先放宽 filters、核对字段名与取值，再用更聚焦的 query 重试；仍为空说明该条件下暂无匹配材料。
和模型 API 有什么区别？
模型 API 走 /v1 生成文本；数据 API 走 /v1/search 用 legal_cases 检索可引用材料，二者可在同一 Agent 流程组合。
这个数据 API 有 skill 吗、能直接给 Agent / Claude Code 用吗？
可以。除了直接 POST /v1/search，还提供 skill 包：装进 Claude Code、Codex、Cline 等 Agent 后，Agent 会自动用 legal_cases 检索，无需手写请求。