court-announcement-search
China Court Announcement Search
Search Chinese court announcements by keywords with fuzzy or exact matching, and retrieve counts, snippets and detail IDs.
Usage Cost
20 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/court-announcement-searchcURL Example
curl --request POST \
--url 'https://openapi.toolkk.com/v1/court-announcement-search' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "sign": "841ef7c95cd3a25b3187cf4aa193c016",\n "entityName": "成都中鹏房地产开发有限公司",\n "matchType": "0",\n "fl": "1"\n}'Python Example
import os
import requests
url = "https://openapi.toolkk.com/v1/court-announcement-search"
payload = {
"sign": "841ef7c95cd3a25b3187cf4aa193c016",
"entityName": "成都中鹏房地产开发有限公司",
"matchType": "0",
"fl": "1"
}
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}
response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())Go Example
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/court-announcement-search"
payload := []byte("{\n \"sign\": \"841ef7c95cd3a25b3187cf4aa193c016\",\n \"entityName\": \"成都中鹏房地产开发有限公司\",\n \"matchType\": \"0\",\n \"fl\": \"1\"\n}")
req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(body))
}Java Example
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ToolkkExample {
public static void main(String[] args) throws Exception {
String payload = "{\n \"sign\": \"841ef7c95cd3a25b3187cf4aa193c016\",\n \"entityName\": \"成都中鹏房地产开发有限公司\",\n \"matchType\": \"0\",\n \"fl\": \"1\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/court-announcement-search"))
.method("POST", HttpRequest.BodyPublishers.ofString(payload))
.header("Content-Type", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}PHP Example
<?php
$endpoint = 'https://openapi.toolkk.com/v1/court-announcement-search';
$payload = "{\n \"sign\": \"841ef7c95cd3a25b3187cf4aa193c016\",\n \"entityName\": \"成都中鹏房地产开发有限公司\",\n \"matchType\": \"0\",\n \"fl\": \"1\"\n}";
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-Key: YOUR_API_KEY',
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response;Response Example
{
"count": 77,
"list": [
{
"content": "成都**房地产开发有限公司:本院受理相关纠纷一案……",
"id": "23D17485F665AE0F"
}
]
}Examples illustrate the response structure. Actual results depend on the API response.
- Authentication
- Send X-API-Key in request headers
- Rate limit
- 60 req/min
- Timeout
- 10000 ms
Send your API Key in the X-API-Key header from your backend.
Check both HTTP status and business fields before treating a call as successful.
Use retries and backoff together with rate limits in high-frequency scenarios.
Request Fields
Send requests from your server with the key in the X-API-Key header.
Request Fields
Fields are read from the API schema. Missing descriptions and examples are marked as unspecified.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| sign | string | Yes | 调用当日签名:对 6tj4u 与调用日期 yyyyMMdd 拼接字符串计算 32 位 MD5。样例仅适用于 2026-10-09,跨日重新生成;不要把示例值作为默认常量。 | 841ef7c95cd3a25b3187cf4aa193c016 |
| entityName | string | Yes | 关键字,必填。支持按多个关键字查询,多个关键字之间用+分隔 | 成都中鹏房地产开发有限公司 |
| matchType | string | No | 匹配类型,0:模糊匹配;1:精确匹配.可选,默认模糊匹配 | 0 |
| fl | string | No | 是否显示高亮,0:不显示高亮;1:显示高亮.可选,默认显示高亮 | 1 |
Request Example
{
"sign": "841ef7c95cd3a25b3187cf4aa193c016",
"entityName": "成都中鹏房地产开发有限公司",
"matchType": "0",
"fl": "1"
}- Authentication
- Send X-API-Key in request headers
- Rate limit
- 60 req/min
- Timeout
- 10000 ms
Response Fields
Examples illustrate the response structure. Actual results depend on the API response.
Response Fields
Fields are read from the API schema. Missing descriptions and examples are marked as unspecified.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| count | integer | No | 数据源报告的结果总数,不保证等于本次 list 长度 | 77 |
| list | array | No | 本次返回记录;文档未提供分页请求字段 | Unspecified |
| list[] | object | Unspecified | Unspecified | Unspecified |
| list[].content | string | No | 检索文本摘要,可能含高亮标记;按非可信文本处理,不能直接执行 HTML | 成都**房地产开发有限公司:本院受理相关纠纷一案…… |
| list[].id | string | No | 该类别配套详情查询的原始 ID,按字符串保存,不限制固定长度 | 23D17485F665AE0F |
Response Example
{
"count": 77,
"list": [
{
"content": "成都**房地产开发有限公司:本院受理相关纠纷一案……",
"id": "23D17485F665AE0F"
}
]
}$.rc == '0000'API overview
Capabilities, use cases, limitations, and frequently asked questions.
API capabilities
Search Chinese court announcements by keywords. Results contain a source-reported total and a list of text snippets with original IDs for the corresponding announcement detail API. Fuzzy and exact matching and optional highlighting help locate candidate records. Announcement type, publisher and publication date are not separate fields in this list.
Use cases
Company information tools can offer candidate announcements for manual review. Case information pages can preview snippets before a user selects a detail record. Applications handle party identification, deduplication, classification and reminders. Court announcements and hearing announcements use different endpoints; do not interchange their detail IDs.
Calling and interpreting results
Submit entityName and a sign generated for the calling date using POST. The documented plus separator can join multiple keywords. Choose matching with matchType and highlighting with fl. Check the business result code, then read count and list. Send the selected id unchanged to the matching court announcement detail API. A snippet may omit parts of the original text, so do not infer missing parties or dates.
Scope and limitations
Coverage, update intervals and text completeness depend on the source. No full-coverage or live-update guarantee is provided. The reported count may exceed the list length, and there is no pagination input. Escape or sanitize highlighted text before display. Empty results apply only to the submitted conditions; a name match or announcement does not establish liability or a judgment outcome.
Frequently asked questions
How do I retrieve the announcement text?
Use the returned id with the matching court announcement detail API; assess the actual text received.