企业信息模糊查询接口（enterprise.query）：按名称 / 注册号 / 信用代码查企业

这个接口能解决什么问题

在开票补全、供应商核验、CRM 建档、风控 KYC 等场景里，你往往只有不完整的企业名称或一个注册号。enterprise.query 用这一个关键词就能模糊检索企业工商登记信息，返回名称、注册号、统一社会信用代码、企业类型、成立日期与法定代表人，平台侧完成上游数据源对接与凭证管理，调用方只需一个关键词 + 一个 X-API-Key。

一句话说明

用企业名称片段 / 注册号 / 统一社会信用代码模糊检索，查得计费：没查出结果不产生费用。

适用场景

开票信息自动补全：输入名称片段拿到准确全称与税号
CRM / ERP 客户档案完善
供应商资质核验、风控 KYC 与反欺诈
市场调研与行业名单整理

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/enterprise/query`
请求方式	GET（keyword 放 Query String）
鉴权方式	请求头 `X-API-Key`
接口编码	`enterprise.query`
收费类型	按次计费（PER_CALL，0.0100 元/次）
计费规则	查得计费：关键词为空 / 超长、上游不可用、未查到任何匹配企业时失败且不扣费
关键词长度	2 ~ 50 个字符（建议 4 个字符以上完整名称片段）
典型用途	开票补全、CRM 建档、供应商核验、风控 KYC

如何调用

cURL

curl -s -G "https://api.xujian.tech/openapi/enterprise/query" --data-urlencode "keyword=重庆可乐家装饰" -H "X-API-Key: 你的APIKey"

返回示例（节选，code = 0）

JSON

{
  "code": 0,
  "msg": "success",
  "data": {
    "keyword": "重庆可乐家装饰",
    "total": 1,
    "list": [
      {
        "name": "重庆可乐家装饰工程有限公司",
        "regNo": "500113014353471",
        "creditNo": "91500113MAABRA7D0H",
        "type": "0",
        "typeName": "企业",
        "startDate": "2021-06-02",
        "operName": "李伦智"
      }
    ],
    "apiCode": "enterprise.query",
    "apiName": "企业信息模糊查询",
    "chargeType": "PER_CALL",
    "balance": 99.9900,
    "costMs": 260
  }
}

计费说明

按次计费，0.0100 元/次。采用「先预鉴权、查得后扣费」两段式：关键词为空 / 超长、上游不可用、一条都没查到时返回失败，不扣费、不写扣费流水、不累加调用次数；只有返回至少一条企业信息才计一次费用。

常见问题

关键词填什么合适？ 企业名称片段、注册号、统一社会信用代码都可以；建议 4 个字符以上的完整名称片段，只用「科技」这类泛词会返回大量不相关结果。
最多返回多少条？ 默认最多 20 条，可用 limit 参数限制，结果按匹配度排序。
统一社会信用代码能当税号用吗？ 三证合一后多数企业二者一致，但开票场景建议以 creditNo 为准并首次人工核验。
企业类型有哪些取值？ type 为编码（0 企业、4 社团、5 律所、6 香港公司），typeName 为中文；未覆盖编码返回「其他」。