企业工商信息查询API接口开发指南 - 基于模糊检索的工商数据补全方案
企业工商信息查询API接口开发指南 - 基于模糊检索的工商数据补全方案
一、接口功能概述
本接口通过HTTP协议提供企业工商数据查询服务,支持以下核心功能:
- 模糊检索:基于企业名称/注册号/统一社会信用代码的智能匹配
- 关键字段返回:法定代表人、成立日期、企业类型等字段
- 多场景适配:支持数据清洗、资质审核、系统对接等企业级应用
二、接口调用规范
2.1 请求方式
GET https://www.xujian.tech/atlapi/data/c/query/like
2.2 请求参数
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
code | string | 是 | 访问凭证(从管理后台获取) |
keyword | string | 是 | 查询关键词(长度≥4个字符) |
2.3 认证机制
curl -G "https://www.xujian.tech/atlapi/data/c/query/like" \-d "code=YOUR_ACCESS_CODE" \-d "keyword=重庆科技"
三、响应数据结构
3.1 成功响应示例
{"code": 200,"msg": "succeed.","data": [{"id": "1105","createdAt": 1695260987000,"matchType": "企业名称","regNo": "500113014353471","startDate": "2021-06-02","name": "重庆可乐家装饰工程有限公司","operName": "李伦智","creditNo": "91500113MAABRA7D0H","qxbId": "58e62a6d-a6fa-482a-972d-84131629b2e4","matchItems": "重庆可乐家装饰工程有限公司","type": "0"}// 其他记录...]
}
3.2 字段说明
字段名称 | 类型 | 说明 |
---|---|---|
id | int | 系统自增 ID |
createdAt | long | 记录生成时间(时间戳) |
matchType | String | 匹配类型(主要反映企业名称匹配情况) |
regNo | String | 企业注册号 |
startDate | String | 企业成立日期 |
name | String | 企业名称 |
operName | String | 法定代表人名称 |
creditNo | String | 统一社会信用代码 |
qxbId | String | 数据标识字段(备用) |
type | String | 企业类型,枚举值:0 表示企业,其它值代表不同分类 |
matchItems | String | 查询匹配依据,未来可能扩展 |
四、服务计费规则
- 免费额度:新注册用户每日20次成功查询。
目前试用已停用,但可联系微信xujian_cq申请。
- 标准计费:成功查询0.01元/次
五、典型应用场景
- CRM系统数据补全:自动填充企业工商信息
- 招投标审核:验证企业存续状态
- 供应链管理:核验供应商资质
- 财务系统对接:快速获取开票所需信用代码
六、调用示例
6.1 Python调用示例
import requestsdef query_enterprise(keyword):url = "https://www.xujian.tech/atlapi/data/c/query/like"params = {"code": "YOUR_ACCESS_CODE","keyword": keyword}response = requests.get(url, params=params)return response.json()
6.2 Java调用示例
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder().uri(URI.create("https://www.xujian.tech/atlapi/data/c/query/like?code=YOUR_CODE&keyword=重庆科技")).build();
HttpResponse<String> response = client.send(request, BodyHandlers.ofString());
七、注意事项
- 数据安全:code参数需加密存储,禁止明文传输
- 查询建议:推荐使用企业全称/完整信用代码获取精确结果
- 数据时效:当日数据就能查询到
本接口数据来源合法,仅返回企业公开的工商注册信息
接口长期稳定,当天通过的企业信息就能查到