公司信息查询API怎么用？

查询公司信息最权威、最核心的数据源是国家企业信用信息公示系统，市面上绝大多数的商业公司信息查询API，其底层数据都直接或间接来源于此系统。

下面我将从以下几个方面为您详细解读：

1. 核心数据来源：国家企业信用信息公示系统
2. API服务商与类型
3. API能查询哪些信息？
4. 如何选择和使用API？
5. 重要注意事项

核心数据来源：国家企业信用信息公示系统

这是由国家市场监督管理总局设立的官方平台，所有在中国注册的公司都必须向其报送年度报告、行政处罚、股权变更等关键信息。

• 网址：http://www.gsxt.gov.cn/
• 特点：
  • 权威性：官方数据，最可靠。
  • 免费：任何人都可以通过网站免费查询。
  • 查询限制：有IP访问频率限制，不适合进行大批量、自动化的数据抓取。

由于官方系统不适合高频、批量的调用，所以催生了商业API服务。

API服务商与类型

市场上有许多第三方服务商,他们通过官方授权或技术手段，将数据封装成易于调用的API接口，供开发者使用。

主要服务商类型：

1. 大型综合数据服务商：

   
   （图片来源网络，侵删）
   • 特点：数据维度广，除了工商信息，还可能整合司法、知识产权、招投标、经营风险等信息，服务稳定，技术支持完善。
   • 代表厂商：
     • 天眼查：以其强大的风险信息整合能力著称。
     • 企查查：与天眼查类似，是市场上的主要竞争者。
     • 启信宝：数据更新及时，信息维度丰富。
   • 适用场景：对数据深度和广度要求高的企业级应用，如金融风控、尽职调查、商业分析等。

2. API技术/云服务提供商：

   • 特点：本身不生产数据，而是整合了多家数据源（包括上述天眼查、企查查等），提供统一的API调用平台，通常按调用量收费，价格灵活。
   • 代表厂商：
     • 聚合数据：国内较早的API服务商，提供多种数据接口。
     • 数据宝：强调“国有数据资产”，数据来源可靠。
     • APISpace：一个新兴的API聚合市场，提供多种接口，包括公司信息查询。
   • 适用场景：中小型开发者、初创公司，需要快速集成多种API，且用量不大的场景。

3. 官方或准官方渠道：

   • 特点：直接或间接对接官方数据，权威性最高。
   • 代表：
     • 国家公共信用信息中心：提供部分企业信用信息的查询接口。
     • 部分地方市场监管局：有时会提供开放的API接口。
   • 适用场景：对数据来源有极高合规性要求的政府项目或大型国企。

API能查询哪些信息？

API通常提供多种查询模式,返回结构化的JSON或XML数据。

核心查询字段（以“查公司”为例）：

常见API接口类型：

• 公司信息查询（单条）：通过公司全称、统一社会信用代码等唯一标识查询，返回该公司的详细信息。
• 公司列表查询（模糊/多条件）：通过公司名称关键词、法定代表人、注册地等条件进行模糊搜索，返回符合条件的公司列表。
• 股东/投资关系查询：查询指定公司的所有股东，或查询指定公司的所有对外投资。
• 风险信息监控（订阅）：订阅某家公司的动态，一旦该公司发生工商变更、司法诉讼、行政处罚等风险事件，API会主动推送通知。

如何选择和使用API？

选择标准：

1. 数据准确性与权威性：这是最重要的标准，了解其数据源是否可靠，更新频率如何。
2. 接口稳定性与响应速度：API是否稳定，调用延迟是否在可接受范围内（通常要求几百毫秒）。
3. 数据覆盖广度：是否满足你的业务需求，例如是否包含司法、知识产权等关联信息。
4. 价格与成本：了解计费模式（按次、按包月、按调用量），评估你的业务量，选择性价比最高的方案。
5. 技术支持与文档：API文档是否清晰易懂，是否有技术支持人员可以解答问题。
6. 合规性：服务商是否具备相应的数据服务资质，确保你的使用不涉及隐私泄露和数据安全问题。

使用流程（以天眼查API为例）：

1. 注册与认证：在服务商官网（如天眼查开放平台）注册账号，并进行企业认证（通常需要营业执照）。
2. 创建应用：在开发者后台创建一个“应用”，获取API Key和Secret Key，这是调用API的身份凭证。
3. 阅读文档：仔细阅读API文档，了解接口地址、请求方法、请求参数（如公司名称）、返回数据格式（JSON）和字段说明。
4. 调用测试：使用API Key和Secret Key，通过代码（如Python的requests库）或API测试工具（如Postman）向接口发送请求，测试是否能正常返回数据。
5. 集成到项目：将测试通过的API调用代码集成到你的应用程序中。
6. 监控用量：在后台监控API调用量和费用，避免超额。

Python调用示例 (使用requests库):

import requests
import hashlib
import time
import json
# 1. 从服务商后台获取
API_KEY = "YOUR_API_KEY"
SECRET_KEY = "YOUR_SECRET_KEY"
# 2. 准备请求参数
params = {
    "keyword": "阿里巴巴（中国）网络技术有限公司", # 要查询的公司名
    "page_size": 10,
    "page": 1,
    "api_key": API_KEY
}
# 3. 生成签名 (具体签名算法请参考服务商文档)
# 这里只是一个示例，实际算法可能更复杂
timestamp = str(int(time.time()))
sign_str = SECRET_KEY + timestamp + API_KEY
sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest()
params["timestamp"] = timestamp
params["sign"] = sign
# 4. 设置请求头
headers = {
    "Content-Type": "application/x-www-form-urlencoded"
}
# 5. 发送POST请求
# 注意：这里的URL是示例，请替换为实际的API地址
url = "https://api.tianyancha.com/v4/search/company"
try:
    response = requests.post(url, headers=headers, params=params)
    response.raise_for_status()  # 如果请求失败则抛出异常
    # 6. 解析返回的JSON数据
    result = response.json()
    print(json.dumps(result, indent=4, ensure_ascii=False))
    # 提取关键信息
    if result.get("result") and len(result["result"]) > 0:
        company_info = result["result"][0]
        print(f"\n公司名称: {company_info.get('name')}")
        print(f"统一社会信用代码: {company_info.get('creditCode')}")
        print(f"法定代表人: {company_info.get('personName')}")
        print(f"成立日期: {company_info.get('estiblishDate')}")
        print(f"经营状态: {company_info.get('status')}")
except requests.exceptions.RequestException as e:
    print(f"API请求失败: {e}")

重要注意事项

1. 数据合规性：

   • 个人信息保护：API返回的数据中可能包含法定代表人、股东、高管等自然人的姓名、身份证号（脱敏后）、电话等信息，在使用这些数据时，必须严格遵守《中华人民共和国个人信息保护法》，不得用于非法目的，如骚扰、诈骗等。
   • 授权与同意：在将查询结果用于特定场景（如信贷审批、背景调查）时，通常需要获得信息主体的授权。

2. 使用频率限制：

   所有API都有调用频率限制（QPS，每秒查询数）和总调用量限制，超出限制可能会导致服务被暂停或产生额外费用，在代码中应做好异常处理和重试机制。

3. 数据延迟：

   商业数据从工商部门登记到API服务商更新,通常会有几小时到几天不等的延迟，对于需要实时性的场景，需要注意这一点。

4. 成本控制：

   对于高频调用场景,务必做好成本预算，可以采用缓存机制，对不常变动的公司信息进行本地缓存，以减少API调用次数，降低成本。

希望这份详细的指南能帮助您更好地了解和使用公司信息查询API！