企业档案深度查询API零基础接入与字段详解

适用场景企业档案深度查询接口专为需要单一企业全维度工商数据的场景设计常用于以下业务环节商业尽调在投资、并购前对目标公司进行基础信息、股东结构、高管背景的普查。合作方背调在供应商准入、渠道签约时核验企业的经营状态与风险记录。风控审查信贷审核、担保业务中快速获取企业的执行、失信、行政处罚等风险信号。内部数据补全需要将企业基础档案与风险标签自动回填到业务系统的场景。与仅返回关键词列表的接口不同本接口面向单条企业的深度探底支持按需组合维度的查询适合在用户输入公司全称或简称后触发的明细查询。接口能力边界请求方式POST地址https://v1.apizero.cn/api/company-profileQPS 限制5次/秒超出后会返回频率限制错误。数据新鲜度权威工商数据源6 小时缓存非实时库。若需极实时数据请自行对接官方实时接口。查询维度支持basic基本信息、shareholders股东、executives高管、investments对外投资、changes变更记录、risk风险综合共六个维度的任意组合用英文逗号分隔。输入限制企业名称 2–80 字符支持模糊简称匹配如“阿里巴巴”即可命中“阿里巴巴中国有限公司”。单次响应只返回一条匹配度最高的企业档案若多企业重名可能返回最可能的那个不保证返回所有同名企业。鉴权与请求参数鉴权方式在 HTTP Header 中传入 API Key支持两种方式Authorization: Bearer 你的 API KeyX-API-Key: 你的 API Key某些客户端旧版本兼容推荐使用Authorization标准方式。API Key 需在平台获取本文不赘述申请流程。Header 参数参数名是否必须类型说明Authorization是stringBearer API KeyContent-Type否string默认为application/json请求体JSON字段名是否必须类型说明company是string企业名称2–80 字符支持简称/全称模糊搜索兼容别名namedimension否string查询维度多维度用逗号分隔如basic,shareholders,risk若不传dimension默认仅返回basic维度即基础信息。为获得完整档案建议至少包含basic,risk两个维度。请求体示例{ company: 北京字节跳动科技有限公司, dimension: basic,shareholders,executives,risk }curl 接入示例以下 curl 命令演示了带维度组合的完整请求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执行说明请将YOUR_API_KEY替换为实际 API Key。返回值是 JSON 格式建议用jq解析curl ... | jq .若不传dimension服务端会按缺省值basic处理。返回字段解读响应示例压缩{ code: 0, msg: 成功, request_id: f47ac10b-58cc-4372-a567-0e02b2c3d479, data: { basic: { company_name: 华为技术有限公司, credit_code: 91440300279501004G, legal_person: 赵明路, establish_date: 1987-09-15, business_status: 存续, register_capital: 403.6246 亿元人民币 }, dimensions: [basic, shareholders, risk], extension: { company_age_years: 37, register_capital_label: 巨型企业, vitality_score: 95, vitality_level: 极高, summary: 华为技术有限公司成立于1987年注册资本403.6亿元存续状态股东结构清晰暂无高风险记录。 }, stats: { risk_total: 0, shareholder_count: 2 } } }顶层字段字段类型说明codeint业务状态码0 表示成功非 0 表示异常见错误处理msgstring提示信息request_idstring唯一请求 ID可用于排查问题dataobject实际数据主体data 结构basic基础信息仅在请求包含basic维度时返回。company_name企业全称匹配的官方名称credit_code统一社会信用代码脱敏中间部分如9144...4Glegal_person法定代表人establish_date成立日期business_status经营状态存续/吊销/注销等register_capital准备资本带单位dimensions实际返回的维度列表与请求中的dimension可能不一致因为某些维度无数据会被省略extension扩展信息始终返回无需在dimension中指定company_age_years成立年数计算值register_capital_label准备资本标签如“微型企业”“小型企业”“中型企业”“大型企业”“巨型企业”vitality_score企业活力评分整数范围 0–100vitality_level活力等级低/中/高/极高summary自然语言摘要概括核心信息与风险状况stats统计数据始终返回risk_total六大类风险总数如 0shareholder_count股东人数若请求包含shareholders维度才有实际值否则可能为 0注意当请求包含shareholders、executives、investments、changes、risk维度时data中会额外返回对应数组如shareholders: [ { shareholder_name: ..., ratio: ... } ]。请以实际返回为准。常见错误码与排查codemsg 示例可能原因解决建议0成功——1001参数缺失company 不能为空未传company或值为空检查请求体 JSON 字段名称是否正确1002企业名称长度不在 2–80 范围内输入的company太短或太长修正企业名称1003维度参数不合法dimension包含了非定义的维度名称仅使用预设的六种维度2001未找到匹配的企业输入名称过于模糊或数据库中无该企业尝试更精确的全称或检查名称拼写4001请求频率超限每秒 QPS 超过 5 次增加请求间隔或使用本地缓存5001内部服务错误服务端异常稍后重试或检查请求 ID 提交工单若返回 HTTP 401请检查AuthorizationHeader 格式是否缺少Bearer前缀及 API Key 是否有效。工程化注意事项维度按需选择不需要的维度不要请求以减少响应体大小和响应时间。例如仅做风险筛查可只传basic,risk。缓存策略数据有 6 小时缓存对同一个企业同一天的多次请求可直接缓存本地避免耗光 QPS。错误重试对5001和4001错误实现指数退避重试如 1s、2s、4s。4001时减小并发。名称匹配输入的企业名称可能返回非精确匹配的结果如“华为”可能匹配“华为技术有限公司”而非“华为云计算技术有限公司”。建议在前端/业务层增加二次确认步骤。字段兼容性basic中的credit_code默认脱敏中间部分如需明文信用代码请查阅文档确认是否需额外权限。日志与监控记录request_id和code便于排查调用链路。参考文档企业档案深度查询 API 官方文档原始 API 说明Markdown