court-announcement-search

法院公告檢索

依關鍵字檢索中國法院公告，支援模糊或精確比對，回傳總數、摘要及配套詳情 ID。

呼叫價格

20 匠幣/次

快速接入請求欄位響應欄位介面簡介

快速接入

保持統一返回結構，直接透過服務端發起請求即可接入。

POSThttps://openapi.toolkk.com/v1/court-announcement-search

cURL Python Go Java PHP

cURL 示例

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 示例

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 示例

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 示例

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 示例

<?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;

響應示例

{
  "count": 77,
  "list": [
    {
      "content": "成都**房地产开发有限公司：本院受理相关纠纷一案……",
      "id": "23D17485F665AE0F"
    }
  ]
}

範例用於理解回傳結構，實際結果以介面回傳為準。

請求欄位

從伺服器發起請求，並在 X-API-Key 標頭中傳入金鑰。

請求欄位

欄位來自介面結構定義。未提供的說明和範例會標為未標註。

欄位路徑	型別	必填	說明	示例值
sign	`string`	是	调用当日签名：对 6tj4u 与调用日期 yyyyMMdd 拼接字符串计算 32 位 MD5。样例仅适用于 2026-10-09，跨日重新生成；不要把示例值作为默认常量。	`841ef7c95cd3a25b3187cf4aa193c016`
entityName	`string`	是	关键字,必填。支持按多个关键字查询，多个关键字之间用+分隔	`成都中鹏房地产开发有限公司`
matchType	`string`	否	匹配类型,0:模糊匹配;1:精确匹配.可选,默认模糊匹配	`0`
fl	`string`	否	是否显示高亮,0:不显示高亮;1:显示高亮.可选,默认显示高亮	`1`

請求示例

{
  "sign": "841ef7c95cd3a25b3187cf4aa193c016",
  "entityName": "成都中鹏房地产开发有限公司",
  "matchType": "0",
  "fl": "1"
}

鑑權方式: 請求頭傳入 X-API-Key
預設限流: 60 次/分鐘
超時時間: 10000 ms

響應欄位

範例用於理解回傳結構，實際結果以介面回傳為準。

響應欄位

欄位來自介面結構定義。未提供的說明和範例會標為未標註。

欄位路徑	型別	必填	說明	示例值
count	`integer`	否	数据源报告的结果总数，不保证等于本次 list 长度	`77`
list	`array`	否	本次返回记录；文档未提供分页请求字段	`未標註`
list[]	`object`	未標註	未標註	`未標註`
list[].content	`string`	否	检索文本摘要，可能含高亮标记；按非可信文本处理，不能直接执行 HTML	`成都**房地产开发有限公司：本院受理相关纠纷一案……`
list[].id	`string`	否	该类别配套详情查询的原始 ID，按字符串保存，不限制固定长度	`23D17485F665AE0F`

響應示例

{
  "count": 77,
  "list": [
    {
      "content": "成都**房地产开发有限公司：本院受理相关纠纷一案……",
      "id": "23D17485F665AE0F"
    }
  ]
}

成功判定$.rc == '0000'

介面簡介

介面功能、應用情境、使用限制與常見問題。

介面能力

依關鍵字檢索資料來源中的中國法院公告，回傳結果總數及本次摘要清單。每筆紀錄含文字摘要與原始詳情 ID，可供配套法院公告詳情使用。支援模糊或精確比對及高亮，適合先定位候選公告再閱讀單篇內容。清單沒有獨立的公告類型、公告人或發布日期欄位。

使用情境

企業資料工具可將公告候選交給人員查核；案件資料頁可先顯示摘要，再讓使用者選取公告閱讀詳情；內部查核系統可保留關鍵字及詳情 ID 的關聯。名稱辨識、去重、分類及提醒由呼叫端完成。法院公告與開庭公告使用不同入口，其 ID 及內容不宜直接混用。

呼叫與解讀

準備 entityName 及呼叫當日 sign，以 POST 提交。多個關鍵字依文件用加號分隔，matchType 控制比對方式，fl 可關閉高亮。確認業務回傳碼後讀取 count 及 list，將選取紀錄的 id 原樣送至配套法院公告詳情。摘要可能僅是原文片段，不能從省略文字補齊當事人、案由或日期。

範圍與限制

涵蓋範圍、更新間隔及文字完整程度依來源回傳，沒有全量或即時保證。count 可能大於清單長度，但目前沒有分頁欄位，無法承諾取得全部公告。高亮文字須跳脫或安全清理後顯示。空清單或 NO_RESULTS 只表示本次條件沒有紀錄；名稱一致及公告存在也不能直接作為失信、敗訴或責任結論。

常見問題

如何取得公告正文？

將本介面回傳的 id 送至配套法院公告詳情，正文長度與可用性依回傳資料判斷。

能依公告類型或發布日期篩選嗎？

目前沒有獨立類型、日期或頁碼條件，不能假定具備這些篩選功能。

高亮摘要可以直接當作 HTML 顯示嗎？

不建議。須將其視為不可信文字跳脫，或只保留經安全處理的允許標記。

查詢為空就表示沒有法院公告嗎？

不能。它僅表示此次條件沒有可用紀錄，須先核對關鍵字、比對方式及是否查詢失敗。

法院公告檢索 API - 工具匠

法院公告檢索

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

響應示例

請求欄位

請求欄位

請求示例

響應欄位

響應欄位

響應示例

介面簡介

介面能力

使用情境

呼叫與解讀

範圍與限制

常見問題

如何取得公告正文？

能依公告類型或發布日期篩選嗎？

高亮摘要可以直接當作 HTML 顯示嗎？

查詢為空就表示沒有法院公告嗎？

相關推薦

開庭公告檢索

裁判文書檢索

審判流程檢索

法院公告詳情查詢

裁判文書詳情查詢

開庭公告詳情查詢

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

響應示例

請求欄位

請求欄位

請求示例

響應欄位

響應欄位

響應示例

介面簡介

介面能力

使用情境

呼叫與解讀

範圍與限制

常見問題

如何取得公告正文？

能依公告類型或發布日期篩選嗎？

高亮摘要可以直接當作 HTML 顯示嗎？

查詢為空就表示沒有法院公告嗎？

相關推薦

相關工具

相關 API

開庭公告檢索

裁判文書檢索

審判流程檢索

法院公告詳情查詢

裁判文書詳情查詢

開庭公告詳情查詢