企业详细信息综合查询接口（enterprise.detail）：工商照面 + 股东 + 变更 + 社保

这个接口能解决什么问题

做供应商准入尽调、金融风控 KYC、股权投资标的画像时，单看工商照面远远不够，还需要股东结构、历史变更与社保参保情况。enterprise.detail 一次请求把四个维度全部返回，不必分别调用多个接口，也不必由调用方做多次付费拼接。

一句话说明

一次拿到企业全景：工商照面 33 项 + 股东出资明细 + 工商变更记录 + 分年度社保参保。

适用场景

供应商准入尽调：看股东结构、实缴与变更历史
金融风控 KYC 与反欺诈：结合社保人数判断经营真实性
股权投资标的画像：快速建立企业全景档案
招商尽调、企业 ERP 主数据初始化

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/enterprise/detail`
请求方式	GET（keyword 放 Query String）
鉴权方式	请求头 `X-API-Key`
接口编码	`enterprise.detail`
收费类型	按次计费（PER_CALL，0.5200 元/次）
计费规则	查得计费：关键词非法、上游不可用、查不到工商照面时失败且不扣费（以 basicInfo.name 是否有值为准）
典型用途	供应商尽调、风控 KYC、股权画像、招商尽调

返回结构速览

basicInfo —— 工商照面 33 项（名称、信用代码、法定代表人、注册资本、经营状态、经营范围等）
partners —— 股东名单与认缴 / 实缴出资明细
changeRecords —— 工商变更记录（事项、前后内容、日期）
socialSecurity —— 分年度社保参保（五险人数与缴费基数）

如何调用

cURL

curl -s -G "https://api.xujian.tech/openapi/enterprise/detail" --data-urlencode "keyword=91500113MAABRA7D0H" -H "X-API-Key: 你的APIKey"

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

JSON

{
  "code": 0,
  "msg": "success",
  "data": {
    "keyword": "91500113MAABRA7D0H",
    "basicInfo": {
      "name": "重庆可乐家装饰工程有限公司",
      "creditNo": "91500113MAABRA7D0H",
      "operName": "李伦智",
      "registCapi": "100 万人民币",
      "newStatus": "存续",
      "econKind": "有限责任公司"
    },
    "partners": [
      { "name": "李伦智", "stockType": "自然人股东", "stockPercent": "1.0", "totalShouldCapi": "100 万人民币" }
    ],
    "changeRecords": [
      { "changeItem": "章程备案", "changeDate": "2021-07-15", "afterContent": "同意启用新章程" }
    ],
    "socialSecurity": [
      { "reportYear": "2024", "insuranceNum": "3人", "basicEndownmentNum": "3人" }
    ],
    "apiCode": "enterprise.detail",
    "apiName": "企业详细信息综合查询",
    "chargeType": "PER_CALL",
    "balance": 99.4800,
    "costMs": 1860
  }
}

计费说明

按次计费，0.5200 元/次。采用「先预鉴权、查到有效工商照面后扣费」两段式；关键词为空 / 超长、上游不可用、查不到对应企业时返回失败，不扣费、不写扣费流水。

常见问题

为什么没有返回 id 字段？ 上游企业唯一标识属数据源内部主键，跨批次不稳定也不可解读，建议用 creditNo 作为业务主键。
注册资本怎么解析成数字？ registCapi 是「金额 + 空格 + 万 + 货币单位」字符串，注意单位一般为万元，币种看 currencyUnit（通常 CNY）。
历史变更记录能返回多少条？ 以工商公示实际记录为准，通常从设立至今全部返回，入库时建议按 changeDate + changeItem + afterContent 去重。
耗时多少？ 需汇总四个维度，通常 1 ~ 3 秒，客户端超时建议设 15 秒以上。