`search_enterprise`

按企业名称关键词搜索企业主档。

英文描述

Search normalized enterprise master records by company name keyword from ads_enterprise_master. Use when the user gives a company name (full or partial) and you need ent_id or credit_code for follow-up queries. Returns paginated enterprises with ent_id, credit_code, ent_name, status, legal person, etc. If user provides unified social credit code, use get_enterprise_by_credit_code instead.

文档更新：2026-06-23T10:00:00+08:00

请求参数

参数名	参数说明	数据类型	样例数据
`keyword`	必填；至少 2 个字符	string	中石化
`limit`	选填	integer	20
`offset`	选填	integer	0

响应参数

参数名	参数说明	数据类型	样例数据
`data`	业务记录数组	array	[{"ent_id": "EN202401011234567890", "credit_code": "91310000123456789X", "ent_name": "上海某某化工有限公司", "legal_person": "张三", "reg_capital": "5000万人民币", "reg_status": "存续", "province": "上海市"}]
`data[].ent_id`	企业全局 ID	string	EN202401011234567890
`data[].credit_code`	统一社会信用代码	string	91310000123456789X
`data[].ent_name`	企业名称	string	上海某某化工有限公司
`data[].legal_person`	法定代表人	string	张三
`data[].reg_capital`	注册资本	string	5000万人民币
`data[].reg_status`	登记状态	string	存续
`data[].province`	省份	string	上海市
`meta.total`	命中总数	integer	100
`meta.limit`	本页 limit	integer	20
`meta.offset`	本页 offset	integer	0
`meta.has_more`	是否还有下一页	boolean	true

响应状态说明

状态	说明
`success`	调用成功，返回业务数据
`failed`	参数错误、后端业务错误或系统异常
`denied`	API Key 无效、无权限、RBAC/菜单拒绝等

请求示例

{
  "keyword": "中石化",
  "limit": 20,
  "offset": 0
}

响应示例

{
  "data": [
    {
      "ent_id": "EN202401011234567890",
      "credit_code": "91310000123456789X",
      "ent_name": "上海某某化工有限公司",
      "legal_person": "张三",
      "reg_capital": "5000万人民币",
      "reg_status": "存续",
      "province": "上海市"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}