适用场景为什么需要单一企业深度查询在供应链金融、企业合作背调、投资尽调、信贷审核等业务中常常需要对某一个具体企业进行全方位的工商信息验证。不同于列表式的模糊搜索深度查询需要返回企业准备信息、股东结构、高管名单、对外投资图谱、历史变更记录以及被执行、失信被执行、限制高消费、经营异常、严重违法、行政处罚等风险维度。如果每查一个维度就调用一次不同接口不仅增加网络开销还容易因数据源不一致导致分析断裂。企业档案深度查询API正是为解决这一痛点而生一次请求按需返回多个维度的结构化数据并附带企业规模标签、经营状态、成立年限、活力评分与自然语言摘要极大降低多接口整合的复杂度。接口能力边界查询主体单次请求只能查询一个企业通过company参数指定名称。数据范围覆盖工商基本信息basic、股东信息shareholders、主要成员executives、对外投资investments、变更记录changes、风险综合risk六大维度且每个维度可独立选择。QPS限制5次/秒适合中低频次的实时查询或批量离线任务。数据时效6小时缓存机制。当天变更的数据可能存在延迟请勿用于需要实时秒级更新的场景如当日工商变更提醒。返回量级每个维度的数据量取决于企业复杂度单次响应体可能较大特别是股东或对外投资较多的公司建议根据实际需要选择维度避免传输无用字段。请求参数与鉴权请求地址POST https://v1.apizero.cn/api/company-profileHeader参数参数名必需类型说明Authorization是stringBearer 后跟您的API Key例如Bearer sk-your-key-hereContent-Type否string请求体格式默认使用application/json通常不需要显式设置注意部分旧版本客户端可能使用X-API-Key头进行鉴权但请以官方最新文档为准推荐使用Authorization: Bearer标准方式。请求体JSON字段必需类型说明company是string企业名称2-80个字符支持中文模糊匹配简称/全称均可兼容字段名namedimension否string查询维度多个维度用英文逗号分隔。可选值basic基本信息、shareholders股东、executives高管、investments对外投资、changes变更记录、risk风险综合。不传默认返回basic示例请求体{ company: 阿里巴巴, dimension: basic,shareholders,risk }curl 接入示例以下 curl 命令展示完整调用过程请将YOUR_API_KEY替换为真实密钥。curl -sS \ -X POST \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d {company: 阿里巴巴, dimension: basic,shareholders,risk} \ https://v1.apizero.cn/api/company-profile若使用X-API-Key方式则改为curl -sS \ -X POST \ -H X-API-Key: YOUR_API_KEY \ -H Content-Type: application/json \ -d {company: 阿里巴巴, dimension: basic,shareholders,risk} \ https://v1.apizero.cn/api/company-profile成功响应示例经格式化{ code: 0, msg: 成功, request_id: f47ac10b-58cc-4372-a567-0e02b2c3d479, data: { basic: { company_name: 阿里巴巴中国有限公司, legal_person: 示例, register_capital: 1.4 亿美元, business_status: 存续, credit_code: 9133..., establish_date: 2007-03-26 }, dimensions: [basic], extension: { company_age_years: 19, register_capital_label: 巨型企业, vitality_score: 92, vitality_level: 极高, summary: 该企业成立于2007年注册资本1.4亿美元主营业务为…… }, stats: { risk_total: 0, shareholder_count: 3 } } }Python 代码接入示例以下用requests库实现要求已安装pip install requests。import requests import json API_URL https://v1.apizero.cn/api/company-profile API_KEY YOUR_API_KEY # 请替换 def query_company_profile(company_name, dimensionsbasic): headers { Authorization: fBearer {API_KEY}, Content-Type: application/json } payload { company: company_name, dimension: dimensions } response requests.post(API_URL, headersheaders, jsonpayload, timeout15) response.raise_for_status() return response.json() # 使用示例 result query_company_profile(阿里巴巴, basic,risk,shareholders) if result.get(code) 0: data result[data] print(企业名称:, data[basic][company_name]) print(经营状态:, data[basic][business_status]) print(风险总数:, data[stats][risk_total]) print(股东数量:, data[stats][shareholder_count]) if extension in data: print(活力评分:, data[extension][vitality_score]) else: print(查询失败:, result.get(msg))注意当dimension包含shareholders时返回的股东列表会嵌套在data.shareholders数组中素材未展示实际返回包含shareholder_list等字段。请根据实际响应体进行解析。返回字段解读顶层结构字段类型说明codeint业务状态码0表示成功非0表示失败msgstring状态描述信息request_idstring本次请求唯一标识可用于日志追踪dataobject核心数据对象内容由请求的dimension决定data 对象basicobject企业工商基本信息包含公司名、法人、准备资本、经营状态、统一社会信用代码、成立日期等。shareholdersobject | array当请求维度包含shareholders时返回包含股东列表、持股比例等。executivesobject | array高管人员信息。investmentsobject | array对外投资企业列表。changesobject | array历史变更记录按时间倒序。riskobject | array风险综合信息包含六类风险的数量和详情。dimensionsarray实际返回的维度名称列表。extensionobject扩展信息包括企业成立年限company_age_years、准备资本标签register_capital_label、活力评分vitality_score0-100、活力等级vitality_level极高/高/中/低/极低以及自然语言摘要summary。statsobject统计数据如风险总数risk_total、股东数量shareholder_count等。关于风险维度当请求risk维度时data.risk对象会包含以下子维度具体字段名以实际为准通常为数组executed被执行信息dishonest失信被执行信息high_consumption_limit限制高消费信息business_abnormal经营异常信息serious_violation严重违法信息administrative_penalty行政处罚信息每个子维度均包含数量count和详情列表list方便程序化处理。常见错误与处理HTTP状态码code值含义处理建议2000成功-2001001企业名称不能为空检查company参数是否缺失或为空字符串2001002企业名称长度不合法确保长度在2-80字符之间2001003未找到该企业信息输入的企业名称可能不存在或拼写有误建议更换关键词如去掉地域名401-鉴权失败检查 Authorization 头是否正确API Key 是否过期或无效429-请求频率超过限制降速至 5 次/秒以内或等间隔重试500-服务端内部错误稍后重试如果持续则联系技术支持幂等性说明相同请求返回的request_id通常不同但数据内容在 6 小时缓存期内保持一致。如果需要实时数据请考虑缓存策略。工程化注意事项按需选择维度每多一个维度会增加响应体积和接口处理时间。在批量调用时建议仅请求业务必要的维度并设置合理的超时如15秒。缓存设计由于数据有6小时缓存可以在业务层增加本地缓存如RedisTTL设为5-6小时避免重复请求浪费API配额。同时注意缓存过期后应主动刷新而非等到用户查询时再刷新。错误重试策略对于429和5xx错误采用指数退避重试初始1秒最多3次对于4xx业务错误如1003未找到无需重试直接返回给前端。名称模糊匹配company支持简称和全称模糊搜索但极端情况下可能匹配到多个类似企业返回优先级最高的一个。如果需要精确匹配建议先调用企业列表接口获取统一信用代码再通过company传入精确名称。目前接口并未提供信用代码查询参数所以请尽量使用完整官方名称。风险数据的判空当企业无风险记录时risk_total为0但risk对象中的各子维度可能仍然存在count0或list[]注意代码中做非空判断。数据合规性该接口返回的工商数据来源于公开渠道但仍需遵守与接口提供方的使用协议不可用于违法违规活动或不正当竞争。参考文档官方文档页https://apizero.cn/aidocs/company-profile原始文档Markdownhttps://apizero.cn/aidocs/company-profile/raw.md以上文档包含详细的返回字段枚举、错误码列表及更新日志建议在对接前仔细阅读。