企业全景信息查询 API工商照面 33 项、股东出资、变更与社保一次查全做供应商准入、客户尽职调查、授信风控时需要的信息往往不止「这家公司存不存在」经营状态是否正常、注册资本与实缴、股东结构与出资明细、历史上改过什么、参保人数有没有异常——这些信息分散在工商公示的不同板块里逐个去查要调好几个接口、拼好几套字段。enterprise.detail把四个维度合并成一次查询工商照面 33 项 股东及认缴 / 实缴出资 工商变更记录 分年度社保参保一次 GET 请求全部返回并且查不到该企业不收费。接口速览关键事实说明接口地址https://api.xujian.tech/openapi/enterprise/detail接口编码enterprise.detail请求方式GETkeyword放 Query String鉴权方式请求头X-API-Key不做签名、时间戳或加密唯一业务参数keyword企业工商登记全称或统一社会信用代码去空格后 2 ~ 50 个字符返回四大块basicInfo/partners/changeRecords/socialSecurity计费方式按次计费0.52 元/次先预鉴权、查到企业后再扣费不计费场景关键词非法、服务不可用、未查询到该企业典型耗时通常 1 ~ 3 秒建议客户端超时至少 15 秒条数限制无limit、无分页按上游实际结果完整返回一、哪些业务需要这一步场景具体用法供应商准入一次拿到状态、注册资本、股东与参保规模判断是否为壳公司客户尽职调查核对统一社会信用代码与注册地址配合变更记录看历史沿革授信与风控用经营状态、吊销 / 注销信息、变更频率做风险打分企业档案补全CRM 里只有企业名批量补全信用代码、法人、经营范围股东穿透从partners拿到股东名单与持股比例继续向上穿透合同评审签合同前核对企业名称、法人、经营期限是否异常招投标资格审核校验经营范围是否覆盖招标内容、状态是否正常招商与获客按行业代码domain与地区筛选目标企业贷后监控定期复查状态与变更记录发现法人 / 股东变动及时预警企业画像标签用tags高新企业 / 上市等与参保人数打标签二、请求参数2.1 请求头参数名必填说明X-API-Key是开发者 API Key缺失或无效直接返回失败2.2 查询参数参数名必填类型示例说明keyword是String91500113MAABRA7D0H企业工商登记全称或统一社会信用代码去首尾空白后2 ~ 50 个字符2.3 关键词怎么填才查得准优先用统一社会信用代码18 位唯一且不会重名准确率最高。用名称时必须是登记全称。接口不做模糊匹配传简称大概率查不到。拿不准全称时先用企业信息模糊查询enterprise.query0.01 元/次校正全称再查本接口比反复猜更省钱。三、返回字段3.1 顶层与 data字段类型说明codeint0成功非 0 失败统一为500msgString成功为success失败为具体原因dataObject业务数据失败时为nulldata 字段字段类型示例说明keywordString91500113MAABRA7D0H去首尾空白后的查询关键词basicInfoObject{…}工商照面 33 项partnersArray[…]股东及认缴 / 实缴出资明细changeRecordsArray[…]工商变更记录socialSecurityArray[…]分年度社保参保信息apiCodeStringenterprise.detail接口编码apiNameString企业详细信息综合查询接口名称chargeTypeStringPER_CALL本次计费方式balanceBigDecimal99.4800成功结算后的账户余额元costMsLong1860本次调用总耗时毫秒3.2 basicInfo工商照面 33 项字段示例含义name重庆可乐家装饰工程有限公司企业名称formatName重庆可乐家装饰工程有限公司清洗后的标准名称creditNo91500113MAABRA7D0H统一社会信用代码regNo500113014353471企业注册号orgNo91500113MAABRA7D0H组织机构号status存续在营、开业、在册工商公示经营状态原文newStatus存续清洗后状态存续 / 注销 / 吊销 / 撤销 / 迁出 / 设立中 / 清算中 / 停业 / 其他 / 歇业 / 责令关闭operName李伦智法定代表人姓名title法定代表人代表人职务operTypePP个人C公司registCapi100 万人民币注册资本actualCapi-实缴资本currencyUnitCNY货币单位startDate2021-06-02成立日期termStart2021-06-02营业开始日期termEnd-营业结束日期-表示长期endDate-注销日期checkDate2021-06-02最近一次核准日期revokeDate-吊销日期revokeReason-吊销原因logoutReason-注销原因econKind有限责任公司企业类型econKindCode1100企业类型代码typeNew0101大陆企业 /02社会组织 /03机关及事业单位 /04港澳台及国外 /05律所及其他categoryNew01156010115601企业 /0115602个体 /0115603农民专业合作社domainD4511国民经济行业四级代码address重庆市巴南区……注册地址belongOrg重庆市巴南区市场监督管理局登记机关districtCode500110所属行政区划代码scope许可项目住宅室内装饰装修……完整经营范围tags[]企业标签1 新三板 / 6 主板上市 / 9 香港上市 / 17 高新企业 / 40 暂停上市 / 41 终止上市historyNames[]历史名称fenname-企业英文名3.3 partners[]股东与出资字段示例含义name李伦智股东名称stockType自然人股东股东类型identifyType-证件类型-表示未公示identifyNo-证件号码-表示未公示stockPercent1.0持股比例小数形式1.0 100%totalRealCapi-实缴出资总额totalShouldCapi100 万人民币认缴出资总额startDate2021-06-02出资 / 首次认缴日期shouldCapiItems[{date, capi, type}]认缴明细realCapiItems[]实缴明细shouldCapiItems[]/realCapiItems[]元素date出资日期、capi金额如100 万人民币、type出资方式如货币。3.4 changeRecords[]工商变更字段示例含义changeItem章程备案变更事项changeDate2021-07-15变更日期beforeContent-变更前内容afterContent同意启用新章程变更后内容tag非历史信息非历史信息/历史信息type章程备案变更章程备案 / 注册资金 / 住所 / 股东股权 / 人员 / 地址 / 经营范围 / 其他 变更3.5 socialSecurity[]分年度社保参保字段示例含义reportYear2024年报所属年份reportDate2025-03-18年报公示日期name重庆可乐家装饰工程有限公司企业名称dwJeDisplay/bqJeDisplay/dwJsDisplay企业选择不公示缴费基数 / 实际缴费 / 累计欠缴是否公示insuranceNum3人城镇职工基本养老保险参保人数basicEndownmentNum3人基本养老保险参保人数unenploymentNum3人失业保险参保人数injuryInsuranceNum3人工伤保险参保人数birthNum/birthInsuranceCount0人生育保险参保人数basicMedicalAmount/actualMedicalAmount/baseMedicalDownBalance-医疗保险缴费基数 / 实缴 / 欠缴unenploymentInsurance/actualLostAmount/unenploymentDownBalance-失业保险相关金额endownmentInsuranceAmount/endownmentBaseAmount/actualEndownmentAmount-养老保险相关金额injuryInsuranceAmount/actualInjuryAmount/companyInjuryDownBalance-工伤保险相关金额birthAmount/birthActualAmount-生育保险相关金额3.6 三个字段口径-不等于null也不等于 0。它是工商数据里的「未公示 / 长期 / 无值」占位符展示时写「—」即可。缺失字符串是缺失数组是[]不用null表示解析时按空值兜底即可。上游内部id与法定代表人身份哈希operPid不对外返回不要依赖。四、调用示例4.1 curlcurl-s-Ghttps://api.xujian.tech/openapi/enterprise/detail\--data-urlencodekeyword91500113MAABRA7D0H\-HX-API-Key: 你的APIKey4.2 JavaHutoolimportcn.hutool.http.HttpRequest;importcn.hutool.json.JSONObject;importcn.hutool.json.JSONUtil;publicclassEnterpriseDetailClient{privatestaticfinalStringAPI_URLhttps://api.xujian.tech/openapi/enterprise/detail;/** * 查询企业详细信息 * * param apiKey 开发者 API Key * param keyword 企业全称或统一社会信用代码 * return data 节点查不到或失败返回 null且不扣费 */publicstaticJSONObjectdetail(StringapiKey,Stringkeyword){JSONObjectjsonJSONUtil.parseObj(HttpRequest.get(API_URL).header(X-API-Key,apiKey).form(keyword,keyword).timeout(20000).execute().body());if(json.getInt(code)null||json.getInt(code)!0){System.out.println(查询失败不收费json.getStr(msg));returnnull;}returnjson.getJSONObject(data);}publicstaticvoidmain(String[]args){JSONObjectdatadetail(你的APIKey,91500113MAABRA7D0H);if(datanull){return;}JSONObjectbasicdata.getJSONObject(basicInfo);System.out.printf(%s | %s | 法人 %s | 注册资本 %s | 股东 %d 人%n,basic.getStr(name),basic.getStr(newStatus),basic.getStr(operName),basic.getStr(registCapi),data.getJSONArray(partners).size());}}4.3 Pythonimportrequestsdefenterprise_detail(api_key:str,keyword:str):返回 data 节点查不到或失败返回 None且不扣费resprequests.get(https://api.xujian.tech/openapi/enterprise/detail,params{keyword:keyword},headers{X-API-Key:api_key},timeout20,)resultresp.json()ifresult.get(code)!0:print(查询失败不收费,result.get(msg))returnNonereturnresult[data]if__name____main__:dataenterprise_detail(你的APIKey,91500113MAABRA7D0H)ifdata:print(data[basicInfo][name],data[basicInfo][newStatus])4.4 JavaScriptasyncfunctionenterpriseDetail(apiKey,keyword){constqsnewURLSearchParams({keyword}).toString();constrespawaitfetch(https://api.xujian.tech/openapi/enterprise/detail?${qs},{headers:{X-API-Key:apiKey}});constresultawaitresp.json();if(result.code!0){thrownewError(result.msg);}returnresult.data;}五、返回示例{code:0,msg:success,data:{keyword:91500113MAABRA7D0H,basicInfo:{name:重庆可乐家装饰工程有限公司,creditNo:91500113MAABRA7D0H,regNo:500113014353471,status:存续在营、开业、在册,newStatus:存续,operName:李伦智,registCapi:100 万人民币,actualCapi:-,startDate:2021-06-02,termEnd:-,econKind:有限责任公司,domain:D4511,address:重庆市巴南区龙洲湾街道龙洲大道255号17-1,belongOrg:重庆市巴南区市场监督管理局,districtCode:500110,scope:许可项目住宅室内装饰装修依法须经批准的项目经相关部门批准后方可开展经营活动,tags:[],historyNames:[]},partners:[{name:李伦智,stockType:自然人股东,stockPercent:1.0,totalShouldCapi:100 万人民币,shouldCapiItems:[{date:2021-06-02,capi:100 万人民币,type:货币}],realCapiItems:[]}],changeRecords:[{changeItem:章程备案,changeDate:2021-07-15,beforeContent:-,afterContent:同意启用新章程,tag:非历史信息,type:章程备案变更}],socialSecurity:[{reportYear:2024,reportDate:2025-03-18,insuranceNum:3人,basicEndownmentNum:3人,unenploymentNum:3人,injuryInsuranceNum:3人,birthNum:0人}],apiCode:enterprise.detail,apiName:企业详细信息综合查询,chargeType:PER_CALL,balance:99.4800,costMs:1860}}查不到不收费{code:500,msg:未查询到该企业的详细信息请核对企业名称或更换统一社会信用代码后重试本次调用不计费,data:null}六、可直接复用的两段代码6.1 准入初筛状态 规模 股东defpre_check(data:dict)-dict:返回一份可读的准入结论basicdata[basicInfo]partnersdata.get(partners)or[]socialdata.get(socialSecurity)or[]latestsocial[0]ifsocialelse{}return{name:basic.get(name),credit_no:basic.get(creditNo),status:basic.get(newStatus),alive:basic.get(newStatus)存续,regist_capi:basic.get(registCapi),legal_person:basic.get(operName),partner_count:len(partners),staff_hint:latest.get(insuranceNum),risk:[]ifbasic.get(newStatus)存续else[经营状态异常],}6.2 变更记录里找敏感变动SENSITIVE{股东股权变更,注册资金变更,人员变更,住所变更,经营范围变更}defsensitive_changes(data:dict):挑出需要人工复核的变更事项rowsdata.get(changeRecords)or[]return[rforrinrowsifr.get(type)inSENSITIVE]七、实践建议关键词优先用信用代码。18 位信用代码唯一名称要精确匹配全称模糊查不到。超时至少 15 秒。接口要向多个维度取数典型 1 ~ 3 秒costMs会告诉你真实耗时。本地缓存结果。工商数据变动不频繁按企业缓存 30 ~ 90 天重复查询直接读库省下 0.52 元/次。-不要当空值处理成 0。termEnd -是「长期」转成 0 会算出「已过期」的错误结论。stockPercent是小数。1.0表示 100%展示时乘 100。参保人数只作参考。很多企业选择不公示金额字段参保人数是「3人」这种带单位的文本。复用creditNo做主键。企业名称可能变更historyNames会记录信用代码不会变。查不到不收费可以放心重试。但重试前先确认名称是否准确避免无效调用堆积。八、错误码与排查codemsg是否扣费0success扣费查到企业后结算500缺少请求头 X-API-Key否500API Key 无效 / API Key 已停用否500客户不存在或已停用否500接口不存在或已停用否500余额不足请先充值否500keyword 不能为空否500keyword 至少需要 2 个字符建议使用企业全称或统一社会信用代码否500keyword 长度不能超过 50 个字符否500数据服务未启用 / 数据服务未配置上游凭证缺失否500未查询到该企业的详细信息请核对企业名称或更换统一社会信用代码后重试本次调用不计费否500数据服务暂时不可用请求上游超时或网络异常本次调用不计费否结算判定很简单只有basicInfo.name有值时才扣费。其余所有失败分支都不产生费用。九、计费与接入项目说明单价0.52 元/次计费方式按次计费preAuthorize预校验 → 查询 → 查到企业后settle扣费不计费场景关键词为空 / 少于 2 字符 / 超过 50 字符、服务未启用或凭证缺失、上游超时或返回异常、未查询到该企业、Key / 客户 / 接口校验失败、余额不足返回条数无limit、无分页四个维度按上游实际结果完整返回接入流程注册开发者账号 → 控制台创建 API Key → 请求头带上X-API-Key即可调用无需签名或加密。控制台可查看调用量、扣费流水与余额。服务站点api.xujian.tech纯文本域名不做跳转。接口试用、数据与充值咨询可在控制台提交工单或联系 Vxujian_cq。十、小结一个关键词换回四个维度的结构化数据省掉的是「查四遍、拼四套、口径还要自己对齐」的工作量。几个取舍值得记住查不到不收费先校正名称再查试错成本是 0-是业务占位表示未公示 / 长期 / 无值别当成 0 参与计算信用代码是最佳主键名称会变代码不变缓存价值高工商数据低频变动缓存一次能省下不少调用成本。同系列还有enterprise.query0.01 元/次名称模糊查询适合先校正全称、enterprise.profile0.2 元/次只要 33 项照面、enterprise.abnormal与enterprise.dishonesty各 0.2 元/次经营异常与失信记录、enterprise.report0.3 元/次多年度工商年报。按需组合比一律查最贵的接口更划算。