Procuratorate Document Search — search_procuratorate

Procuratorial Document 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 Procuratorate Document Search — search_procuratorate · 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.

Input

bodyRequired · objectProcuratorial Document Search

Request JSON

Request (JSON)

Edit the complete request, including additional parameters. GET requests use query parameters without a body.

No request sent. No usage charged.

Manage API keys

Sample response

Published response example · Documented HTTP 200; not a live result. Published documentation example. Verify the actual response after an approved call.

Documentation example

{
  "_meta": {
    "io.modelcontextprotocol/serverInfo": {
      "name": "pkulaw-procuratorate-doc",
      "title": "北大法宝·检察文书检索",
      "version": "1.0.0"
    },
    "pkulaw/evidence": {
      "confidence": "B",
      "notes": [],
      "origin": "search",
      "retrievedAt": "2026-10-28T12:48:21Z",
      "verifiedByApi": true
    }
  },
  "content": [
    {
      "text": "检索到 1 条检察文书，本页 1 条，最多 5 页，一次最多 50 条。召回按相关度排序，引用前请打开 URL 核对原文。\n- 1. 起诉书（刘士宏交通肇事案）（襄检刑诉〔2024〕43号，起诉书，刑事、危害公共安全罪、交通肇事罪，襄垣县人民检察院，2024.03.25）  https://www.pkulaw.com/procuratoratedoc/f4b18d978bc0d1c76587fb86a13e663960782bdca6714ce4bdfb.html?way=mcp",
      "type": "text"
    }
  ],
  "isError": false,
  "resultType": "complete",
  "structuredContent": {
    "data": [
      {
        "caseFlag": "襄检刑诉〔2024〕43号",
        "category": [
          "刑事",
          "危害公共安全罪",
          "交通肇事罪"
        ],
        "courtGrade": [
          "县区人民检察院"
        ],
        "documentAttr": [
          "起诉书"
        ],
        "judge": "郭  默\n检察",
        "lastInstanceDate": "2024.03.25",
        "procuratorateName": "襄垣县人民检察院",
        "sutraCase": [
          "公诉"
        ],
        "title": "起诉书（刘士宏交通肇事案）",
        "url": "https://www.pkulaw.com/procuratoratedoc/f4b18d978bc0d1c76587fb86a13e663960782bdca6714ce4bdfb.html?way=mcp"
      }
    ],
    "hasMore": false,
    "message": "查询成功",
    "nextCursor": null,
    "total": 1
  }
}

Request example

curl \
  'https://api.openany.si/v1/agent-apis/pkulaw/procuratorate/search_procuratorate' \
  -X POST \
  -H "Authorization: Bearer $OPENANY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data-raw '{
  "caseFlag": "襄检刑诉〔2024〕43号",
  "pageSize": 3,
  "searchType": "keyword"
}'

Method: POST
Endpoint: https://api.openany.si/v1/agent-apis/pkulaw/procuratorate/search_procuratorate
Content type: application/json
Authentication: Authorization: Bearer $OPENANY_API_KEY

Request example

curl \
  'https://api.openany.si/v1/agent-apis/pkulaw/procuratorate/search_procuratorate' \
  -X POST \
  -H "Authorization: Bearer $OPENANY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data-raw '{
  "caseFlag": "襄检刑诉〔2024〕43号",
  "pageSize": 3,
  "searchType": "keyword"
}'

Input parameters

Fields in this listing; additional options and input encoding can vary by provider.

Parameter	Location	Type	Required	Description
`caseFlag`	JSON request body`body`	string	No	Case number, matched as a phrase; separate multiple entries with spaces. Vertical bars do not mean OR. Effective only in keyword mode maxLength: 100
`category`	JSON request body`body`	array	No	Top-level cause of action. Accepts only `刑事` (criminal), `民事` (civil), `知识产权` (intellectual property), `行政` (administrative), `执行` (enforcement), or `国家赔偿` (state compensation). Do not supply specific offenses such as `交通肇事罪` (traffic accident offense). Here `执行` is a procuratorate cause of action, not a court enforcement ruling Nested fields and variants `body.category[]` · Array item · string
`courtGrade`	JSON request body`body`	array	No	Procuratorate level, not court level, e.g. `省级人民检察院` (provincial people's procuratorate) or `县区人民检察院` (county/district people's procuratorate) Nested fields and variants `body.courtGrade[]` · Array item · string
`cursor`	JSON request body`body`	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 all other parameters the same as on the previous page when paginating
`documentAttr`	JSON request body`body`	array	No	Document type. Only `起诉书` (indictment), `不起诉决定书` (non-prosecution decision), `抗诉书` (protest), `刑事申诉复查决定书` (criminal complaint review decision), or `其他法律文书` (other legal documents). There is no separate `检察建议` (procuratorial recommendation) code; formal recommendations fall under `其他法律文书`. You may also search for `检察建议` in title Nested fields and variants `body.documentAttr[]` · Array item · string
`endDate`	JSON request body`body`	string	No	End date. Accepts 2026.01.01, 2026-01-01, or 2026/01/01; missing zero-padding is added automatically maxLength: 10
`pageSize`	JSON request body`body`	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
`queryText`	JSON request body`body`	string	No	Description of case facts. Required in semantic mode; the whole passage is vectorized without splitting on vertical bars. In keyword mode, used for full-text phrase search: spaces and commas mean AND, \| means OR, and the Chinese enumeration comma `、` does not split terms maxLength: 1000
`searchType`	JSON request body`body`	string \| null	No	semantic=find similar documents from case facts; queryText is required and title and caseFlag are ignored. keyword=search by title, case number, full text, or filters. If omitted, semantic is used when queryText is supplied; otherwise keyword is used
`startDate`	JSON request body`body`	string	No	Start date. Accepts 2026.01.01, 2026-01-01, or 2026/01/01; missing zero-padding, e.g. 2026.1.1, is added automatically maxLength: 10
`sutraCase`	JSON request body`body`	array	No	Procuratorial business area, e.g. `公诉` (public prosecution) or `刑事申诉` (criminal complaints). This is neither a cause of action nor a court business area Nested fields and variants `body.sutraCase[]` · Array item · string
`title`	JSON request body`body`	string	No	Document title: phrase matching, not exact equality of the entire text. Spaces and commas mean AND; \| means OR. The Chinese enumeration comma does not split terms. Applies only in keyword mode. 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.

Documentation example

{
  "_meta": {
    "io.modelcontextprotocol/serverInfo": {
      "name": "pkulaw-procuratorate-doc",
      "title": "北大法宝·检察文书检索",
      "version": "1.0.0"
    },
    "pkulaw/evidence": {
      "confidence": "B",
      "notes": [],
      "origin": "search",
      "retrievedAt": "2026-10-28T12:48:21Z",
      "verifiedByApi": true
    }
  },
  "content": [
    {
      "text": "检索到 1 条检察文书，本页 1 条，最多 5 页，一次最多 50 条。召回按相关度排序，引用前请打开 URL 核对原文。\n- 1. 起诉书（刘士宏交通肇事案）（襄检刑诉〔2024〕43号，起诉书，刑事、危害公共安全罪、交通肇事罪，襄垣县人民检察院，2024.03.25）  https://www.pkulaw.com/procuratoratedoc/f4b18d978bc0d1c76587fb86a13e663960782bdca6714ce4bdfb.html?way=mcp",
      "type": "text"
    }
  ],
  "isError": false,
  "resultType": "complete",
  "structuredContent": {
    "data": [
      {
        "caseFlag": "襄检刑诉〔2024〕43号",
        "category": [
          "刑事",
          "危害公共安全罪",
          "交通肇事罪"
        ],
        "courtGrade": [
          "县区人民检察院"
        ],
        "documentAttr": [
          "起诉书"
        ],
        "judge": "郭  默\n检察",
        "lastInstanceDate": "2024.03.25",
        "procuratorateName": "襄垣县人民检察院",
        "sutraCase": [
          "公诉"
        ],
        "title": "起诉书（刘士宏交通肇事案）",
        "url": "https://www.pkulaw.com/procuratoratedoc/f4b18d978bc0d1c76587fb86a13e663960782bdca6714ce4bdfb.html?way=mcp"
      }
    ],
    "hasMore": false,
    "message": "查询成功",
    "nextCursor": null,
    "total": 1
  }
}

Agent integration

Copy the resource contract without sharing an API key.

View API Markdown

API Markdown

# Procuratorate Document Search — search_procuratorate

Procuratorial Document Search
## Available implementations
pkulaw · Procuratorate Document Search — search_procuratorate: https://openany.si/markets/apis/capabilities/pkulaw-procuratorate-document-search-search-procuratorate?offering=13f1b723-e9ef-4297-a24e-89c4a085b791 · $0.05 / call

## Selected API contract
Documentation: https://openany.si/markets/apis/capabilities/pkulaw-procuratorate-document-search-search-procuratorate
Method: POST
Endpoint: https://api.openany.si/v1/agent-apis/pkulaw/procuratorate/search_procuratorate
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/procuratorate/search_procuratorate' \
  -X POST \
  -H "Authorization: Bearer $OPENANY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data-raw '{
  "caseFlag": "襄检刑诉〔2024〕43号",
  "pageSize": 3,
  "searchType": "keyword"
}'
```

## API contract
```json
{
  "resource_type": "api",
  "name": "Procuratorate Document Search — search_procuratorate",
  "endpoint": "https://api.openany.si/v1/agent-apis/pkulaw/procuratorate/search_procuratorate",
  "method": "POST",
  "content_type": "application/json",
  "execution_mode": "sync",
  "authentication": {
    "type": "bearer",
    "environment_variable": "OPENANY_API_KEY"
  },
  "inputs": [
    {
      "description": "Procuratorial Document Search",
      "json_schema": {
        "properties": {
          "caseFlag": {
            "description": "Case number, matched as a phrase; separate multiple entries with spaces. Vertical bars do not mean OR. Effective only in keyword mode",
            "maxLength": 100,
            "title": "caseFlag",
            "type": "string"
          },
          "category": {
            "description": "Top-level cause of action. Accepts only `刑事` (criminal), `民事` (civil), `知识产权` (intellectual property), `行政` (administrative), `执行` (enforcement), or `国家赔偿` (state compensation). Do not supply specific offenses such as `交通肇事罪` (traffic accident offense). Here `执行` is a procuratorate cause of action, not a court enforcement ruling",
            "items": {
              "enum": [
                "刑事",
                "民事",
                "知识产权",
                "行政",
                "执行",
                "国家赔偿"
              ],
              "type": "string"
            },
            "title": "category",
            "type": "array"
          },
          "courtGrade": {
            "description": "Procuratorate level, not court level, e.g. `省级人民检察院` (provincial people's procuratorate) or `县区人民检察院` (county/district people's procuratorate)",
            "items": {
              "enum": [
                "最高人民检察院",
                "省级人民检察院",
                "分州市人民检察院",
                "县区人民检察院",
                "专门人民检察院"
              ],
              "type": "string"
            },
            "title": "courtGrade",
            "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 all other parameters the same as on the previous page when paginating",
            "title": "cursor",
            "type": "string"
          },
          "documentAttr": {
            "description": "Document type. Only `起诉书` (indictment), `不起诉决定书` (non-prosecution decision), `抗诉书` (protest), `刑事申诉复查决定书` (criminal complaint review decision), or `其他法律文书` (other legal documents). There is no separate `检察建议` (procuratorial recommendation) code; formal recommendations fall under `其他法律文书`. You may also search for `检察建议` in title",
            "items": {
              "enum": [
                "起诉书",
                "不起诉决定书",
                "抗诉书",
                "刑事申诉复查决定书",
                "其他法律文书"
              ],
              "type": "string"
            },
            "title": "documentAttr",
            "type": "array"
          },
          "endDate": {
            "description": "End date. Accepts 2026.01.01, 2026-01-01, or 2026/01/01; missing zero-padding is added automatically",
            "maxLength": 10,
            "title": "endDate",
            "type": "string"
          },
          "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"
          },
          "queryText": {
            "description": "Description of case facts. Required in semantic mode; the whole passage is vectorized without splitting on vertical bars. In keyword mode, used for full-text phrase search: spaces and commas mean AND, | means OR, and the Chinese enumeration comma `、` does not split terms",
            "maxLength": 1000,
            "title": "queryText",
            "type": "string"
          },
          "searchType": {
            "anyOf": [
              {
                "enum": [
                  "semantic",
                  "keyword"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "semantic=find similar documents from case facts; queryText is required and title and caseFlag are ignored. keyword=search by title, case number, full text, or filters. If omitted, semantic is used when queryText is supplied; otherwise keyword is used",
            "title": "searchType"
          },
          "startDate": {
            "description": "Start date. Accepts 2026.01.01, 2026-01-01, or 2026/01/01; missing zero-padding, e.g. 2026.1.1, is added automatically",
            "maxLength": 10,
            "title": "startDate",
            "type": "string"
          },
          "sutraCase": {
            "description": "Procuratorial business area, e.g. `公诉` (public prosecution) or `刑事申诉` (criminal complaints). This is neither a cause of action nor a court business area",
            "items": {
              "enum": [
                "反贪污贿赂",
                "反渎职侵权",
                "公诉",
                "刑事申诉",
                "铁路检察",
                "侦查监督"
              ],
              "type": "string"
            },
            "title": "sutraCase",
            "type": "array"
          },
          "title": {
            "description": "Document title: phrase matching, not exact equality of the entire text. Spaces and commas mean AND; | means OR. The Chinese enumeration comma does not split terms. Applies only in keyword mode.",
            "maxLength": 200,
            "title": "title",
            "type": "string"
          }
        },
        "title": "search_procuratorateArguments",
        "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": {
          "caseFlag": "襄检刑诉〔2024〕43号",
          "pageSize": 3,
          "searchType": "keyword"
        },
        "headers": {
          "Accept": "application/json"
        },
        "path": {},
        "query": {}
      },
      "response_body": {
        "_meta": {
          "io.modelcontextprotocol/serverInfo": {
            "name": "pkulaw-procuratorate-doc",
            "title": "北大法宝·检察文书检索",
            "version": "1.0.0"
          },
          "pkulaw/evidence": {
            "confidence": "B",
            "notes": [],
            "origin": "search",
            "retrievedAt": "2026-10-28T12:48:21Z",
            "verifiedByApi": true
          }
        },
        "content": [
          {
            "text": "检索到 1 条检察文书，本页 1 条，最多 5 页，一次最多 50 条。召回按相关度排序，引用前请打开 URL 核对原文。\n- 1. 起诉书（刘士宏交通肇事案）（襄检刑诉〔2024〕43号，起诉书，刑事、危害公共安全罪、交通肇事罪，襄垣县人民检察院，2024.03.25）  https://www.pkulaw.com/procuratoratedoc/f4b18d978bc0d1c76587fb86a13e663960782bdca6714ce4bdfb.html?way=mcp",
            "type": "text"
          }
        ],
        "isError": false,
        "resultType": "complete",
        "structuredContent": {
          "data": [
            {
              "caseFlag": "襄检刑诉〔2024〕43号",
              "category": [
                "刑事",
                "危害公共安全罪",
                "交通肇事罪"
              ],
              "courtGrade": [
                "县区人民检察院"
              ],
              "documentAttr": [
                "起诉书"
              ],
              "judge": "郭  默\n检察",
              "lastInstanceDate": "2024.03.25",
              "procuratorateName": "襄垣县人民检察院",
              "sutraCase": [
                "公诉"
              ],
              "title": "起诉书（刘士宏交通肇事案）",
              "url": "https://www.pkulaw.com/procuratoratedoc/f4b18d978bc0d1c76587fb86a13e663960782bdca6714ce4bdfb.html?way=mcp"
            }
          ],
          "hasMore": false,
          "message": "查询成功",
          "nextCursor": null,
          "total": 1
        }
      }
    }
  ]
}
```

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.

01
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 / Linux
```
printf '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: Procuratorial Document Search

Terminal · cURL

curl \
  'https://api.openany.si/v1/agent-apis/pkulaw/procuratorate/search_procuratorate' \
  -X POST \
  -H "Authorization: Bearer $OPENANY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data-raw '{
  "caseFlag": "襄检刑诉〔2024〕43号",
  "pageSize": 3,
  "searchType": "keyword"
}'

Check the response

Published response example · Documented HTTP 200; not a live result.

Sample response · not a live result

{
  "_meta": {
    "io.modelcontextprotocol/serverInfo": {
      "name": "pkulaw-procuratorate-doc",
      "title": "北大法宝·检察文书检索",
      "version": "1.0.0"
    },
    "pkulaw/evidence": {
      "confidence": "B",
      "notes": [],
      "origin": "search",
      "retrievedAt": "2026-10-28T12:48:21Z",
      "verifiedByApi": true
    }
  },
  "content": [
    {
      "text": "检索到 1 条检察文书，本页 1 条，最多 5 页，一次最多 50 条。召回按相关度排序，引用前请打开 URL 核对原文。\n- 1. 起诉书（刘士宏交通肇事案）（襄检刑诉〔2024〕43号，起诉书，刑事、危害公共安全罪、交通肇事罪，襄垣县人民检察院，2024.03.25）  https://www.pkulaw.com/procuratoratedoc/f4b18d978bc0d1c76587fb86a13e663960782bdca6714ce4bdfb.html?way=mcp",
      "type": "text"
    }
  ],
  "isError": false,
  "resultType": "complete",
  "structuredContent": {
    "data": [
      {
        "caseFlag": "襄检刑诉〔2024〕43号",
        "category": [
          "刑事",
          "危害公共安全罪",
          "交通肇事罪"
        ],
        "courtGrade": [
          "县区人民检察院"
        ],
        "documentAttr": [
          "起诉书"
        ],
        "judge": "郭  默\n检察",
        "lastInstanceDate": "2024.03.25",
        "procuratorateName": "襄垣县人民检察院",
        "sutraCase": [
          "公诉"
        ],
        "title": "起诉书（刘士宏交通肇事案）",
        "url": "https://www.pkulaw.com/procuratoratedoc/f4b18d978bc0d1c76587fb86a13e663960782bdca6714ce4bdfb.html?way=mcp"
      }
    ],
    "hasMore": false,
    "message": "查询成功",
    "nextCursor": null,
    "total": 1
  }
}

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.

Input

Sample response

Prepare your environment

Run the request

Check the response

Common questions