企业检索接口 API 文档
根据关键词检索企业名称返回企业候选列表,精准命中优先。
接口概览
| 接口名称 | 企业检索接口 |
|---|---|
| 接口描述 | 根据关键词检索企业名称返回企业候选列表,精准命中优先。 |
| 接口分类 | 企业信息 |
| 调用地址 | https://open.chineselaw.com/open/rh_enterpriseSearch |
| 请求方式 | GET |
请求参数
3. 请求参数(Query)
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
name |
string | 是 | 企业名称 |
top_k |
int | 否 | 返回条数,默认10,范围1~50,越界按默认值处理 |
响应参数
5. 响应说明
5.1 通用返回结构
| 字段名 | 类型 | 说明 |
|---|---|---|
status |
string | success / notFound 等 |
code |
number | 成功 200 |
message |
string | 提示信息 |
data |
object | 数据结果 |
5.2 data 对象说明
| 字段名 | 类型 | 说明 |
|---|---|---|
id |
string | 企业ID |
企业名称 |
string | 企业名称 |
统一社会信用代码 |
string | 统一社会信用代码 |
错误码
暂无错误码说明
调用示例
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 Server | yuandian-company(企业信息 Server) |
|---|---|
| Streamable HTTP 入口 | https://open.chineselaw.com/mcp/company/stream |
| MCP Tool | yuandian_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. 基本信息
- 接口名称:企业检索接口
- 接口用途:根据关键词检索企业名称返回企业候选列表,精准命中优先。
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. 响应说明
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"
}