Necesitas obtener fundamentos comerciales confiables por nombre de empresa y enviarlo esta semana. Al final de esta guía, llamarás a un único endpoint de la API de LiveMint en Zyla API Hub para buscar una empresa por nombre y recuperar su perfil, identificadores, detalles de liderazgo, códigos de intercambio y datos de comparación con pares, listos para integrarse en tus trabajos de enriquecimiento, tableros o herramientas internas.
Qué hace esta API y cuándo usarla
La API de LiveMint proporciona un endpoint de "Obtener datos de la empresa por nombre" que busca una empresa utilizando un nombre o término de búsqueda y devuelve datos estructurados del perfil comercial y financiero. Las salidas típicas incluyen el nombre de la empresa, la industria, un perfil/descripción detallada, identificadores, listas de funcionarios, códigos de bolsa y una lista de pares con métricas comparables. Los desarrolladores la utilizan para enriquecer registros de CRM, potenciar herramientas de investigación internas, completar datos para análisis, o permitir que los usuarios escriban un nombre de negocio y obtengan resultados estructurados inmediatos.
Este artículo se centra en el caso de uso empresarial: obtener información de la empresa por nombre para impulsar la incorporación, la prospección, la evaluación de acuerdos y los flujos de trabajo de revisión de cartera.
Comenzando en Zyla API Hub
Zyla API Hub es un mercado de API con más de 10,000 API públicas bajo una cuenta, una clave de API y un modelo de suscripción + cuota (no pago por llamada). La API de LiveMint ofrece una opción de primer uso de una prueba de 7 días o 50 solicitudes; consulta la lista para ver lo que está disponible actualmente. No hay Plan Gratuito; revisa la página para las opciones de acceso y precios actuales.
Para comenzar:
- Abre la página de la API de LiveMint en Zyla API Hub y haz clic en Suscribirse o Comenzar prueba gratuita.
- Copia tu clave de API desde tu panel de control.
- Usa Authorization: Bearer YOUR_API_KEY en cada solicitud.
Comienza la prueba de 7 días en la API de LiveMint
Endpoint: Obtener datos de la empresa por nombre
Usa este endpoint cuando tengas un nombre de negocio (completo o parcial) y necesites detalles estructurados de la empresa.
- Método: GET
- URL: https://zylalabs.com/api/4204/livemint-api/5100/get-company-data-by-name
- Parámetro de consulta requerido:
- name (string): El nombre de la empresa o término de búsqueda. Ejemplo: TCS
- Autenticación: Authorization: Bearer YOUR_API_KEY
Ejemplo 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"Ejemplo de Python (requests)
Este ejemplo llama al mismo endpoint, verifica la respuesta y extrae campos comúnmente utilizados para flujos de trabajo empresariales como enriquecimiento y perfilado.
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()
# Extraer algunos campos útiles si están 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("Industria:", industry)
print("ISIN:", isin)
print("BSE:", bse_code, "NSE:", nse_code)
print("Perfil:", (profile or "")[:240] + ("..." if profile and len(profile) > 240 else ""))
# Ejemplo: primer funcionario y primer par si están disponibles
officers = ((data.get("companyProfile") or {}).get("officers") or {}).get("officer") or []
if officers:
o = officers[0]
print("Principal Funcionario:", o.get("firstName"), o.get("lastName"), "-", (o.get("title") or {}).get("Value"))
peers = data.get("peerCompanyList") or []
if peers:
p = peers[0]
print("Primer Par:", p.get("companyName"), "| P/E:", p.get("priceToEarningsValueRatio"))Respuesta de ejemplo oficial
A continuación se muestra la respuesta de ejemplo oficial. Tu salida variará según la empresa y el término de búsqueda, pero mantendrá la misma estructura. Usa el análisis JSON estándar para acceder a los campos.
{"companyName":"Zomato","industry":"Computer Services","companyProfile":{"companyDescription":"Zomato Limited opera como un portal de Internet, que ayuda a conectar a los usuarios, socios de restaurantes/ comerciantes de terceros y los socios de entrega. La Compañía también proporciona una plataforma a los socios/marcas de restaurantes para publicitarse ante el público objetivo en India y en el extranjero y suministra ingredientes a los socios de restaurantes. El segmento de pedidos y entrega de alimentos de la Compañía en India consiste en una plataforma de mercado en línea a través de la cual la Compañía facilita la lista y el pedido en línea de artículos alimenticios y la entrega de estos artículos alimenticios conectando a los usuarios finales, socios de restaurantes y socios de entrega independientes. Su segmento de suministros hiperpuros (negocio B2B) ofrece suministros de la granja a la mesa para restaurantes en India. Su segmento de comercio rápido consiste en una plataforma de mercado en línea (Marketplace), que permite la lista de artículos vendidos en el Marketplace por los vendedores. El segmento de salir de la Compañía es una combinación de su negocio de cenas y venta de entradas de entretenimiento.","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":"Director Ejecutivo, Fundador, Director General, Director Ejecutivo"}},{"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":"Director Financiero"}},{"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":"Secretario de la Compañía y Oficial de Cumplimiento"}}]},"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…Qué campos usarás típicamente
- companyName, industry: Mostrar nombres y clasificación de la industria para UIs e informes.
- companyProfile.companyDescription: Un perfil narrativo útil en vistas de investigación y enriquecimiento de CRM.
- companyProfile.isInId: Identificador que puedes almacenar para reconciliación entre sistemas.
- companyProfile.officers.officer[]: Lista de liderazgo que puede enriquecer la debida diligencia y las verificaciones de gobernanza.
- exchangeCodeBse, exchangeCodeNse: Útil para vincular a widgets de datos de mercado o flujos de trabajo específicos de intercambio.
- peerCompanyList[]: Un conjunto comparable rápido con métricas comunes de valoración y rentabilidad.
Notas de implementación práctica
- Comportamiento de búsqueda: El parámetro de nombre acepta nombres completos, nombres abreviados o términos de búsqueda compatibles con la búsqueda estilo LiveMint, permitiendo una entrada flexible del usuario.
- Desduplicación y selección: Nombres populares pueden resolverse en múltiples entidades; presenta la mejor coincidencia, o muestra una lista seleccionada llamando a este endpoint con el término del usuario y permitiéndole confirmar la empresa.
- Cacheo: Almacena en caché las búsquedas exitosas para nombres populares para reducir la latencia y conservar la cuota. Invalida periódicamente cuando esperas cambios en el perfil o en los funcionarios.
- Manejo de errores: Verifica el estado HTTP y maneja objetos vacíos o parciales de manera defensiva (como en el ejemplo de Python).
- Localización: La respuesta es JSON estructurado. Si necesitas mostrar métricas numéricas de manera consistente, formatealas en el cliente; no asumas unidades o moneda a menos que tu UI las especifique.
- Auditoría: Almacena la carga útil JSON original con una marca de tiempo para que puedas reproducir lo que los usuarios vieron en un momento dado.
Casos de uso empresarial que puedes implementar esta semana
- Enriquecimiento de leads: Cuando un prospecto escribe un nombre de empresa, llama al endpoint y agrega companyProfile, industry, códigos de intercambio y datos de liderazgo a tu registro de CRM.
- Tablero de investigación: Construye una búsqueda de un solo campo que devuelva el perfil y una lista de pares para que los analistas puedan escanear competidores y ratios de valoración.
- Verificaciones de incorporación: Muestra la descripción de la empresa y los títulos de los funcionarios en un paso de revisión para ayudar a los equipos de operaciones a validar que se seleccionó la entidad correcta.
- Kit de herramientas de cartera: Permite a los PM buscar participaciones por nombre y saltar rápidamente a los códigos de intercambio para búsquedas de datos de mercado posteriores.
Llama a la API desde agentes de IA a través de MCP
También puedes invocar las APIs de Zyla desde herramientas y agentes de codificación de IA compatibles con MCP. Configura tu cliente para usar el endpoint MCP, luego haz que el agente llame a la misma URL de la API de LiveMint con tu token de portador. Esto permite que un asistente de IA obtenga datos de la empresa por nombre durante una tarea como "enriquecer esta lista de negocios".
- Endpoint: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
- Usa tu clave de API de Zyla existente; tu suscripción y cuota se aplican como de costumbre.
- Dentro de las herramientas de tu agente, emite una solicitud GET a la URL de la API de LiveMint con el encabezado de Autorización.
Para detalles de compatibilidad con MCP, consulta: MCP
Lista de verificación de extremo a extremo
- Obtén una clave de API de la página de la API de LiveMint en Zyla API Hub.
- Implementa la llamada GET con el parámetro de nombre y el encabezado Authorization: Bearer.
- Analiza companyName, industry, companyProfile, identificadores, códigos de intercambio y pares.
- Agrega cacheo y confirmación del usuario para nombres ambiguos.
- Monitorea el uso contra tu cuota de suscripción; escala tu plan según sea necesario.
FAQ
¿Qué autenticación requiere la API de LiveMint?
Usa el encabezado HTTP: Authorization: Bearer YOUR_API_KEY en cada solicitud.
¿Qué parámetros son necesarios para "Obtener datos de la empresa por nombre"?
Pasa el parámetro de consulta de nombre (string). Ejemplo: name=TCS.
¿Qué incluye la respuesta?
Un JSON estructurado con campos como companyName, industry, companyProfile (incluyendo descripción, identificadores y funcionarios), códigos de intercambio y una peerCompanyList que contiene empresas y métricas comparables.
¿El precio es por llamada?
No. Zyla utiliza suscripción + cuota, no pago por llamada. La API de LiveMint ofrece una opción de primer uso de una prueba de 7 días o 50 solicitudes; consulta la lista para detalles actuales.
¿Puedo llamar a esta API desde un agente de IA?
Sí. Usa el endpoint MCP de Zyla con tu clave de API. Tu agente puede emitir la misma solicitud GET a la URL de la API de LiveMint mientras reutiliza tu suscripción y cuota.
¿Listo para implementar la búsqueda y enriquecimiento por nombre de empresa? Comienza tu prueba y obtén tu clave de API aquí: Comienza la prueba de 7 días en la API de LiveMint
Respuesta oficial de la API
{"companyName":"Zomato","industry":"Computer Services","companyProfile":{"companyDescription":"Zomato Limited opera como un portal de Internet, que ayuda a conectar a los usuarios, socios de restaurantes/ comerciantes de terceros y los socios de entrega. La Compañía también proporciona una plataforma a los socios/marcas de restaurantes para publicitarse ante el público objetivo en India y en el extranjero y suministra ingredientes a los socios de restaurantes. El segmento de pedidos y entrega de alimentos de la Compañía en India consiste en una plataforma de mercado en línea a través de la cual la Compañía facilita la lista y el pedido en línea de artículos alimenticios y la entrega de estos artículos alimenticios conectando a los usuarios finales, socios de restaurantes y socios de entrega independientes. Su segmento de suministros hiperpuros (negocio B2B) ofrece suministros de la granja a la mesa para restaurantes en India. Su segmento de comercio rápido consiste en una plataforma de mercado en línea (Marketplace), que permite la lista de artículos vendidos en el Marketplace por los vendedores. El segmento de salir de la Compañía es una combinación de su negocio de cenas y venta de entradas de entretenimiento.","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":"Director Ejecutivo, Fundador, Director General, Director Ejecutivo"}},{"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":"Director Financiero"}},{"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":"Secretario de la Compañía y Oficial de Cumplimiento"}}]},"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…Respuesta oficial de la API
{"companyName":"Zomato","industry":"Computer Services","companyProfile":{"companyDescription":"Zomato Limited opera como un portal de Internet, que ayuda a conectar a los usuarios, socios de restaurantes/ comerciantes de terceros y los socios de entrega. La Compañía también proporciona una plataforma a los socios/marcas de restaurantes para publicitarse ante el público objetivo en India y en el extranjero y suministra ingredientes a los socios de restaurantes. El segmento de pedidos y entrega de alimentos de la Compañía en India consiste en una plataforma de mercado en línea a través de la cual la Compañía facilita la lista y el pedido en línea de artículos alimenticios y la entrega de estos artículos alimenticios conectando a los usuarios finales, socios de restaurantes y socios de entrega independientes. Su segmento de suministros hiperpuros (negocio B2B) ofrece suministros de la granja a la mesa para restaurantes en India. Su segmento de comercio rápido consiste en una plataforma de mercado en línea (Marketplace), que permite la lista de artículos vendidos en el Marketplace por los vendedores. El segmento de salir de la Compañía es una combinación de su negocio de cenas y venta de entradas de entretenimiento.","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":"Director Ejecutivo, Fundador, Director General, Director Ejecutivo"}},{"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":"Director Financiero"}},{"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":"Secretario de la Compañía y Oficial de Cumplimiento"}}]},"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…
