API to get company data by name

You need to pull reliable business fundamentals by company name and ship it this week. By the end of this guide, you’ll call a single LiveMint API endpoint on Zyla API Hub to search a company by name and retrieve its profile, identifiers, leadership details, exchange codes, and peer comparison data—ready to drop into your enrichment jobs, dashboards, or internal tools.

What this API does and when to use it

The LiveMint API provides a “Get Company Data by Name” endpoint that looks up a company using a name or search term and returns structured business and financial profile data. Typical outputs include company name, industry, a detailed profile/description, identifiers, officer listings, stock exchange codes, and a peer list with comparable metrics. Developers use it to enrich CRM records, power internal research tools, backfill data for analytics, or let users type a business name and get immediate structured results.

Illustration: API to get company data by name

This article focuses on the Business use case: fetching company information by name to drive onboarding, prospecting, deal assessment, and portfolio review workflows.

Getting started on Zyla API Hub

Zyla API Hub is an API marketplace with more than 10,000 public APIs under one account, one API key and a subscription + quota model (not pay-per-call). The LiveMint API offers a first-use option of a 7-day trial or 50 requests—check the listing for what’s currently available. There is no Free Plan; review the page for current access options and pricing.

To start:

Open the LiveMint API page on Zyla API Hub and click Subscribe or Start Free Trial.
Copy your API key from your dashboard.
Use Authorization: Bearer YOUR_API_KEY on every request.

Start 7-day trial on LiveMint API

Endpoint: Get Company Data by Name

Use this endpoint when you have a business name (full or partial) and need structured company details.

Method: GET
URL: https://zylalabs.com/api/4204/livemint-api/5100/get-company-data-by-name
Required query parameter:
- name (string): The company name or search term. Example: TCS
Authentication: Authorization: Bearer YOUR_API_KEY

cURL example

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

This example calls the same endpoint, checks the response, and extracts commonly used fields for business workflows like enrichment and profiling.

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

# Pull a few useful fields if present
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:", company_name)
print("Industry:", industry)
print("ISIN:", isin)
print("BSE:", bse_code, "NSE:", nse_code)
print("Profile:", (profile or "")[:240] + ("..." if profile and len(profile) > 240 else ""))

# Example: first officer and first peer if available
officers = ((data.get("companyProfile") or {}).get("officers") or {}).get("officer") or []
if officers:
o = officers[0]
print("Top Officer:", o.get("firstName"), o.get("lastName"), "-", (o.get("title") or {}).get("Value"))

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

Official sample response

Below is the official example response. Your output will vary by company and search term, but keep the same structure. Use standard JSON parsing to access fields.

{"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…

What fields you’ll typically use

companyName, industry: Display names and industry classification for UIs and reports.
companyProfile.companyDescription: A narrative profile useful in research views and CRM enrichment.
companyProfile.isInId: Identifier you can store for reconciliation across systems.
companyProfile.officers.officer[]: Leadership roster that can enrich due diligence and governance checks.
exchangeCodeBse, exchangeCodeNse: Useful for linking to market data widgets or exchange-specific workflows.
peerCompanyList[]: A quick comparable set with common valuation and profitability metrics.

Practical implementation notes

Search behavior: The name parameter accepts full names, shortened names, or search terms supported by LiveMint-style search, enabling flexible user input.
Deduping and selection: Popular names may resolve to multiple entities; present the top match, or show a select list by calling this endpoint with the user’s term and letting them confirm the company.
Caching: Cache successful lookups for popular names to reduce latency and conserve quota. Invalidate periodically when you expect profile or officer changes.
Error handling: Check HTTP status and handle empty or partial objects defensively (as in the Python example).
Localization: The response is structured JSON. If you need to display numeric metrics consistently, format them on the client; do not assume units or currency unless your UI specifies them.
Auditing: Store the original JSON payload with a timestamp so you can reproduce what users saw at a given time.

Business use cases you can ship this week

Lead enrichment: When a prospect types a company name, call the endpoint and add companyProfile, industry, exchange codes, and leadership data into your CRM record.
Research dashboard: Build a single-field search that returns the profile and a peer list so analysts can scan competitors and valuation ratios.
Onboarding checks: Display company description and officer titles in a review step to help operations teams validate the correct entity was selected.
Portfolio toolkit: Allow PMs to look up holdings by name and quickly jump to exchange codes for downstream market data lookups.

Call the API from AI agents via MCP

You can also invoke Zyla APIs from MCP-compatible AI coding tools and agents. Configure your client to use the MCP endpoint, then have the agent call the same LiveMint API URL with your bearer token. This lets an AI assistant fetch company data by name during a task like “enrich this list of businesses.”

Endpoint: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Use your existing Zyla API key; your subscription and quota apply as usual.
Within your agent’s tooling, issue a GET request to the LiveMint API URL with the Authorization header.

For MCP compatibility details, see: MCP

End-to-end checklist

Get an API key from the LiveMint API page on Zyla API Hub.
Implement the GET call with the name parameter and Authorization: Bearer header.
Parse companyName, industry, companyProfile, identifiers, exchange codes, and peers.
Add caching and user confirmation for ambiguous names.
Monitor usage against your subscription quota; scale your plan as needed.

FAQ

What authentication does the LiveMint API require?
Use the HTTP header: Authorization: Bearer YOUR_API_KEY on every request.

Which parameters are required for “Get Company Data by Name”?
Pass the name query parameter (string). Example: name=TCS.

What does the response include?
A structured JSON with fields such as companyName, industry, companyProfile (including description, identifiers, and officers), exchange codes, and a peerCompanyList containing comparable companies and metrics.

Is pricing pay-per-call?
No. Zyla uses subscription + quota, not pay-per-call. The LiveMint API offers a first-use option of a 7-day trial or 50 requests—check the listing for current details.

Can I call this API from an AI agent?
Yes. Use the Zyla MCP endpoint with your API key. Your agent can issue the same GET request to the LiveMint API URL while reusing your subscription and quota.

Ready to implement company-name search and enrichment? Start your trial and get your API key here: Start 7-day trial on LiveMint API

Official API response

{"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…

Official API response

{"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…