通过名称获取公司数据的API

您需要通过公司名称提取可靠的商业基本信息，并在本周内交付。通过本指南的结束，您将调用Zyla API Hub上的单个LiveMint API端点，以按名称搜索公司并检索其档案、标识符、领导信息、交易代码和同行比较数据——准备好放入您的丰富作业、仪表板或内部工具中。

此API的功能及使用时机

LiveMint API提供了一个“通过名称获取公司数据”的端点，该端点使用名称或搜索词查找公司并返回结构化的商业和财务档案数据。典型的输出包括公司名称、行业、详细的档案/描述、标识符、官员名单、股票交易代码和具有可比指标的同行列表。开发人员使用它来丰富CRM记录、为内部研究工具提供支持、为分析填充数据，或让用户输入公司名称并立即获得结构化结果。

本文重点关注商业用例：通过名称获取公司信息，以推动入职、潜在客户开发、交易评估和投资组合审查工作流程。

在Zyla API Hub上开始

Zyla API Hub是一个API市场，拥有超过10,000个公共API，使用一个帐户、一个API密钥和订阅+配额模型（不是按调用付费）。LiveMint API提供了7天试用或50个请求的首次使用选项——请查看列表以了解当前可用内容。没有免费计划；请查看页面以获取当前访问选项和定价。

要开始：

打开Zyla API Hub上的LiveMint API页面，点击订阅或开始免费试用。
从仪表板复制您的API密钥。
在每个请求中使用Authorization: Bearer YOUR_API_KEY。

开始7天的LiveMint API试用

端点：通过名称获取公司数据

当您有一个公司名称（完整或部分）并需要结构化的公司详细信息时，请使用此端点。

方法：GET
URL：https://zylalabs.com/api/4204/livemint-api/5100/get-company-data-by-name
所需查询参数：
- name (string)：公司名称或搜索词。示例：TCS
身份验证：Authorization: Bearer YOUR_API_KEY

cURL示例

curl -s -X GET "https://zylalabs.com/api/4204/livemint-api/5100/get-company-data-by-name?name=TCS" \
-H "Authorization: Bearer YOUR_API_KEY"

Python示例（requests）

此示例调用相同的端点，检查响应，并提取用于商业工作流程（如丰富和档案）的常用字段。

import os
import requests

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/4204/livemint-api/5100/get-company-data-by-name"
params = {"name": "TCS"}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()

# 提取一些有用的字段（如果存在）
company_name = data.get("companyName")
industry = data.get("industry")
profile = (data.get("companyProfile") or {}).get("companyDescription")
isin = (data.get("companyProfile") or {}).get("isInId")
bse_code = data.get("exchangeCodeBse")
nse_code = data.get("exchangeCodeNse")

print("公司：", company_name)
print("行业：", industry)
print("ISIN：", isin)
print("BSE：", bse_code, "NSE：", nse_code)
print("档案：", (profile or "")[:240] + ("..." if profile and len(profile) > 240 else ""))

# 示例：如果可用，获取首位官员和首位同行
officers = ((data.get("companyProfile") or {}).get("officers") or {}).get("officer") or []
if officers:
o = officers[0]
print("首席官员：", o.get("firstName"), o.get("lastName"), "-", (o.get("title") or {}).get("Value"))

peers = data.get("peerCompanyList") or []
if peers:
p = peers[0]
print("首位同行：", p.get("companyName"), "| P/E：", p.get("priceToEarningsValueRatio"))

官方示例响应

以下是官方示例响应。您的输出将根据公司和搜索词而有所不同，但保持相同的结构。使用标准JSON解析访问字段。

{"companyName":"Zomato","industry":"计算机服务","companyProfile":{"companyDescription":"Zomato Limited作为一个互联网门户，帮助连接用户、餐厅合作伙伴/第三方商家和配送合作伙伴。该公司还为餐厅合作伙伴/品牌提供一个平台，以向印度和海外的目标受众进行广告，并向餐厅合作伙伴提供原材料。该公司的印度食品订购和配送部门由一个在线市场平台组成，通过该平台，公司促进食品项目的上市和在线订购，并通过连接最终用户、餐厅合作伙伴和独立配送合作伙伴来配送这些食品项目。其超纯供应（B2B业务）部门为印度的餐厅提供从农场到餐桌的供应。其快速商业部门由一个在线市场平台（市场）组成，使卖家能够在市场上列出销售的商品。该公司的外出部门是其外出就餐和娱乐票务业务的组合。","mgIndustry":"计算机服务","isInId":"INE758T01015","officers":{"officer":[{"rank":1,"since":"01/18/2010","firstName":"Deepinder","mI":null,"lastName":"Goyal","age":"41","title":{"startYear":"2021","startMonth":"3","startDay":"24","iD1":"CEO","abbr1":"CEO","iD2":"FDR","abbr2":"Fndr.","Value":"首席执行官、创始人、董事总经理、执行董事"}},{"rank":2,"since":"11/09/2020","firstName":"Akshant","mI":null,"lastName":"Goyal","age":null,"title":{"startYear":"2020","startMonth":"11","startDay":"9","iD1":"CFO","abbr1":"CFO","iD2":"","abbr2":"","Value":"首席财务官"}},{"rank":3,"since":"01/21/2019","firstName":"Sandhya","mI":null,"lastName":"Sethia","age":null,"title":{"startYear":"2022","startMonth":"3","startDay":"","iD1":"CCO","abbr1":"首席合规官","iD2":"SEC","abbr2":"秘书","Value":"公司秘书和合规官"}}]},"exchangeCodeBse":"543320","exchangeCodeNse":"ZOMATO","peerCompanyList":[{"tickerId":"S0003105","companyName":"Wipro","priceToBookValueRatio":3.87,"priceToEarningsValueRatio":24.88,"marketCap":276762.16,"price":264.3,"percentChange":-1.53,"netChange":-4.1,"returnOnAverageEquity5YearAverage":17.18,"returnOnAverageEquityTrailing12Month":15.66,"ltDebtPerEquityMostRecentFiscalYear":10.17,"netProfitMargin5YearAverage":14.48,"netProfitMarginPercentTrailing12Month":14.06,"dividendYieldIndicatedAnnualDividend":2.16,"totalSharesO…

您通常会使用哪些字段

companyName，industry：用于UI和报告的显示名称和行业分类。
companyProfile.companyDescription：在研究视图和CRM丰富中有用的叙述性档案。
companyProfile.isInId：您可以存储以便在系统间对账的标识符。
companyProfile.officers.officer[]：可以丰富尽职调查和治理检查的领导名单。
exchangeCodeBse，exchangeCodeNse：用于链接到市场数据小部件或特定于交易所的工作流程。
peerCompanyList[]：具有共同估值和盈利能力指标的快速可比集。

实际实施注意事项

搜索行为：名称参数接受完整名称、缩写名称或LiveMint风格搜索支持的搜索词，从而实现灵活的用户输入。
去重和选择：流行名称可能解析为多个实体；呈现最佳匹配，或通过调用此端点并让用户确认公司来显示选择列表。
缓存：缓存流行名称的成功查找以减少延迟并节省配额。当您预期档案或官员更改时，定期使其失效。
错误处理：检查HTTP状态并防御性地处理空或部分对象（如Python示例所示）。
本地化：响应是结构化的JSON。如果您需要一致地显示数字指标，请在客户端格式化它们；除非您的UI指定单位或货币，否则不要假设它们。
审计：存储原始JSON有效负载及时间戳，以便您可以重现用户在特定时间看到的内容。

您本周可以交付的商业用例

潜在客户丰富：当潜在客户输入公司名称时，调用端点并将companyProfile、industry、exchange codes和领导数据添加到您的CRM记录中。
研究仪表板：构建一个单字段搜索，返回档案和同行列表，以便分析师可以扫描竞争对手和估值比率。
入职检查：在审核步骤中显示公司描述和官员头衔，以帮助运营团队验证选择了正确的实体。
投资组合工具包：允许PM按名称查找持股，并快速跳转到交易代码以进行下游市场数据查找。

通过MCP从AI代理调用API

您还可以通过与MCP兼容的AI编码工具和代理调用Zyla API。配置您的客户端以使用MCP端点，然后让代理使用您的承载令牌调用相同的LiveMint API URL。这使得AI助手在任务中获取公司数据（例如“丰富这份企业列表”）成为可能。

端点：https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
使用您现有的Zyla API密钥；您的订阅和配额照常适用。
在代理的工具中，向LiveMint API URL发出GET请求，并带上Authorization头。

有关MCP兼容性的详细信息，请参见： MCP

端到端检查清单

从Zyla API Hub上的LiveMint API页面获取API密钥。
使用名称参数和Authorization: Bearer头实现GET调用。
解析companyName、industry、companyProfile、identifiers、exchange codes和peers。
为模糊名称添加缓存和用户确认。
监控使用情况与您的订阅配额；根据需要扩展您的计划。

常见问题解答

LiveMint API需要什么身份验证？
在每个请求中使用HTTP头：Authorization: Bearer YOUR_API_KEY。

“通过名称获取公司数据”需要哪些参数？
传递名称查询参数（字符串）。示例：name=TCS。

响应包括什么？
一个结构化的JSON，包含字段如companyName、industry、companyProfile（包括描述、标识符和官员）、交易代码和包含可比公司和指标的peerCompanyList。

定价是按调用付费吗？
不。Zyla使用订阅+配额，而不是按调用付费。LiveMint API提供了7天试用或50个请求的首次使用选项——请查看列表以获取当前详细信息。

我可以从AI代理调用此API吗？
可以。使用Zyla MCP端点和您的API密钥。您的代理可以向LiveMint API URL发出相同的GET请求，同时重用您的订阅和配额。

准备好实施公司名称搜索和丰富吗？在这里开始您的试用并获取API密钥：开始7天的LiveMint API试用

官方API响应

{"companyName":"Zomato","industry":"计算机服务","companyProfile":{"companyDescription":"Zomato Limited作为一个互联网门户，帮助连接用户、餐厅合作伙伴/第三方商家和配送合作伙伴。该公司还为餐厅合作伙伴/品牌提供一个平台，以向印度和海外的目标受众进行广告，并向餐厅合作伙伴提供原材料。该公司的印度食品订购和配送部门由一个在线市场平台组成，通过该平台，公司促进食品项目的上市和在线订购，并通过连接最终用户、餐厅合作伙伴和独立配送合作伙伴来配送这些食品项目。其超纯供应（B2B业务）部门为印度的餐厅提供从农场到餐桌的供应。其快速商业部门由一个在线市场平台（市场）组成，使卖家能够在市场上列出销售的商品。该公司的外出部门是其外出就餐和娱乐票务业务的组合。","mgIndustry":"计算机服务","isInId":"INE758T01015","officers":{"officer":[{"rank":1,"since":"01/18/2010","firstName":"Deepinder","mI":null,"lastName":"Goyal","age":"41","title":{"startYear":"2021","startMonth":"3","startDay":"24","iD1":"CEO","abbr1":"CEO","iD2":"FDR","abbr2":"Fndr.","Value":"首席执行官、创始人、董事总经理、执行董事"}},{"rank":2,"since":"11/09/2020","firstName":"Akshant","mI":null,"lastName":"Goyal","age":null,"title":{"startYear":"2020","startMonth":"11","startDay":"9","iD1":"CFO","abbr1":"CFO","iD2":"","abbr2":"","Value":"首席财务官"}},{"rank":3,"since":"01/21/2019","firstName":"Sandhya","mI":null,"lastName":"Sethia","age":null,"title":{"startYear":"2022","startMonth":"3","startDay":"","iD1":"CCO","abbr1":"首席合规官","iD2":"SEC","abbr2":"秘书","Value":"公司秘书和合规官"}}]},"exchangeCodeBse":"543320","exchangeCodeNse":"ZOMATO","peerCompanyList":[{"tickerId":"S0003105","companyName":"Wipro","priceToBookValueRatio":3.87,"priceToEarningsValueRatio":24.88,"marketCap":276762.16,"price":264.3,"percentChange":-1.53,"netChange":-4.1,"returnOnAverageEquity5YearAverage":17.18,"returnOnAverageEquityTrailing12Month":15.66,"ltDebtPerEquityMostRecentFiscalYear":10.17,"netProfitMargin5YearAverage":14.48,"netProfitMarginPercentTrailing12Month":14.06,"dividendYieldIndicatedAnnualDividend":2.16,"totalSharesO…

官方API响应

{"companyName":"Zomato","industry":"计算机服务","companyProfile":{"companyDescription":"Zomato Limited作为一个互联网门户，帮助连接用户、餐厅合作伙伴/第三方商家和配送合作伙伴。该公司还为餐厅合作伙伴/品牌提供一个平台，以向印度和海外的目标受众进行广告，并向餐厅合作伙伴提供原材料。该公司的印度食品订购和配送部门由一个在线市场平台组成，通过该平台，公司促进食品项目的上市和在线订购，并通过连接最终用户、餐厅合作伙伴和独立配送合作伙伴来配送这些食品项目。其超纯供应（B2B业务）部门为印度的餐厅提供从农场到餐桌的供应。其快速商业部门由一个在线市场平台（市场）组成，使卖家能够在市场上列出销售的商品。该公司的外出部门是其外出就餐和娱乐票务业务的组合。","mgIndustry":"计算机服务","isInId":"INE758T01015","officers":{"officer":[{"rank":1,"since":"01/18/2010","firstName":"Deepinder","mI":null,"lastName":"Goyal","age":"41","title":{"startYear":"2021","startMonth":"3","startDay":"24","iD1":"CEO","abbr1":"CEO","iD2":"FDR","abbr2":"Fndr.","Value":"首席执行官、创始人、董事总经理、执行董事"}},{"rank":2,"since":"11/09/2020","firstName":"Akshant","mI":null,"lastName":"Goyal","age":null,"title":{"startYear":"2020","startMonth":"11","startDay":"9","iD1":"CFO","abbr1":"CFO","iD2":"","abbr2":"","Value":"首席财务官"}},{"rank":3,"since":"01/21/2019","firstName":"Sandhya","mI":null,"lastName":"Sethia","age":null,"title":{"startYear":"2022","startMonth":"3","startDay":"","iD1":"CCO","abbr1":"首席合规官","iD2":"SEC","abbr2":"秘书","Value":"公司秘书和合规官"}}]},"exchangeCodeBse":"543320","exchangeCodeNse":"ZOMATO","peerCompanyList":[{"tickerId":"S0003105","companyName":"Wipro","priceToBookValueRatio":3.87,"priceToEarningsValueRatio":24.88,"marketCap":276762.16,"price":264.3,"percentChange":-1.53,"netChange":-4.1,"returnOnAverageEquity5YearAverage":17.18,"returnOnAverageEquityTrailing12Month":15.66,"ltDebtPerEquityMostRecentFiscalYear":10.17,"netProfitMargin5YearAverage":14.48,"netProfitMarginPercentTrailing12Month":14.06,"dividendYieldIndicatedAnnualDividend":2.16,"totalSharesO…