适用场景与核心能力企业工商信息查询API通过企业名称关键词返回结构化工商数据广泛应用于以下场景客户尽职调查金融机构在开户、授信环节核实企业主体信息法人、准备资本、经营状态。供应链风控采购方对供应商进行资质核验对比统一社会信用代码与经营范围。竞品情报分析批量查询同行业企业的准备地、成立时间等公开数据。内部数据补全CRM或工单系统中根据企业名称自动填充工商字段。该接口以https://v1.apizero.cn/api/company-search为入口采用GET方法支持按企业名称关键词模糊搜索。上游数据源为天眼查权威数据库经过6小时缓存周期刷新。调用限制与用量边界QPS每秒请求数限制接口单用户QPS上限为5次/秒。超过此阈值将返回429 Too Many Requests错误。建议客户端引入限流机制如令牌桶避免突发请求导致熔断。批量查询场景中若企业名称列表超过100条推荐分批次、间隔200ms以上发送请求。关键词长度与匹配范围参数name长度限制为2~50个字符必须为UTF-8编码。不足2字符或超长时返回400错误。接口返回前5条最匹配结果按上游评分降序排列。实际匹配精度受关键词切分影响“腾讯科技”会比“腾讯”获得更精准的前5条。数据时效性边界工商数据存在6小时缓存即API返回结果最多有6小时延迟。对于当日变更的工商信息如法人变更、准备资本变更建议结合其他实时渠道验证。上游数据源为天眼查数据覆盖全国工商准备企业但偏远地区或非正常经营状态的企业可能存在缺失。返回的reg_status字段可辅助判断“存续”、“注销”等。若某次查询无匹配结果list为空数组不代表该企业不存在可尝试更换关键词或通过统一社会信用代码查询其他接口。请求参数与鉴权参数名位置类型必填说明nameQuerystring是企业名称关键词2~50字符X-API-KeyHeaderstring否API密钥不传则使用匿名额度有总量限制以平台文档为准鉴权说明推荐在HTTP头中传递X-API-Key以获得独立配额和更高QPS。匿名请求共享公共额度每日总量有限生产环境必须携带合法Key。curl 请求示例以下示例使用环境变量$APIZERO_API_KEY传递密钥查询“广州腾讯科技”curl -sS \ -X GET \ -H X-API-Key: $APIZERO_API_KEY \ https://v1.apizero.cn/api/company-search?name广州腾讯科技若不携带Key移除-H参数即可curl -sS \ -X GET \ https://v1.apizero.cn/api/company-search?name阿里巴巴注意实际运行时请将$APIZERO_API_KEY替换为你的真实Key或直接写入字符串。返回字段解读成功响应的JSON结构如下截取关键字段{ code: 0, msg: 成功, request_id: mota..., data: { keyword: 广州腾讯科技, total: 20, list: [ { id: 1466562059, name: 广州腾讯科技有限公司, legal_person: 邬红波, credit_code: 91440101327598294H, reg_capital: 7000万人民币, reg_status: 存续, establish_time: 2014-12-31, city: 广州市, district: 海珠区, address: 具体街道信息, phone: 020-81167888, email: servicetencent.com, business_scope: 电子;通信与自动控制技术研究..., category: 研究和试验发展, company_org_type: 有限责任公司, english_name: Guangzhou Tencent Technology Co., Ltd., logo: https://img5.tianyancha.com/logo/lll/..., history_names: , match_field: 股东信息 } ] } }核心字段说明字段类型含义注意事项codeint业务状态码0为成功非0时须根据msg排查data.totalint该关键词的匹配总数最大为上游截断值仅作参考不代表实际企业数data.list[].namestring企业全称相对较权威但存在简称匹配情况data.list[].credit_codestring统一社会信用代码唯一标识可用于二次校验data.list[].legal_personstring法定代表人可能为空如分公司data.list[].reg_capitalstring准备资本含币种存在“万人民币”“万美元”等格式data.list[].reg_statusstring经营状态存续、注销、吊销等更新频率低以缓存时间为准data.list[].match_fieldstring匹配到的字段名帮助理解为何该记录出现在结果中常见错误与处理错误现象可能原因处理方法HTTP 400{code:101,msg:参数错误}name为空、超长或含非法字符校验参数长度在2~50URL编码中文HTTP 429{code:102,msg:请求过于频繁}超过QPS 5/s引入限流队列降低请求频率HTTP 403{code:103,msg:无效API Key}X-API-Key格式错误或已过期检查Key并参照文档重新生成返回code0但list为空关键词未匹配到数据尝试更短或更精确的名称或使用工商准备号查询返回字段缺失如phone为空上游数据未收录属于正常边界业务代码应容错工程化注意事项缓存策略由于API自身有6小时缓存业务端不宜再长时间缓存同一数据建议设置TTL为30分钟至1小时避免数据滞后。并发控制单机多线程/协程场景下使用带速率限制的HTTP客户端。例如Go中可用rate.LimiterPython可用requeststime.sleep(0.21)保证每秒5请求。降级设计当API出现429或5xx错误时应退化为本地缓存数据或异步重试队列避免主流程阻塞。数据校验返回的credit_code可使用国家标准校验位算法ISO 7064:1983, MOD 11-2进行初筛但最终真实性需通过官方渠道确认。字段使用基线reg_capital为字符串转金额时需去除“万人民币”等后缀并进行标准化转换。establish_time格式为YYYY-MM-DD可直接解析。兼容性history_names字段可能为空字符串返回的list长度为0~5业务代码应优雅处理空数组。参考文档企业工商信息查询 API 文档原始文档文中接口地址及参数以官方文档为准示例数据仅供演示。