企业工商信息查询接口

什么是企业工商信息查询接口？

企业工商信息查询接口是一种应用程序编程接口,允许开发者在自己的系统或应用中，通过调用API来自动获取企业工商注册信息，这些信息通常由国家企业信用信息公示系统等官方渠道提供，但官方系统本身不提供直接、方便的API，因此第三方服务商通过抓取、整合官方数据，并将其封装成标准化的API接口，供开发者使用。

查询的信息通常包括：

• 基本信息：公司名称、统一社会信用代码、法定代表人、注册地址、注册资本、成立日期、经营状态、经营范围等。
• 股东及出资信息：股东姓名、持股比例、认缴出资额、实缴出资额等。
• 主要人员信息：法定代表人、董事、监事、经理等。
• 分支机构信息。
• 变更记录。
• 行政处罚、经营异常名录、严重违法失信名单等风险信息。

主流服务商

目前市场上有许多提供此类服务的公司,它们各有优劣，选择服务商时，主要考虑数据准确性、接口稳定性、价格、文档清晰度和客户支持。

以下是一些国内知名的服务商（排名不分先后）：

1. 天眼查

   • 特点：数据覆盖广，更新及时，尤其在风险信息方面做得很好，提供多种API产品，如企业信息查询、股东穿透查询、风险监控等。
   • 优势：品牌知名度高，数据质量有保障，适合对数据准确性要求高的场景。
   • 劣势：价格相对较高，部分高级功能需要较高的订阅费用。

2. 企查查

   • 特点：与天眼查类似，是市场上的主要竞争对手，数据全面，API接口丰富，支持多种查询维度。
   • 优势：同样拥有庞大的数据库和良好的市场口碑，API稳定可靠。
   • 劣势：价格不菲，且两家公司的数据源和侧重点略有不同，有时需要交叉验证。

3. 启信宝

   • 特点：数据维度多，除了工商信息，还提供产业链、招投标、知识产权等关联信息，API接口设计灵活。
   • 优势：数据维度丰富，适合需要进行深度关联分析的场景。
   • 劣势：在某些基础信息的实时性上，可能略逊于前两者。

4. 爱企查

   • 特点：由百度旗下公司运营，背靠百度搜索生态，数据来源权威，价格相对亲民，有免费额度。
   • 优势：百度生态支持，性价比高，适合初创企业或个人开发者。
   • 劣势：品牌影响力相对前两者较弱，部分高级数据可能不如天眼查/企查查深入。

5. APIPO (聚合数据)

   • 特点：这是一个API聚合平台，它整合了多家数据服务商的接口，并提供统一的调用方式，开发者可以在一个平台上接入多种API。
   • 优势：一站式服务，接入方便，可以对比不同服务商的数据和价格。
   • 劣势：数据质量取决于其上游的合作伙伴，可能存在不一致的情况。

接口类型与调用方式

服务商提供的接口通常分为两种主要模式：

按次付费模式

• 原理：每次调用接口查询一个企业信息，就会扣除一次费用或账户中的次数。
• 计费单位：通常是“次”或“条”。
• 适用场景：查询量不大的应用，如个人项目、小型网站、偶尔的背景调查等。
• 优点：用多少付多少，成本可控，适合低频使用。
• 缺点：高频查询成本会迅速上升。

包月/包年订阅模式

• 原理：支付固定的月费或年费，即可在套餐额度内无限次或有限次调用接口。
• 计费单位：通常是“元/月”，并附带一定的调用次数或更高的查询权限。
• 适用场景：查询量大的应用，如SaaS软件、金融风控系统、批量数据分析等。
• 优点：平均单次成本低，适合高频、大规模调用。
• 缺点：有固定的成本开销，即使当月查询量很少也需要付费。

如何接入（通用流程）

以任何一家服务商为例,接入流程基本如下：

第1步：注册与认证

• 访问服务商官网（如天眼查开放平台）。
• 注册成为开发者账号。
• 完成企业或个人实名认证,这是开通API权限的必要步骤。

第2步：获取API Key

• 在开发者后台创建应用,系统会为你生成一对密钥：
  • API Key / AppKey：用于标识你的应用。
  • Secret Key / AppSecret：用于生成签名，验证请求的合法性。
• 请务必妥善保管 Secret Key，不要泄露！

第3步：阅读API文档

• 仔细阅读官方提供的API文档,这是最重要的环节。
• 关键信息包括：
  • 请求URL：接口的地址。
  • 请求方法：通常是 GET 或 POST。
  • 请求参数：必须传递的参数，如 keyword（企业名称或统一社会信用代码）。
  • 认证方式：如何将你的API Key附加到请求中（通常在Header中）。
  • 签名算法：如何用API Key和Secret Key生成一个签名，防止请求被篡改。
  • 响应格式：返回的数据通常是 JSON 格式。
  • 错误码：请求失败时，服务器会返回错误码，文档中会解释其含义。

第4步：调用接口与测试

• 使用代码（如 Python, Java, PHP 等）或 Postman 等工具，按照文档构造请求。
• 发送请求并接收响应,解析返回的 JSON 数据。
• 在开发者后台通常会有一个“测试”或“沙箱”环境，可以先在这里进行调试，不会消耗你的正式额度。

第5步：集成到你的应用

• 测试通过后,将API调用代码集成到你的应用程序中，实现自动化查询功能。

代码示例（Python）

以下是一个使用 Python 的 requests 库调用企业查询接口的通用示例。你需要将其中的 YOUR_API_KEY 和 YOUR_SECRET_KEY 替换为你在服务商后台获取的真实密钥。

import requests
import hashlib
import time
import json
# --- 1. 配置信息 ---
# 替换为你在服务商后台获取的密钥
API_KEY = "YOUR_API_KEY"
SECRET_KEY = "YOUR_SECRET_KEY"
# 服务商提供的API请求地址（示例，请以实际文档为准）
API_URL = "https://api.example.com/v1/enterprise/search"
# 要查询的企业名称或统一社会信用代码
search_keyword = "腾讯科技有限公司"
# --- 2. 生成签名 (签名算法因服务商而异，以下为一种常见示例) ---
# 通常需要将参数、API_KEY、时间戳等按照特定规则拼接，然后用MD5或HMAC-SHA1加密
timestamp = str(int(time.time()))
params = {
    "keyword": search_keyword,
    "key": API_KEY,
    "timestamp": timestamp
    # ... 其他可能需要的参数
}
# 对参数进行排序并拼接成字符串
sorted_params = sorted(params.items(), key=lambda x: x[0])
param_str = "&".join([f"{k}={v}" for k, v in sorted_params])
# 添加 Secret Key 并进行 MD5 加密
sign_str = param_str + "&secret=" + SECRET_KEY
signature = hashlib.md5(sign_str.encode('utf-8')).hexdigest()
# 将签名添加到请求参数中
params["sign"] = signature
# --- 3. 发送请求 ---
try:
    # 通常使用 POST 方法，将参数放在请求体中
    response = requests.post(API_URL, data=params)
    # 检查HTTP请求是否成功
    response.raise_for_status() 
    # 解析JSON响应
    result = response.json()
    # --- 4. 处理响应 ---
    print("API 响应结果:")
    print(json.dumps(result, indent=2, ensure_ascii=False))
    # 根据返回结果进行业务逻辑处理
    if result.get("code") == 200: # 假设 200 表示成功
        data = result.get("data", {})
        if data:
            company_name = data.get("name")
            credit_code = data.get("credit_code")
            legal_representative = data.get("legal_person")
            print(f"\n查询成功！\n公司名称: {company_name}\n统一社会信用代码: {credit_code}\n法定代表人: {legal_representative}")
        else:
            print("未找到相关企业信息。")
    else:
        error_msg = result.get("message", "未知错误")
        print(f"查询失败，错误码: {result.get('code')}, 错误信息: {error_msg}")
except requests.exceptions.RequestException as e:
    print(f"请求发生错误: {e}")
except json.JSONDecodeError as e:
    print(f"解析JSON响应失败: {e}")

重要注意事项

1. 数据准确性：第三方服务商的数据均来源于官方系统，可能存在延迟或遗漏，对于涉及重大决策（如金融、法律）的场景，务必以国家企业信用信息公示系统官方查询结果为准。
2. 合法合规使用：
   • 严禁将获取到的数据用于非法目的,如倒卖数据、骚扰营销、诈骗等。
   • 遵守服务商的《用户协议》和《隐私政策》，明确数据的使用范围和限制。
   • 查询个人信息（如股东、法定代表人）时，需注意《个人信息保护法》的相关规定，确保有合法的查询事由。
3. 成本控制：在高频调用场景下，务必做好接口调用频率的控制和异常处理，避免因程序 bug 导致大量无效调用，产生不必要的费用。
4. 接口稳定性：没有100%稳定的API，建议在应用中做好重试机制和降级处理，当接口不可用时，能给用户友好的提示，而不是直接崩溃。

希望这份详细的指南能帮助您顺利接入企业工商信息查询接口！