API para obter dados da empresa pelo nome

Você precisa obter fundamentos empresariais confiáveis pelo nome da empresa e enviá-los esta semana. Ao final deste guia, você chamará um único endpoint da API LiveMint no Zyla API Hub para pesquisar uma empresa pelo nome e recuperar seu perfil, identificadores, detalhes de liderança, códigos de troca e dados de comparação com pares—pronto para ser inserido em seus trabalhos de enriquecimento, painéis ou ferramentas internas.

O que esta API faz e quando usá-la

A API LiveMint fornece um endpoint "Obter Dados da Empresa pelo Nome" que procura uma empresa usando um nome ou termo de pesquisa e retorna dados estruturados de perfil empresarial e financeiro. As saídas típicas incluem nome da empresa, setor, um perfil/descritivo detalhado, identificadores, listagens de diretores, códigos de bolsa e uma lista de pares com métricas comparáveis. Os desenvolvedores a utilizam para enriquecer registros de CRM, alimentar ferramentas de pesquisa internas, preencher dados para análises ou permitir que os usuários digitem um nome de empresa e obtenham resultados estruturados imediatos.

Este artigo foca no caso de uso empresarial: buscar informações da empresa pelo nome para impulsionar fluxos de trabalho de integração, prospecção, avaliação de negócios e revisão de portfólio.

Começando no Zyla API Hub

O Zyla API Hub é um mercado de APIs com mais de 10.000 APIs públicas sob uma conta, uma chave de API e um modelo de assinatura + cota (não pago por chamada). A API LiveMint oferece uma opção de primeiro uso de um teste de 7 dias ou 50 solicitações—verifique a listagem para o que está atualmente disponível. Não há Plano Gratuito; revise a página para opções de acesso e preços atuais.

Para começar:

• Abra a página da API LiveMint no Zyla API Hub e clique em Assinar ou Começar Teste Gratuito.
• Copie sua chave de API do seu painel.
• Use Authorization: Bearer YOUR_API_KEY em cada solicitação.

Comece o teste de 7 dias na API LiveMint

Endpoint: Obter Dados da Empresa pelo Nome

Use este endpoint quando você tiver um nome de empresa (completo ou parcial) e precisar de detalhes estruturados da empresa.

• Método: GET
• URL: https://zylalabs.com/api/4204/livemint-api/5100/get-company-data-by-name
• Parâmetro de consulta obrigatório:
  • name (string): O nome da empresa ou termo de pesquisa. Exemplo: TCS
• Autenticação: Authorization: Bearer YOUR_API_KEY

exemplo de 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"

exemplo em Python (requests)

Este exemplo chama o mesmo endpoint, verifica a resposta e extrai campos comumente usados para fluxos de trabalho empresariais, como enriquecimento e perfilamento.

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()

# Puxe alguns campos úteis, se presentes
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("Empresa:", company_name)
print("Setor:", industry)
print("ISIN:", isin)
print("BSE:", bse_code, "NSE:", nse_code)
print("Perfil:", (profile or "")[:240] + ("..." if profile and len(profile) > 240 else ""))

# Exemplo: primeiro diretor e primeiro par, se disponíveis
officers = ((data.get("companyProfile") or {}).get("officers") or {}).get("officer") or []
if officers:
o = officers[0]
print("Principal Diretor:", o.get("firstName"), o.get("lastName"), "-", (o.get("title") or {}).get("Value"))

peers = data.get("peerCompanyList") or []
if peers:
p = peers[0]
print("Primeiro Par:", p.get("companyName"), "| P/E:", p.get("priceToEarningsValueRatio"))

Resposta de exemplo oficial

Abaixo está a resposta de exemplo oficial. Sua saída variará de acordo com a empresa e o termo de pesquisa, mas mantenha a mesma estrutura. Use a análise JSON padrão para acessar os campos.

{"companyName":"Zomato","industry":"Computer Services","companyProfile":{"companyDescription":"Zomato Limited operates as an Internet portal, which helps in connecting the users, restaurant partners/ third-party merchants and the delivery partners. The Company also provides a platform to restaurant partners/brands to advertise themselves to the target audience in India and abroad and supplies ingredients to restaurant partners. The Company’s India food ordering and delivery segment consists of an online marketplace platform through which the Company facilitates the listing and online ordering of food items and the delivery of these food items by connecting end users, restaurant partners and independent delivery partners. Its hyperpure supplies (B2B business) segment offers farm-to-fork supplies for restaurants in India. Its quick commerce segment consists of an online marketplace platform (Marketplace), which enables listing of items sold on the Marketplace by the sellers. The Company’s going-out segment is a combination of its dining-out and entertainment ticketing business.","mgIndustry":"Computer Services","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":"Chief Executive Officer, Founder, Managing Director, Executive Director"}},{"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":"Chief Financial Officer"}},{"rank":3,"since":"01/21/2019","firstName":"Sandhya","mI":null,"lastName":"Sethia","age":null,"title":{"startYear":"2022","startMonth":"3","startDay":"","iD1":"CCO","abbr1":"Chief Comp.","iD2":"SEC","abbr2":"Secy.","Value":"Company Secretary and Compliance Officer"}}]},"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…

Quais campos você usará tipicamente

• companyName, industry: Exibir nomes e classificação do setor para UIs e relatórios.
• companyProfile.companyDescription: Um perfil narrativo útil em visualizações de pesquisa e enriquecimento de CRM.
• companyProfile.isInId: Identificador que você pode armazenar para reconciliação entre sistemas.
• companyProfile.officers.officer[]: Lista de liderança que pode enriquecer a devida diligência e verificações de governança.
• exchangeCodeBse, exchangeCodeNse: Útil para vincular a widgets de dados de mercado ou fluxos de trabalho específicos de bolsa.
• peerCompanyList[]: Um conjunto comparável rápido com métricas comuns de avaliação e rentabilidade.

Notas práticas de implementação

• Comportamento de pesquisa: O parâmetro de nome aceita nomes completos, nomes abreviados ou termos de pesquisa suportados pela pesquisa estilo LiveMint, permitindo entrada flexível do usuário.
• Deduplicação e seleção: Nomes populares podem resolver em múltiplas entidades; apresente a melhor correspondência ou mostre uma lista selecionada chamando este endpoint com o termo do usuário e permitindo que eles confirmem a empresa.
• Cache: Armazene em cache as buscas bem-sucedidas para nomes populares para reduzir a latência e conservar a cota. Invalide periodicamente quando você espera mudanças no perfil ou nos diretores.
• Tratamento de erros: Verifique o status HTTP e trate objetos vazios ou parciais defensivamente (como no exemplo em Python).
• Localização: A resposta é JSON estruturado. Se você precisar exibir métricas numéricas de forma consistente, formate-as no cliente; não assuma unidades ou moeda a menos que sua UI as especifique.
• Auditoria: Armazene a carga JSON original com um timestamp para que você possa reproduzir o que os usuários viram em um determinado momento.

Casos de uso empresarial que você pode enviar esta semana

• Enriquecimento de leads: Quando um prospecto digita um nome de empresa, chame o endpoint e adicione companyProfile, industry, códigos de troca e dados de liderança ao seu registro de CRM.
• Painel de pesquisa: Construa uma pesquisa de campo único que retorne o perfil e uma lista de pares para que os analistas possam escanear concorrentes e razões de avaliação.
• Verificações de integração: Exiba a descrição da empresa e os títulos dos diretores em uma etapa de revisão para ajudar as equipes de operações a validar se a entidade correta foi selecionada.
• Kit de ferramentas de portfólio: Permita que os PMs pesquisem participações pelo nome e rapidamente acessem códigos de troca para buscas de dados de mercado a jusante.

Chame a API de agentes de IA via MCP

Você também pode invocar APIs Zyla de ferramentas e agentes de codificação de IA compatíveis com MCP. Configure seu cliente para usar o endpoint MCP, e então faça o agente chamar a mesma URL da API LiveMint com seu token bearer. Isso permite que um assistente de IA busque dados da empresa pelo nome durante uma tarefa como "enriquecer esta lista de empresas".

• Endpoint: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
• Use sua chave de API Zyla existente; sua assinatura e cota se aplicam como de costume.
• Dentro das ferramentas do seu agente, emita uma solicitação GET para a URL da API LiveMint com o cabeçalho Authorization.

Para detalhes de compatibilidade com MCP, veja: MCP

Lista de verificação de ponta a ponta

• Obtenha uma chave de API na página da API LiveMint no Zyla API Hub.
• Implemente a chamada GET com o parâmetro de nome e o cabeçalho Authorization: Bearer.
• Analise companyName, industry, companyProfile, identificadores, códigos de troca e pares.
• Adicione cache e confirmação do usuário para nomes ambíguos.
• Monitore o uso em relação à sua cota de assinatura; escale seu plano conforme necessário.

FAQ

Que autenticação a API LiveMint requer?
Use o cabeçalho HTTP: Authorization: Bearer YOUR_API_KEY em cada solicitação.

Quais parâmetros são obrigatórios para "Obter Dados da Empresa pelo Nome"?
Passe o parâmetro de consulta name (string). Exemplo: name=TCS.

O que a resposta inclui?
Um JSON estruturado com campos como companyName, industry, companyProfile (incluindo descrição, identificadores e diretores), códigos de troca e uma peerCompanyList contendo empresas comparáveis e métricas.

O preço é pago por chamada?
Não. A Zyla usa assinatura + cota, não pago por chamada. A API LiveMint oferece uma opção de primeiro uso de um teste de 7 dias ou 50 solicitações—verifique a listagem para detalhes atuais.

Posso chamar esta API de um agente de IA?
Sim. Use o endpoint MCP da Zyla com sua chave de API. Seu agente pode emitir a mesma solicitação GET para a URL da API LiveMint enquanto reutiliza sua assinatura e cota.

Pronto para implementar a pesquisa e enriquecimento pelo nome da empresa? Comece seu teste e obtenha sua chave de API aqui: Comece o teste de 7 dias na API LiveMint

Resposta oficial da API

{"companyName":"Zomato","industry":"Computer Services","companyProfile":{"companyDescription":"Zomato Limited operates as an Internet portal, which helps in connecting the users, restaurant partners/ third-party merchants and the delivery partners. The Company also provides a platform to restaurant partners/brands to advertise themselves to the target audience in India and abroad and supplies ingredients to restaurant partners. The Company’s India food ordering and delivery segment consists of an online marketplace platform through which the Company facilitates the listing and online ordering of food items and the delivery of these food items by connecting end users, restaurant partners and independent delivery partners. Its hyperpure supplies (B2B business) segment offers farm-to-fork supplies for restaurants in India. Its quick commerce segment consists of an online marketplace platform (Marketplace), which enables listing of items sold on the Marketplace by the sellers. The Company’s going-out segment is a combination of its dining-out and entertainment ticketing business.","mgIndustry":"Computer Services","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":"Chief Executive Officer, Founder, Managing Director, Executive Director"}},{"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":"Chief Financial Officer"}},{"rank":3,"since":"01/21/2019","firstName":"Sandhya","mI":null,"lastName":"Sethia","age":null,"title":{"startYear":"2022","startMonth":"3","startDay":"","iD1":"CCO","abbr1":"Chief Comp.","iD2":"SEC","abbr2":"Secy.","Value":"Company Secretary and Compliance Officer"}}]},"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…

Resposta oficial da API

{"companyName":"Zomato","industry":"Computer Services","companyProfile":{"companyDescription":"Zomato Limited operates as an Internet portal, which helps in connecting the users, restaurant partners/ third-party merchants and the delivery partners. The Company also provides a platform to restaurant partners/brands to advertise themselves to the target audience in India and abroad and supplies ingredients to restaurant partners. The Company’s India food ordering and delivery segment consists of an online marketplace platform through which the Company facilitates the listing and online ordering of food items and the delivery of these food items by connecting end users, restaurant partners and independent delivery partners. Its hyperpure supplies (B2B business) segment offers farm-to-fork supplies for restaurants in India. Its quick commerce segment consists of an online marketplace platform (Marketplace), which enables listing of items sold on the Marketplace by the sellers. The Company’s going-out segment is a combination of its dining-out and entertainment ticketing business.","mgIndustry":"Computer Services","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":"Chief Executive Officer, Founder, Managing Director, Executive Director"}},{"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":"Chief Financial Officer"}},{"rank":3,"since":"01/21/2019","firstName":"Sandhya","mI":null,"lastName":"Sethia","age":null,"title":{"startYear":"2022","startMonth":"3","startDay":"","iD1":"CCO","abbr1":"Chief Comp.","iD2":"SEC","abbr2":"Secy.","Value":"Company Secretary and Compliance Officer"}}]},"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…