Search Statutes—Keyword — get_law_list
Keyword statute-list search
- Selected price
- $0.05 / callPublished pricing
- Providers / implementations
- 1 / 1
- Requests · 30d
- —Loading...
- Success rate · 30d
- —Loading...
| Provider | Price / call | Requests · 30d | Performance | Access |
|---|---|---|---|---|
pkulawCurrent Search Statutes—Keyword — get_law_list · POST | $0.05 / call | — | —successP50— |
Statistics use persisted gateway logs from the last 30 days up to now, including today.
Success rate = successful requests / all requests;
P50 = median latency of successful requests.
Prices reflect the published API contract. Contract revision: 3. Price update time: not supplied.
Playground
Run sends a real API request. Charges follow the published API contract.
curl \
'https://api.openany.si/v1/agent-apis/pkulaw/law-keyword/get_law_list' \
-X POST \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"effectiveness": [
"法律",
"地方性法规"
],
"endImplementDate": "2026.7.1",
"fulltext": "盗窃",
"pageSize": 3,
"startImplementDate": "2000.10.01",
"timeliness": [
"现行有效",
"废止或失效"
],
"title": "刑法"
}'- Method
- POST
- Endpoint
https://api.openany.si/v1/agent-apis/pkulaw/law-keyword/get_law_list- Content type
- application/json
- Authentication
Authorization: Bearer $OPENANY_API_KEY
curl \
'https://api.openany.si/v1/agent-apis/pkulaw/law-keyword/get_law_list' \
-X POST \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"effectiveness": [
"法律",
"地方性法规"
],
"endImplementDate": "2026.7.1",
"fulltext": "盗窃",
"pageSize": 3,
"startImplementDate": "2000.10.01",
"timeliness": [
"现行有效",
"废止或失效"
],
"title": "刑法"
}'Input parameters
Fields in this listing; additional options and input encoding can vary by provider.
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
category | JSON request bodybody | array | No | Statute category names, at most 5, combined with OR. For example, ["合同"] (contracts) or ["人身权"] (personal rights). Group names can also be searched. Cannot be the sole search condition. maxItems: 5 Nested fields and variants
|
cursor | JSON request bodybody | string | No | Pass back nextCursor from the previous page unchanged. Leave empty for the first page; do not supply it unless the user requests more results. Keep filters, sorting, and pageSize the same as on the previous page. |
documentNo | JSON request bodybody | string | No | Document number, matched as a complete phrase, e.g. `主席令第91号` (Presidential Order No. 91). maxLength: 80 |
effectiveness | JSON request bodybody | array | No | Level of legal authority; multiple values are combined with OR. Use only terms listed in the parameter description. Cannot be the sole search condition.Nested fields and variants
|
endImplementDate | JSON request bodybody | string | No | Effective date to, in YYYY-MM-DD or YYYY.M.D format. |
endIssueDate | JSON request bodybody | string | No | Promulgation date to, in YYYY-MM-DD or YYYY.M.D format. |
fulltext | JSON request bodybody | string | No | Full-text keywords, e.g. `敏感个人信息` (sensitive personal information). Spaces and commas mean AND; | means OR. Only matching excerpts are returned. maxLength: 80 |
issueDepartment | JSON request bodybody | array | No | Issuing authority names, at most 3, combined with OR. For example, ["文化和旅游部"] (Ministry of Culture and Tourism) or ["国务院"] (State Council). A complete list is not provided. `国务院` searches only the State Council itself, excluding its ministries and commissions. Cannot be the sole search condition. An unmatched name or multiple authorities with the same name causes an error. maxItems: 3 Nested fields and variants
|
pageSize | JSON request bodybody | integer | No | Number of results on this page, e.g. 10; maximum 50. A search can retrieve at most 50 results across 5 pages. Keep this value the same as on the previous page when paginating. minimum: 1 · maximum: 50 |
region | JSON request bodybody | string | No | Province-level region, e.g. `北京市` (Beijing Municipality). Cannot be used together with `中央法规` (central statutes). Cannot be the sole search condition. maxLength: 20 |
scope | JSON request bodybody | string | null | No | `中央法规` (central statutes) searches only the central database; `地方法规` (local statutes) searches only the local database. If omitted, both databases are searched. |
sort | JSON request bodybody | string | No | relevance, implementDateDesc, or issueDateDesc. enum: "relevance", "implementDateDesc", "issueDateDesc" |
startImplementDate | JSON request bodybody | string | No | Effective date from, in YYYY-MM-DD or YYYY.M.D format. |
startIssueDate | JSON request bodybody | string | No | Promulgation date from, in YYYY-MM-DD or YYYY.M.D format. |
timeliness | JSON request bodybody | array | No | Validity status; multiple values are combined with OR. If omitted, no filter is applied and currently effective statutes are not prioritized.Nested fields and variants
|
title | JSON request bodybody | string | No | Title keywords, e.g. `个人信息保护法` (Personal Information Protection Law). Spaces and commas mean AND; | means OR. The Chinese enumeration comma does not split terms. maxLength: 200 |
Required markers inside a nested object or variant apply when that object or variant is used.
Sample response
Published response example · Documented HTTP 200; not a live result. Published documentation example. Verify the actual response after an approved call.
{
"_meta": {
"io.modelcontextprotocol/serverInfo": {
"name": "mcp-law",
"title": "北大法宝·法规关键词检索",
"version": "2.0.0"
},
"pkulaw/evidence": {
"confidence": "B",
"notes": [],
"origin": "catalog",
"retrievedAt": "2026-10-28T12:43:19Z",
"verifiedByApi": true
},
"pkulaw/limits": [
"还有下一页。用户没有要求更多时停在本页。要继续只把 nextCursor 原样传回 cursor,筛选、排序和 pageSize 不要改。最多 5 页,一次最多 50 条。"
]
},
"content": [
{
"text": "命中约 8 部。本页 3 条,最多 5 页,一次最多 50 条。\n- 《中华人民共和国刑法修正案(三)》(中华人民共和国主席令第64号)(现行有效,法律,2001-12-29)\n https://www.pkulaw.com/chl/65e3e32f00f4cef8bdfb.html?way=mcp\n- 《中华人民共和国 刑法修正案(八)》(中华人民共和国主席令第41号)(现行有效,法律,2011-05-01)\n https://www.pkulaw.com/chl/c3bca3c5ab0ed5c1bdfb.html?way=mcp\n- 《中华人民共和国刑法修正案(五)》(中华人民共和国主席令第32号)(现行有效,法律,2005-02-28)\n https://www.pkulaw.com/chl/ee058680f58e1b63bdfb.html?way=mcp\n用户没有要求更多时停在本页。要继续把 nextCursor 原样传回 cursor,筛选、排序和 pageSize 不要改。\n\n【本次调用需注意】\n- 还有下一页。用户没有要求更多时停在本页。要继续只把 nextCursor 原样传回 cursor,筛选、排序和 pageSize 不要改。最多 5 页,一次最多 50 条。",
"type": "text"
}
],
"isError": false,
"resultType": "complete",
"structuredContent": {
"hasMore": true,
"items": [
{
"category": [
"刑法"
],
"citation": {
"anchorId": null,
"articleLabel": null,
"articleNumber": null,
"formatBluebook": null,
"formatChinese": "《中华人民共和国刑法修正案(三)》(中华人民共和国主席令第64号)",
"lawShort": null,
"lawTitle": "中华人民共和国刑法修正案(三)",
"url": "https://www.pkulaw.com/chl/65e3e32f00f4cef8bdfb.html?way=mcp",
"versionLabel": null
},
"documentNo": "中华人民共和国主席令第64号",
"effectiveness": [
"法律"
],
"fulltextSnippet": "六、将刑法第一百二十七条修改为:“盗窃、抢夺枪支、弹药、爆炸物的,或者盗窃、抢夺毒害性、放射性、传染病病原体等物质,危害公共安全的,处三年以上十年以下有期徒刑;情节严重的,处十年以上有期徒刑、无期徒刑或者死刑。",
"implementDate": "2001-12-29",
"issueDate": "2001-12-29",
"issueDepartment": [
"全国人大常委会"
],
"region": null,
"scope": "中央法规",
"timeliness": "现行有效",
"title": "中华人民共和国刑法修正案(三)"
},
{
"category": [
"刑法"
],
"citation": {
"anchorId": null,
"articleLabel": null,
"articleNumber": null,
"formatBluebook": null,
"formatChinese": "《中华人民共和国刑法修正案(八)》(中华人民共和国主席令第41号)",
"lawShort": null,
"lawTitle": "中华人民共和国刑法修正案(八)",
"url": "https://www.pkulaw.com/chl/c3bca3c5ab0ed5c1bdfb.html?way=mcp",
"versionLabel": null
},
"documentNo": "中华人民共和国主席令第41号",
"effectiveness": [
"法律"
],
"fulltextSnippet": "三十九、将刑法第二百六十四条修改为:“盗窃公私财物,数额较大的,或者多次盗窃、入户盗窃、携带凶器盗窃、扒窃的,处三年以下有期徒刑、拘役或者管制,并处或者单处罚金;数额巨大或者有其他严重情节的,处三年以上十年以下有期徒刑,并处罚金;数额特别巨大或者有其他特别严重情节的",
"implementDate": "2011-05-01",
"issueDate": "2011-02-25",
"issueDepartment": [
"全国人大常委会"
],
"region": null,
"scope": "中央法规",
"timeliness": "现行有效",
"title": "中华人民共和国刑法修正案(八)"
},
{
"category": [
"刑法"
],
"citation": {
"anchorId": null,
"articleLabel": null,
"articleNumber": null,
"formatBluebook": null,
"formatChinese": "《中华人民共和国刑法修正案(五)》(中华人民共和国主席令第32号)",
"lawShort": null,
"lawTitle": "中华人民共和国刑法修正案(五)",
"url": "https://www.pkulaw.com/chl/ee058680f58e1b63bdfb.html?way=mcp",
"versionLabel": null
},
"documentNo": "中华人民共和国主席令第32号",
"effectiveness": [
"法律"
],
"fulltextSnippet": "“盗窃信用卡并使用的,依照本法第二百六十四条的规定定罪处罚。”",
"implementDate": "2005-02-28",
"issueDate": "2005-02-28",
"issueDepartment": [
"全国人大常委会"
],
"region": null,
"scope": "中央法规",
"timeliness": "现行有效",
"title": "中华人民共和国刑法修正案(五)"
}
],
"nextCursor": "NTFlODAyMzU0M2YwZGZlNTg5NjMwZjFiYzU4MTQ0NDg2YjgxNzVlYjIyZjMwYzQ1ZGJjOGYyYjQxNjk3MTRlMC5nQUFBQUFCcTRlM25VaTg4SDRWOEtEclZEWkhiem5WOFhsLUQ5WjAtY1JFMnctUVgzWXlQdVl2MHRSU1pSbUViZzBVSTdzQW9KTzg1UkZPMlJ3bGx2LTlicS1yTGNpejJiZDZIbUkxSjVVM1p5cmVVMFJGWUMxVjdsYUt2LU5JSU9aMjFMYk9SaW00V0YtWmEzS0xOSVNLdzZxbEZyZzdHRUhmMVhtMFNfSTk3V3EydjJSa0NNRkxCRnM2a1RoVGFaRXFHd2RXeXdkbjZsVHFJR0FEVFAyelFvLWFkZHZQWlAxV3FBUTVvWHQzTC12SFZVTzFmMFdUbm5kZ3RJT0VQNWQyaWQ0RlBaT0g1",
"pageSize": 3,
"totalCount": 8
}
}Agent integration
Copy the resource contract without sharing an API key.
View API Markdown
# Search Statutes—Keyword — get_law_list
Keyword statute-list search
## Available implementations
pkulaw · Search Statutes—Keyword — get_law_list: https://openany.si/markets/apis/capabilities/pkulaw-search-statutes-keyword-get-law-list?offering=777993c4-024d-411b-806e-59c01b6d46b2 · $0.05 / call
## Selected API contract
Documentation: https://openany.si/markets/apis/capabilities/pkulaw-search-statutes-keyword-get-law-list
Method: POST
Endpoint: https://api.openany.si/v1/agent-apis/pkulaw/law-keyword/get_law_list
Price: $0.05 / call
Provider: pkulaw
Contract revision: 3
Price source: selected implementation in the OpenAny public API catalog. Price update time: not supplied.
Use OPENANY_API_KEY from the environment. API Key calls use your shared balance.
## Prepared request
```bash
curl \
'https://api.openany.si/v1/agent-apis/pkulaw/law-keyword/get_law_list' \
-X POST \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"effectiveness": [
"法律",
"地方性法规"
],
"endImplementDate": "2026.7.1",
"fulltext": "盗窃",
"pageSize": 3,
"startImplementDate": "2000.10.01",
"timeliness": [
"现行有效",
"废止或失效"
],
"title": "刑法"
}'
```
## API contract
```json
{
"resource_type": "api",
"name": "Search Statutes—Keyword — get_law_list",
"endpoint": "https://api.openany.si/v1/agent-apis/pkulaw/law-keyword/get_law_list",
"method": "POST",
"content_type": "application/json",
"execution_mode": "sync",
"authentication": {
"type": "bearer",
"environment_variable": "OPENANY_API_KEY"
},
"inputs": [
{
"description": "Keyword statute-list search",
"json_schema": {
"properties": {
"category": {
"default": [],
"description": "Statute category names, at most 5, combined with OR. For example, [\"合同\"] (contracts) or [\"人身权\"] (personal rights). Group names can also be searched. Cannot be the sole search condition.",
"items": {
"maxLength": 50,
"type": "string"
},
"maxItems": 5,
"title": "category",
"type": "array"
},
"cursor": {
"default": "",
"description": "Pass back nextCursor from the previous page unchanged. Leave empty for the first page; do not supply it unless the user requests more results. Keep filters, sorting, and pageSize the same as on the previous page.",
"title": "cursor",
"type": "string"
},
"documentNo": {
"default": "",
"description": "Document number, matched as a complete phrase, e.g. `主席令第91号` (Presidential Order No. 91).",
"maxLength": 80,
"title": "documentNo",
"type": "string"
},
"effectiveness": {
"default": [],
"description": "Level of legal authority; multiple values are combined with OR. Use only terms listed in the parameter description. Cannot be the sole search condition.",
"items": {
"enum": [
"法律",
"行政法规",
"监察法规",
"司法解释",
"部门规章",
"军事法规规章",
"党内法规制度",
"行业规定",
"团体规定",
"地方性法规",
"自治条例和单行条例",
"地方政府规章",
"地方规范性文件",
"地方司法文件",
"地方工作文件",
"行政许可批复"
],
"type": "string"
},
"title": "effectiveness",
"type": "array"
},
"endImplementDate": {
"default": "",
"description": "Effective date to, in YYYY-MM-DD or YYYY.M.D format.",
"title": "endImplementDate",
"type": "string"
},
"endIssueDate": {
"default": "",
"description": "Promulgation date to, in YYYY-MM-DD or YYYY.M.D format.",
"title": "endIssueDate",
"type": "string"
},
"fulltext": {
"default": "",
"description": "Full-text keywords, e.g. `敏感个人信息` (sensitive personal information). Spaces and commas mean AND; | means OR. Only matching excerpts are returned.",
"maxLength": 80,
"title": "fulltext",
"type": "string"
},
"issueDepartment": {
"default": [],
"description": "Issuing authority names, at most 3, combined with OR. For example, [\"文化和旅游部\"] (Ministry of Culture and Tourism) or [\"国务院\"] (State Council). A complete list is not provided. `国务院` searches only the State Council itself, excluding its ministries and commissions. Cannot be the sole search condition. An unmatched name or multiple authorities with the same name causes an error.",
"items": {
"maxLength": 40,
"type": "string"
},
"maxItems": 3,
"title": "issueDepartment",
"type": "array"
},
"pageSize": {
"default": 10,
"description": "Number of results on this page, e.g. 10; maximum 50. A search can retrieve at most 50 results across 5 pages. Keep this value the same as on the previous page when paginating.",
"maximum": 50,
"minimum": 1,
"title": "pageSize",
"type": "integer"
},
"region": {
"default": "",
"description": "Province-level region, e.g. `北京市` (Beijing Municipality). Cannot be used together with `中央法规` (central statutes). Cannot be the sole search condition.",
"maxLength": 20,
"title": "region",
"type": "string"
},
"scope": {
"anyOf": [
{
"enum": [
"中央法规",
"地方法规"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "`中央法规` (central statutes) searches only the central database; `地方法规` (local statutes) searches only the local database. If omitted, both databases are searched.",
"title": "scope"
},
"sort": {
"default": "relevance",
"description": "relevance, implementDateDesc, or issueDateDesc.",
"enum": [
"relevance",
"implementDateDesc",
"issueDateDesc"
],
"title": "sort",
"type": "string"
},
"startImplementDate": {
"default": "",
"description": "Effective date from, in YYYY-MM-DD or YYYY.M.D format.",
"title": "startImplementDate",
"type": "string"
},
"startIssueDate": {
"default": "",
"description": "Promulgation date from, in YYYY-MM-DD or YYYY.M.D format.",
"title": "startIssueDate",
"type": "string"
},
"timeliness": {
"default": [],
"description": "Validity status; multiple values are combined with OR. If omitted, no filter is applied and currently effective statutes are not prioritized.",
"items": {
"enum": [
"现行有效",
"废止或失效",
"已被修改",
"尚未施行",
"部分废止或失效"
],
"type": "string"
},
"title": "timeliness",
"type": "array"
},
"title": {
"default": "",
"description": "Title keywords, e.g. `个人信息保护法` (Personal Information Protection Law). Spaces and commas mean AND; | means OR. The Chinese enumeration comma does not split terms.",
"maxLength": 200,
"title": "title",
"type": "string"
}
},
"title": "get_law_listArguments",
"type": "object"
},
"location": "body",
"name": "body",
"nullable": false,
"pointer": "",
"required": true,
"type": "object"
}
],
"billing": {
"currency": "USD",
"mode": "fixed",
"priceMicroUsd": "50000",
"rounding": null,
"unit": "call",
"unitQuantity": null
},
"examples": [
{
"http_status": 200,
"name": "Documentation example",
"request": {
"body": {
"effectiveness": [
"法律",
"地方性法规"
],
"endImplementDate": "2026.7.1",
"fulltext": "盗窃",
"pageSize": 3,
"startImplementDate": "2000.10.01",
"timeliness": [
"现行有效",
"废止或失效"
],
"title": "刑法"
},
"headers": {
"Accept": "application/json"
},
"path": {},
"query": {}
},
"response_body": {
"_meta": {
"io.modelcontextprotocol/serverInfo": {
"name": "mcp-law",
"title": "北大法宝·法规关键词检索",
"version": "2.0.0"
},
"pkulaw/evidence": {
"confidence": "B",
"notes": [],
"origin": "catalog",
"retrievedAt": "2026-10-28T12:43:19Z",
"verifiedByApi": true
},
"pkulaw/limits": [
"还有下一页。用户没有要求更多时停在本页。要继续只把 nextCursor 原样传回 cursor,筛选、排序和 pageSize 不要改。最多 5 页,一次最多 50 条。"
]
},
"content": [
{
"text": "命中约 8 部。本页 3 条,最多 5 页,一次最多 50 条。\n- 《中华人民共和国刑法修正案(三)》(中华人民共和国主席令第64号)(现行有效,法律,2001-12-29)\n https://www.pkulaw.com/chl/65e3e32f00f4cef8bdfb.html?way=mcp\n- 《中华人民共和国刑法修正案(八)》(中华人民共和国主席令第41号)(现行有效,法律,2011-05-01)\n https://www.pkulaw.com/chl/c3bca3c5ab0ed5c1bdfb.html?way=mcp\n- 《中华人民共和国刑法修正案(五)》(中华人民共和国主席令第32号)(现行有效,法律,2005-02-28)\n https://www.pkulaw.com/chl/ee058680f58e1b63bdfb.html?way=mcp\n用户没有要求更多时停在本页。要继续把 nextCursor 原样传回 cursor,筛选、排序和 pageSize 不要改。\n\n【本次调用需注意】\n- 还有下一页。用户没有要求更多时停在本页。要继续只把 nextCursor 原样传回 cursor,筛选、排序和 pageSize 不要改。最多 5 页,一次最多 50 条。",
"type": "text"
}
],
"isError": false,
"resultType": "complete",
"structuredContent": {
"hasMore": true,
"items": [
{
"category": [
"刑法"
],
"citation": {
"anchorId": null,
"articleLabel": null,
"articleNumber": null,
"formatBluebook": null,
"formatChinese": "《中华人民共和国刑法修正案(三)》(中华人民共和国主席令第64号)",
"lawShort": null,
"lawTitle": "中华人民共和国刑法修正案(三)",
"url": "https://www.pkulaw.com/chl/65e3e32f00f4cef8bdfb.html?way=mcp",
"versionLabel": null
},
"documentNo": "中华人民共和国主席令第64号",
"effectiveness": [
"法律"
],
"fulltextSnippet": "六、将刑法第一百二十七条修改为:“盗窃、抢夺枪支、弹药、爆炸物的,或者盗窃、抢夺毒害性、放射性、传染病病原体等物质,危害公共安全的,处三年以上十年以下有期徒刑;情节严重的,处十年以上有期徒刑、无期徒刑或者死刑。",
"implementDate": "2001-12-29",
"issueDate": "2001-12-29",
"issueDepartment": [
"全国人大常委会"
],
"region": null,
"scope": "中央法规",
"timeliness": "现行有效",
"title": "中华人民共和国刑法修正案(三)"
},
{
"category": [
"刑法"
],
"citation": {
"anchorId": null,
"articleLabel": null,
"articleNumber": null,
"formatBluebook": null,
"formatChinese": "《中华人民共和国刑法修正案(八)》(中华人民共和国主席令第41号)",
"lawShort": null,
"lawTitle": "中华人民共和国刑法修正案(八)",
"url": "https://www.pkulaw.com/chl/c3bca3c5ab0ed5c1bdfb.html?way=mcp",
"versionLabel": null
},
"documentNo": "中华人民共和国主席令第41号",
"effectiveness": [
"法律"
],
"fulltextSnippet": "三十九、将刑法第二百六十四条修改为:“盗窃公私财物,数额较大的,或者多次盗窃、入户盗窃、携带凶器盗窃、扒窃的,处三年以下有期徒刑、拘役或者管制,并处或者单处罚金;数额巨大或者有其他严重情节的,处三年以上十年以下有期徒刑,并处罚金;数额特别巨大或者有其他特别严重情节的",
"implementDate": "2011-05-01",
"issueDate": "2011-02-25",
"issueDepartment": [
"全国人大常委会"
],
"region": null,
"scope": "中央法规",
"timeliness": "现行有效",
"title": "中华人民共和国刑法修正案(八)"
},
{
"category": [
"刑法"
],
"citation": {
"anchorId": null,
"articleLabel": null,
"articleNumber": null,
"formatBluebook": null,
"formatChinese": "《中华人民共和国刑法修正案(五)》(中华人民共和国主席令第32号)",
"lawShort": null,
"lawTitle": "中华人民共和国刑法修正案(五)",
"url": "https://www.pkulaw.com/chl/ee058680f58e1b63bdfb.html?way=mcp",
"versionLabel": null
},
"documentNo": "中华人民共和国主席令第32号",
"effectiveness": [
"法律"
],
"fulltextSnippet": "“盗窃信用卡并使用的,依照本法第二百六十四条的规定定罪处罚。”",
"implementDate": "2005-02-28",
"issueDate": "2005-02-28",
"issueDepartment": [
"全国人大常委会"
],
"region": null,
"scope": "中央法规",
"timeliness": "现行有效",
"title": "中华人民共和国刑法修正案(五)"
}
],
"nextCursor": "NTFlODAyMzU0M2YwZGZlNTg5NjMwZjFiYzU4MTQ0NDg2YjgxNzVlYjIyZjMwYzQ1ZGJjOGYyYjQxNjk3MTRlMC5nQUFBQUFCcTRlM25VaTg4SDRWOEtEclZEWkhiem5WOFhsLUQ5WjAtY1JFMnctUVgzWXlQdVl2MHRSU1pSbUViZzBVSTdzQW9KTzg1UkZPMlJ3bGx2LTlicS1yTGNpejJiZDZIbUkxSjVVM1p5cmVVMFJGWUMxVjdsYUt2LU5JSU9aMjFMYk9SaW00V0YtWmEzS0xOSVNLdzZxbEZyZzdHRUhmMVhtMFNfSTk3V3EydjJSa0NNRkxCRnM2a1RoVGFaRXFHd2RXeXdkbjZsVHFJR0FEVFAyelFvLWFkZHZQWlAxV3FBUTVvWHQzTC12SFZVTzFmMFdUbm5kZ3RJT0VQNWQyaWQ0RlBaT0g1",
"pageSize": 3,
"totalCount": 8
}
}
}
]
}
```Error handling
| Status | Next step |
|---|---|
400 | Check the offering and request fields. |
401 / 403 | Verify your credentials and access permissions. |
402 | Inspect the selected access mode and returned payment requirements. |
429 | Respect the returned rate limit and retry guidance. |
5xx | Inspect the error and usage record before retrying a paid operation. |
Documentation example
Published documentation example. Verify the actual response after an approved call.
Prepare your environment
Use a terminal with cURL installed.
Use an OpenAny API key with shared-balance access. Confirm availability and price before running; a call may charge your balance.
Set the key in your terminal using the hidden prompt below. Keep its value out of source files and logs.
Terminal · macOS / Linuxprintf 'OpenAny API key: ' read -r -s OPENANY_API_KEY export OPENANY_API_KEY printf '\n'Run the request
Paste the complete command below into your terminal.
Values to replace before running 1
Review these request fields before running. Keep the published provider and request method unchanged.
body- Keyword statute-list search
Terminal · cURLcurl \ 'https://api.openany.si/v1/agent-apis/pkulaw/law-keyword/get_law_list' \ -X POST \ -H "Authorization: Bearer $OPENANY_API_KEY" \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ --data-raw '{ "effectiveness": [ "法律", "地方性法规" ], "endImplementDate": "2026.7.1", "fulltext": "盗窃", "pageSize": 3, "startImplementDate": "2000.10.01", "timeliness": [ "现行有效", "废止或失效" ], "title": "刑法" }'Check the response
Published response example · Documented HTTP 200; not a live result.
Sample response · not a live result{ "_meta": { "io.modelcontextprotocol/serverInfo": { "name": "mcp-law", "title": "北大法宝·法规关键词检索", "version": "2.0.0" }, "pkulaw/evidence": { "confidence": "B", "notes": [], "origin": "catalog", "retrievedAt": "2026-10-28T12:43:19Z", "verifiedByApi": true }, "pkulaw/limits": [ "还有下一页。用户没有要求更多时停在本页。要继续只把 nextCursor 原样传回 cursor,筛选、排序和 pageSize 不要改。最多 5 页,一次最多 50 条。" ] }, "content": [ { "text": "命中约 8 部。本页 3 条,最多 5 页,一次最多 50 条。\n- 《中华人民共和国刑法修正案(三)》(中华人民共和国主席令第64号)(现行有效,法律,2001-12-29)\n https://www.pkulaw.com/chl/65e3e32f00f4cef8bdfb.html?way=mcp\n- 《中华人民共和国刑法修正案(八)》(中华人民共和国主席令第41号)(现行有效,法律,2011-05-01)\n https://www.pkulaw.com/chl/c3bca3c5ab0ed5c1bdfb.html?way=mcp\n- 《中华人民共和国刑法修正案(五)》(中华人民共和国主席令第32号)(现行有效,法律,2005-02-28)\n https://www.pkulaw.com/chl/ee058680f58e1b63bdfb.html?way=mcp\n用户没有要求更多时停在本页。要继续把 nextCursor 原样传回 cursor,筛选、排序和 pageSize 不要改。\n\n【本次调用需注意】\n- 还有下一页。用户没有要求更多时停在本页。要继续只把 nextCursor 原样传回 cursor,筛选、排序和 pageSize 不要改。最多 5 页,一次最多 50 条。", "type": "text" } ], "isError": false, "resultType": "complete", "structuredContent": { "hasMore": true, "items": [ { "category": [ "刑法" ], "citation": { "anchorId": null, "articleLabel": null, "articleNumber": null, "formatBluebook": null, "formatChinese": "《中华人民共和国刑法修正案(三)》(中华人民共和国主席令第64号)", "lawShort": null, "lawTitle": "中华人民共和国刑法修正案(三)", "url": "https://www.pkulaw.com/chl/65e3e32f00f4cef8bdfb.html?way=mcp", "versionLabel": null }, "documentNo": "中华人民共和国主席令第64号", "effectiveness": [ "法律" ], "fulltextSnippet": "六、将刑法第一百二十七条修改为:“盗窃、抢夺枪支、弹药、爆炸物的,或者盗窃、抢夺毒害性、放射性、传染病病原体等物质,危害公共安全的,处三年以上十年以下有期徒刑;情节严重的,处十年以上有期徒刑、无期徒刑或者死刑。", "implementDate": "2001-12-29", "issueDate": "2001-12-29", "issueDepartment": [ "全国人大常委会" ], "region": null, "scope": "中央法规", "timeliness": "现行有效", "title": "中华人民共和国刑法修正案(三)" }, { "category": [ "刑法" ], "citation": { "anchorId": null, "articleLabel": null, "articleNumber": null, "formatBluebook": null, "formatChinese": "《中华人民共和国刑法修正案(八)》(中华人民共和国主席令第41号)", "lawShort": null, "lawTitle": "中华人民共和国刑法修正案(八)", "url": "https://www.pkulaw.com/chl/c3bca3c5ab0ed5c1bdfb.html?way=mcp", "versionLabel": null }, "documentNo": "中华人民共和国主席令第41号", "effectiveness": [ "法律" ], "fulltextSnippet": "三十九、将刑法第二百六十四条修改为:“盗窃公私财物,数额较大的,或者多次盗窃、入户盗窃、携带凶器盗窃、扒窃的,处三年 以下有期徒刑、拘役或者管制,并处或者单处罚金;数额巨大或者有其他严重情节的,处三年以上十年以下有期徒刑,并处罚金;数额特别巨大或者有其他特别严重情节的", "implementDate": "2011-05-01", "issueDate": "2011-02-25", "issueDepartment": [ "全国人大常委会" ], "region": null, "scope": "中央法规", "timeliness": "现行有效", "title": "中华人民共和国刑法修正案(八)" }, { "category": [ "刑法" ], "citation": { "anchorId": null, "articleLabel": null, "articleNumber": null, "formatBluebook": null, "formatChinese": "《中华人民共和国刑法修正案(五)》(中华人民共和国主席令第32号)", "lawShort": null, "lawTitle": "中华人民共和国刑法修正案(五)", "url": "https://www.pkulaw.com/chl/ee058680f58e1b63bdfb.html?way=mcp", "versionLabel": null }, "documentNo": "中华人民共和国主席令第32号", "effectiveness": [ "法律" ], "fulltextSnippet": "“盗窃信用卡并使用的,依照本法第二百六十四条的规定定罪处罚。”", "implementDate": "2005-02-28", "issueDate": "2005-02-28", "issueDepartment": [ "全国人大常委会" ], "region": null, "scope": "中央法规", "timeliness": "现行有效", "title": "中华人民共和国刑法修正案(五)" } ], "nextCursor": "NTFlODAyMzU0M2YwZGZlNTg5NjMwZjFiYzU4MTQ0NDg2YjgxNzVlYjIyZjMwYzQ1ZGJjOGYyYjQxNjk3MTRlMC5nQUFBQUFCcTRlM25VaTg4SDRWOEtEclZEWkhiem5WOFhsLUQ5WjAtY1JFMnctUVgzWXlQdVl2MHRSU1pSbUViZzBVSTdzQW9KTzg1UkZPMlJ3bGx2LTlicS1yTGNpejJiZDZIbUkxSjVVM1p5cmVVMFJGWUMxVjdsYUt2LU5JSU9aMjFMYk9SaW00V0YtWmEzS0xOSVNLdzZxbEZyZzdHRUhmMVhtMFNfSTk3V3EydjJSa0NNRkxCRnM2a1RoVGFaRXFHd2RXeXdkbjZsVHFJR0FEVFAyelFvLWFkZHZQWlAxV3FBUTVvWHQzTC12SFZVTzFmMFdUbm5kZ3RJT0VQNWQyaWQ0RlBaT0g1", "pageSize": 3, "totalCount": 8 } }
Common questions
Do I need a separate key for every provider?
Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.
Are these providers interchangeable?
No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.
How is this API billed?
API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.
Where do the price and contract come from?
The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.
How do OpenAny Balance and x402 differ?
OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.
Does Playground send a paid request?
Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.