白城市网站建设_网站建设公司_网站制作_seo优化

天眼查item_get接口（官方规范名称为企业基本信息接口 baseinfoV2）是通过企业名称、统一社会信用代码、注册号或企业 ID 获取企业工商基础信息、联系方式、经营状态、变更记录等结构化数据的核心接口，适配企业征信、供应商筛选、风控合规等场景天眼查开放平台。该接口采用HTTPS+Token 认证，数据源自工商登记、官方备案等权威渠道，具备字段完整、更新实时、权限分级严格的特点天眼查开放平台。本攻略从接口认知、权限获取、实操对接、调试排错到生产级优化，提供全链路结构化指导，兼顾入门易用性与企业级稳定性。

一、接口核心认知：功能与适配场景

1. 接口定位与核心价值

• 核心功能：输入企业名称、统一社会信用代码、注册号或企业 ID（keyword 参数），返回企业基础工商信息、联系方式、经营状态、变更记录、股权结构（需进阶权限）等核心数据；支持关联查询企业历史名称、分支机构等信息天眼查开放平台。
• 天眼查数据特性
  • 权威合规：数据来自工商登记、官方备案等权威渠道，符合《企业信息公示暂行条例》等法规要求天眼查开放平台；
  • 字段完整：覆盖企业基础工商、联系方式、经营状态、变更记录等多维度数据，字段与国家企业信用信息公示系统一致；
  • 更新实时：基础工商信息缓存 24 小时，经营状态、变更记录实时同步；
  • 权限分级：基础信息开放度高，敏感数据（如股权结构、财务数据）需企业授权或高级权限。
• 典型应用场景
  1. 供应商筛选系统：查询合作企业资质、经营状态，降低合作风险；
  2. 企业征信平台：聚合企业工商、资质、信用数据，生成征信报告；
  3. 风控系统：实时监控合作企业经营状态，预警异常变更（如法人变更、经营异常）。

2. 核心参数与返回字段

（1）请求参数（GET 方式提交，需携带 Token 请求头）天眼查开放平台

注意事项

1. keyword需 URL 编码，避免中文或特殊字符导致参数解析错误天眼查开放平台；
2. Token 有效期通常为 24 小时，需定期刷新；
3. 接口支持 GET 请求，参数需拼接在 URL 中，请求头携带 Authorization Token天眼查开放平台。

（2）返回核心字段（按业务场景分类）天眼查开放平台

提示：item_get接口不返回财务数据，需调用finance.get等扩展接口获取（需企业授权）。

3. 接口限制与注意事项

• 调用频率与配额限制| 权限类型 | 日调用上限 | 调用频率 | 适用场景 ||----------|------------|----------|----------|| 个人测试权限 | 100 次 / 天 | 2 次 / 秒 | 功能调试、个人研究 || 企业基础权限 | 1000 次 / 天 | 5 次 / 秒 | 中小型企业供应商筛选、市场调研 || 企业高级权限 | 10000 次 / 天 | 20 次 / 秒 | 大型征信平台、风控系统、行业数据统计 |
• 数据缓存规则：基础工商信息缓存 24 小时，变更记录、经营状态实时同步；
• 内容限制：未公示企业、注销企业、列入异常名录且未公示企业不返回敏感数据；
• 合规要求：数据仅用于合规企业征信、供应商筛选、市场调研等业务，遵守《企业信息公示暂行条例》《个人信息保护法》等法规，严禁用于非法用途。

二、对接前准备：权限与环境搭建

1. 获取接口权限（官方唯一合规路径）天眼查开放平台

天眼查item_get接口由天眼查开放平台提供，接入步骤如下：

1. 登录天眼查开放平台，注册企业账号；
2. 提交资质审核：企业营业执照、法人身份证、应用用途说明等材料；
3. 创建应用，填写应用名称、用途、服务器 IP 等信息，提交审核；
4. 审核通过后，获取access_token（接口调用核心凭证），配置 IP 白名单；
5. 申请baseinfoV2（item_get）接口权限，根据业务需求选择权限等级（基础 / 进阶 / 高级）。

风险提示：严禁使用非合规爬虫、第三方接口抓取企业数据，违反平台协议与法规，存在账号封禁、法律追责风险。

2. 技术环境准备

（1）支持语言与协议

• 协议：HTTPS（强制，HTTP 请求会被拦截）；
• 开发语言：Python、Java、PHP、Go 等主流语言，推荐 Python（适配 Token 管理与复杂数据解析）。

（2）必备工具与依赖

三、实操步骤：接口对接全流程（Python 示例）

步骤 1：理解 Token 认证规则（核心，必掌握）

天眼查接口采用Token 认证机制，流程如下：

1. 登录天眼查开放平台，创建应用并获取client_id和client_secret；
2. 调用token接口，获取access_token；
3. 每次调用item_get接口时，在请求头中携带Authorization: Bearer {access_token}；
4. access_token有效期 24 小时，需定期刷新。

步骤 2：完整代码实现（含 Token 获取 + 调用 + 数据标准化）

（1）依赖安装

bash

pip install requests pandas jsonpath-ng

（2）Python 代码实现

import requests import time import pandas as pd import logging from urllib.parse import quote from jsonpath_ng import parse # 封装好API供应商demo url=https://console.open.onebound.cn/console/?i=Lex # 日志配置 logging.basicConfig( level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s", handlers=[logging.FileHandler("tianyancha_item_get.log"), logging.StreamHandler()] ) # 配置信息（替换为你的天眼查开放平台信息） CONFIG = { "client_id": "你的client_id", "client_secret": "你的client_secret", "token_url": "https://open.api.tianyancha.com/services/open/token/2.0", "item_get_url": "https://open.api.tianyancha.com/services/open/ic/baseinfoV2/2.0", "token_expire_time": 0 # Token过期时间（秒） } def get_access_token() -> str: """获取天眼查access_token，处理过期自动刷新""" current_time = int(time.time()) if CONFIG["token_expire_time"] > current_time: return CONFIG.get("access_token", "") try: response = requests.post( url=CONFIG["token_url"], data={ "grant_type": "client_credentials", "client_id": CONFIG["client_id"], "client_secret": CONFIG["client_secret"] }, timeout=10, verify=True ) response.raise_for_status() result = response.json() if result.get("error"): error_msg = f"{result.get('error')}: {result.get('error_description')}" logging.error(f"Token获取失败：{error_msg}") return "" access_token = result.get("access_token", "") expires_in = result.get("expires_in", 86400) # 默认24小时 CONFIG["access_token"] = access_token CONFIG["token_expire_time"] = current_time + expires_in - 300 # 提前5分钟刷新 return access_token except requests.exceptions.RequestException as e: logging.error(f"Token请求异常：{str(e)}") return "" except Exception as e: logging.error(f"Token解析异常：{str(e)}") return "" def standardize_ent_data(raw_ent: dict) -> dict: """标准化天眼查企业详情数据，统一输出格式""" return { "企业名称": raw_ent.get("name", ""), "统一社会信用代码": raw_ent.get("creditCode", ""), "经营状态": raw_ent.get("regStatus", ""), "注册资本(万元)": raw_ent.get("regCapital", 0), "成立日期": raw_ent.get("establishTime", ""), "法定代表人": raw_ent.get("legalPerson", ""), "经营范围": raw_ent.get("businessScope", ""), "注册地址": raw_ent.get("regAddress", ""), "联系电话": raw_ent.get("contactPhone", ""), "联系邮箱": raw_ent.get("contactEmail", ""), "企业官网": raw_ent.get("website", ""), "历史名称": raw_ent.get("historyNames", ""), "是否有风险记录": raw_ent.get("riskFlag", 0), "是否黑名单": raw_ent.get("blacklistFlag", 0), "数据更新时间": raw_ent.get("updateTime", ""), "请求时间": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()) } def tianyancha_item_get( keyword: str, fields: str = None, need_change: int = 0 ) -> dict: """调用天眼查item_get接口获取企业详情""" access_token = get_access_token() if not access_token: return {"success": False, "error_msg": "Token获取失败", "data": {}} # 构建请求参数 params = {"keyword": quote(keyword, encoding="utf-8")} if fields: params["fields"] = fields if need_change: params["need_change"] = 1 headers = {"Authorization": f"Bearer {access_token}"} try: # 发送GET请求 response = requests.get( url=CONFIG["item_get_url"], params=params, headers=headers, timeout=10, verify=True ) response.raise_for_status() result = response.json() # 解析响应结果 if result.get("error"): error_msg = f"{result.get('error')}: {result.get('error_description')}" logging.error(f"接口调用失败（关键词：{keyword}）：{error_msg}") return {"success": False, "error_msg": error_msg, "data": {}} raw_ent = result.get("result", {}) if not raw_ent: logging.warning(f"无企业数据返回（关键词：{keyword}）") return {"success": False, "error_msg": "无企业数据", "data": {}} # 标准化数据 standard_data = standardize_ent_data(raw_ent) return { "success": True, "data": standard_data, "error_msg": "" } except requests.exceptions.RequestException as e: logging.error(f"网络请求异常（关键词：{keyword}）：{str(e)}") return {"success": False, "error_msg": f"网络异常：{str(e)}", "data": {}} except Exception as e: logging.error(f"数据解析异常（关键词：{keyword}）：{str(e)}") return {"success": False, "error_msg": f"解析异常：{str(e)}", "data": {}} # 封装好API供应商demo url=https://console.open.onebound.cn/console/?i=Lex # 调用示例 if __name__ == "__main__": keyword = "江西新余废旧物资回收有限公司" fields = "name,creditCode,regStatus,legalPerson,businessScope" need_change = 0 result = tianyancha_item_get(keyword=keyword, fields=fields, need_change=need_change) if result["success"]: print("天眼查企业详情：") for k, v in result["data"].items(): print(f"{k}: {v}") # 保存为Excel df = pd.DataFrame([result["data"]]) df.to_excel(f"tianyancha_ent_detail_{keyword}.xlsx", index=False) else: print(f"获取失败：{result['error_msg']}")

四、调试与问题排查：快速解决对接异常

1. 优先用官方工具调试（排除 Token 问题）

1. 登录天眼查开放平台调试工具，选择baseinfoV2（item_get）接口；
2. 输入关键词、fields 等参数，工具自动生成 Token；
3. 发送请求，查看响应结果。若官方工具调用成功，说明代码 Token 管理或参数解析逻辑有误；若失败，检查权限或参数。

2. 高频问题排查表

五、进阶优化：生产级稳定性提升

1. 性能与配额优化

• 批量调用优化：多企业查询时，采用异步并发请求（aiohttp），控制并发数≤权限允许的频率上限（如企业基础权限 5 次 / 秒）；
• 智能缓存策略：用 Redis 缓存企业详情，缓存 key 为tianyancha_ent_关键词，缓存有效期 24 小时，空结果 5 分钟；
• 字段按需获取：通过fields参数指定必要字段，不获取无关数据，减少响应体积与耗时。

2. 数据质量优化

• 数据一致性校验：对比企业名称与统一社会信用代码，校验数据准确性，过滤异常数据；
• 字段标准化：将非结构化字段（如经营范围）解析为行业标签，便于后续数据分析；
• 关联数据适配：建立企业 ID 与变更记录、分支机构的映射表，自动关联多维度数据。

3. 合规与安全

• 密钥管理：生产环境将client_id和client_secret存储在配置中心（如 Nacos、Apollo），禁止硬编码；定期轮换密钥（每 3 个月一次）；
• 重试机制：对 403（频率超限）、504（超时）等错误添加指数退避重试策略，首次重试间隔 1 秒，之后翻倍，最多重试 3 次；
• 日志审计：记录每次调用的关键词、参数、响应状态、数据更新时间，保留至少 30 天日志，满足合规审计要求。

六、扩展场景：接口联动与功能升级

1. 联动 item_search 接口：通过关键词（如 “江西新余 废旧物资回收”）搜索获取企业列表，再批量调用item_get获取详情，实现 “搜索 - 详情” 全链路数据采集；
2. 企业风控模型：结合企业工商、经营、变更记录数据，构建风控模型，预警经营异常、资质过期等风险；
3. 供应商管理系统：对接企业 ERP 系统，自动提取合作企业关键词，调用item_get获取最新资质与经营状态，实现供应商动态管理