API DETAIL

企业检索接口

按企业名称关键词检索企业候选，用于先获取企业 ID 和统一社会信用代码；name必填，top_k默认 10，范围 1 到 50，越界按默认值处理。返回候选企业基础标识，不是企业完整详情。

分类：企业信息 方法：GET MCP Tool：yuandian_rh_enterpriseSearch

首屏摘要

接口名称企业检索接口
接口描述按企业名称关键词检索企业候选，用于先获取企业 ID 和统一社会信用代码；name必填，top_k默认 10，范围 1 到 50，越界按默认值处理。返回候选企业基础标识，不是企业完整详情。
分类企业信息
调用地址https://open.chineselaw.com/open/rh_enterpriseSearch
文档摘要企业检索接口 1. 基本信息 **接口名称**：企业检索接口 **接口用途**：按企业名称关键词检索企业候选，用于先获取企业 ID 和统一社会信用代码；name必填，top_k默认 10，范围 1 到 50，越界按默认值处理。返回候选企业基础标识，不是企业完整详情。 2. 请求信息 **HTTP Method**：GET **URL**：{{API_URL}} 3. 请求参数（Query） 参数名 类型 是否必填 说明 ------- ------ -------- ---…

请求参数

3. 请求参数（Query）

参数名 类型 是否必填 说明
name string 是 企业名称
top_k int 否 返回条数，默认10，范围1~50，越界按默认值处理

响应参数

5. 响应说明

  • 返回类型：JSON 字符串

  • 成功/失败判断：看 status 与 code

  • code说明

    code 说明
    200 接口调用成功
    500 参数校验/程序内部异常，具体描述见message信息

5.1 通用返回结构

字段名 类型 说明
status string success / notFound 等
code number 成功 200
message string 提示信息
data object 数据结果

5.2 data 对象说明

字段名 类型 说明
id string 企业ID
企业名称 string 企业名称
统一社会信用代码 string 统一社会信用代码

错误码

错误码说明
500参数校验/程序内部异常，具体描述见message信息

调用示例

CURL

curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseSearch?name=百度网讯&top_k=10' \
--header 'X-API-Key: 你的api_key' \
--header 'Accept: application/json'

JAVA

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class EnterpriseSearchExample {
    public static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "https://open.chineselaw.com/open/rh_enterpriseSearch?name=百度网讯&top_k=10";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .timeout(Duration.ofSeconds(60))
                .header("X-API-Key", apiKey)
                .header("Accept", "application/json")
                .GET()
                .build();

        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

PYTHON

import requests

url = "https://open.chineselaw.com/open/rh_enterpriseSearch"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
}
params = {
    'name': '百度网讯',
    'top_k': '10',
}
response = requests.get(url, params=params, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

JAVASCRIPT

const API_KEY = "你的api_key";
const url = new URL("https://open.chineselaw.com/open/rh_enterpriseSearch");
url.searchParams.set('name', '百度网讯');
url.searchParams.set('top_k', '10');

const res = await fetch(url, {
  method: "GET",
  headers: {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());

MCP Tool 名称

MCP Serveryuandian-company（企业信息 Server）
Streamable HTTP 入口https://open.chineselaw.com/mcp/company/stream
MCP Toolyuandian_rh_enterpriseSearch

响应示例

## 6. 响应示例

```JSON
{
  "code": 200,
  "data": [
    {
      "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14",
      "统一社会信用代码": "91110000802100433B",
      "企业名称": "北京百度网讯科技有限公司"
    },
    {
      "id": "63df0ffb-2c04-4a87-955a-dd4af21e62bb",
      "统一社会信用代码": "914403006748096152",
      "企业名称": "北京百度网讯科技有限公司深圳分公司"
    },
    {
      "id": "7362097b-ee0c-4aa5-b14d-7a499c5283f7",
      "统一社会信用代码": "914419006751765224",
      "企业名称": "北京百度网讯科技有限公司东莞分公司"
    },
    {
      "id": "eb462768-37b5-4d60-b55e-9ffc25c1cd37",
      "统一社会信用代码": "91440101675657502F",
      "企业名称": "北京百度网讯科技有限公司广州分公司"
    },
    {
      "id": "68e55e77-06b6-4e6f-a0d2-0115e4ed298b",
      "统一社会信用代码": "91310114674598440W",
      "企业名称": "北京百度网讯科技有限公司上海分公司"
    },
    {
      "id": "12a600b2-79c1-4b9f-b96b-40045c749f7e",
      "统一社会信用代码": "91350102MA2XW3LD3F",
      "企业名称": "福州百度网讯网络科技有限公司"
    },
    {
      "id": "f6afc0e6-2ee1-4c7e-b106-21ffc27f6505",
      "统一社会信用代码": "91610131592209907Q",
      "企业名称": "北京百度网讯科技有限公司西安分公司"
    },
    {
      "id": "7489b383-b2d1-485a-8cc8-c68203074f10",
      "统一社会信用代码": "91500000588927949C",
      "企业名称": "北京百度网讯科技有限公司重庆分公司"
    },
    {
      "id": "308177f3-9f0a-4c0e-bd5f-0bcc70557669",
      "统一社会信用代码": "91320104070740629E",
      "企业名称": "北京百度网讯科技有限公司南京分公司"
    },
    {
      "id": "c751d3b8-e48a-475d-b11f-492bed03d0ae",
      "统一社会信用代码": "",
      "企业名称": "北京百度网讯科技有限公司佛山分公司"
    }
  ],
  "message": "请求成功",
  "status": "success"
}
```

完整文档

企业检索接口

1. 基本信息

  • 接口名称：企业检索接口
  • 接口用途：按企业名称关键词检索企业候选，用于先获取企业 ID 和统一社会信用代码；name必填，top_k默认 10，范围 1 到 50，越界按默认值处理。返回候选企业基础标识，不是企业完整详情。

2. 请求信息

  • HTTP Method：GET
  • URL：https://open.chineselaw.com/open/rh_enterpriseSearch

3. 请求参数（Query）

参数名 类型 是否必填 说明
name string 是 企业名称
top_k int 否 返回条数，默认10，范围1~50，越界按默认值处理

4. 请求示例

GET https://open.chineselaw.com/open/rh_enterpriseSearch?name=百度网讯&top_k=10

5. 响应说明

  • 返回类型：JSON 字符串

  • 成功/失败判断：看 status 与 code

  • code说明

    code 说明
    200 接口调用成功
    500 参数校验/程序内部异常，具体描述见message信息

5.1 通用返回结构

字段名 类型 说明
status string success / notFound 等
code number 成功 200
message string 提示信息
data object 数据结果

5.2 data 对象说明

字段名 类型 说明
id string 企业ID
企业名称 string 企业名称
统一社会信用代码 string 统一社会信用代码

6. 响应示例

{
  "code": 200,
  "data": [
    {
      "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14",
      "统一社会信用代码": "91110000802100433B",
      "企业名称": "北京百度网讯科技有限公司"
    },
    {
      "id": "63df0ffb-2c04-4a87-955a-dd4af21e62bb",
      "统一社会信用代码": "914403006748096152",
      "企业名称": "北京百度网讯科技有限公司深圳分公司"
    },
    {
      "id": "7362097b-ee0c-4aa5-b14d-7a499c5283f7",
      "统一社会信用代码": "914419006751765224",
      "企业名称": "北京百度网讯科技有限公司东莞分公司"
    },
    {
      "id": "eb462768-37b5-4d60-b55e-9ffc25c1cd37",
      "统一社会信用代码": "91440101675657502F",
      "企业名称": "北京百度网讯科技有限公司广州分公司"
    },
    {
      "id": "68e55e77-06b6-4e6f-a0d2-0115e4ed298b",
      "统一社会信用代码": "91310114674598440W",
      "企业名称": "北京百度网讯科技有限公司上海分公司"
    },
    {
      "id": "12a600b2-79c1-4b9f-b96b-40045c749f7e",
      "统一社会信用代码": "91350102MA2XW3LD3F",
      "企业名称": "福州百度网讯网络科技有限公司"
    },
    {
      "id": "f6afc0e6-2ee1-4c7e-b106-21ffc27f6505",
      "统一社会信用代码": "91610131592209907Q",
      "企业名称": "北京百度网讯科技有限公司西安分公司"
    },
    {
      "id": "7489b383-b2d1-485a-8cc8-c68203074f10",
      "统一社会信用代码": "91500000588927949C",
      "企业名称": "北京百度网讯科技有限公司重庆分公司"
    },
    {
      "id": "308177f3-9f0a-4c0e-bd5f-0bcc70557669",
      "统一社会信用代码": "91320104070740629E",
      "企业名称": "北京百度网讯科技有限公司南京分公司"
    },
    {
      "id": "c751d3b8-e48a-475d-b11f-492bed03d0ae",
      "统一社会信用代码": "",
      "企业名称": "北京百度网讯科技有限公司佛山分公司"
    }
  ],
  "message": "请求成功",
  "status": "success"
}