कंपनी डेटा नाम से प्राप्त करने के लिए API

आपको कंपनी के नाम द्वारा विश्वसनीय व्यावसायिक मूल बातें निकालने की आवश्यकता है और इसे इस सप्ताह भेजना है। इस गाइड के अंत तक, आप Zyla API Hub पर एकल LiveMint API एंडपॉइंट को कॉल करेंगे ताकि नाम द्वारा कंपनी को खोजा जा सके और इसके प्रोफाइल, पहचानकर्ता, नेतृत्व विवरण, एक्सचेंज कोड और समकक्ष तुलना डेटा प्राप्त किया जा सके—जो आपके समृद्धि कार्यों, डैशबोर्ड या आंतरिक उपकरणों में डालने के लिए तैयार है।

यह API क्या करती है और इसका उपयोग कब करें

LiveMint API एक "कंपनी डेटा नाम से प्राप्त करें" एंडपॉइंट प्रदान करती है जो एक नाम या खोज शब्द का उपयोग करके कंपनी को देखती है और संरचित व्यावसायिक और वित्तीय प्रोफाइल डेटा लौटाती है। सामान्य आउटपुट में कंपनी का नाम, उद्योग, एक विस्तृत प्रोफाइल/विवरण, पहचानकर्ता, अधिकारी सूची, स्टॉक एक्सचेंज कोड, और तुलनीय मैट्रिक्स के साथ एक समकक्ष सूची शामिल हैं। डेवलपर्स इसका उपयोग CRM रिकॉर्ड को समृद्ध करने, आंतरिक शोध उपकरणों को शक्ति देने, विश्लेषण के लिए डेटा को बैकफिल करने, या उपयोगकर्ताओं को एक व्यावसायिक नाम टाइप करने और तात्कालिक संरचित परिणाम प्राप्त करने के लिए करते हैं।

यह लेख व्यावसायिक उपयोग के मामले पर केंद्रित है: नाम द्वारा कंपनी की जानकारी प्राप्त करना ताकि ऑनबोर्डिंग, संभावनाओं, सौदे के मूल्यांकन, और पोर्टफोलियो समीक्षा कार्यप्रवाह को चलाया जा सके।

Zyla API Hub पर शुरू करना

Zyla API Hub एक API मार्केटप्लेस है जिसमें एक खाते के तहत 10,000 से अधिक सार्वजनिक APIs हैं, एक API कुंजी और एक सदस्यता + कोटा मॉडल (पे-पर-कॉल नहीं)। LiveMint API 7-दिन के परीक्षण या 50 अनुरोधों का पहले उपयोग का विकल्प प्रदान करती है—जो वर्तमान में उपलब्ध है, उसकी सूची की जांच करें। कोई मुफ्त योजना नहीं है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए पृष्ठ की समीक्षा करें।

शुरू करने के लिए:

• Zyla API Hub पर LiveMint API पृष्ठ खोलें और सदस्यता लें या मुफ्त परीक्षण शुरू करें।
• अपने डैशबोर्ड से अपनी API कुंजी कॉपी करें।
• हर अनुरोध पर Authorization: Bearer YOUR_API_KEY का उपयोग करें।

LiveMint API पर 7-दिन का परीक्षण शुरू करें

एंडपॉइंट: नाम द्वारा कंपनी डेटा प्राप्त करें

इस एंडपॉइंट का उपयोग करें जब आपके पास एक व्यावसायिक नाम (पूर्ण या आंशिक) हो और संरचित कंपनी विवरण की आवश्यकता हो।

• विधि: 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()

# 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"))

आधिकारिक नमूना प्रतिक्रिया

नीचे आधिकारिक उदाहरण प्रतिक्रिया है। आपका आउटपुट कंपनी और खोज शब्द के अनुसार भिन्न होगा, लेकिन वही संरचना बनाए रखें। फ़ील्ड तक पहुँचने के लिए मानक JSON पार्सिंग का उपयोग करें।

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

आप सामान्यतः कौन से फ़ील्ड का उपयोग करेंगे

• 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 रिकॉर्ड में जोड़ें।
• अनुसंधान डैशबोर्ड: एक एकल-क्षेत्र खोज बनाएं जो प्रोफाइल और समकक्ष सूची लौटाती है ताकि विश्लेषक प्रतिस्पर्धियों और मूल्यांकन अनुपात को स्कैन कर सकें।
• ऑनबोर्डिंग जांच: संचालन टीमों को सही इकाई का चयन करने में मदद करने के लिए एक समीक्षा चरण में कंपनी का विवरण और अधिकारी के शीर्षक प्रदर्शित करें।
• पोर्टफोलियो टूलकिट: PMs को नाम द्वारा होल्डिंग्स को देखने और डाउनस्ट्रीम मार्केट डेटा लुकअप के लिए एक्सचेंज कोड पर जल्दी कूदने की अनुमति दें।

MCP के माध्यम से AI एजेंटों से API कॉल करें

आप Zyla APIs को MCP-संगत AI कोडिंग उपकरणों और एजेंटों से भी सक्रिय कर सकते हैं। अपने क्लाइंट को MCP एंडपॉइंट का उपयोग करने के लिए कॉन्फ़िगर करें, फिर एजेंट को आपके बियरर टोकन के साथ उसी LiveMint API URL को कॉल करने दें। इससे एक AI सहायक को "इस व्यवसायों की सूची को समृद्ध करें" जैसे कार्य के दौरान नाम द्वारा कंपनी डेटा प्राप्त करने की अनुमति मिलती है।

• एंडपॉइंट: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
• अपनी मौजूदा Zyla API कुंजी का उपयोग करें; आपकी सदस्यता और कोटा सामान्य रूप से लागू होते हैं।
• अपने एजेंट के उपकरणों के भीतर, Authorization हेडर के साथ LiveMint API URL पर GET अनुरोध जारी करें।

MCP संगतता विवरण के लिए देखें: MCP

एंड-टू-एंड चेकलिस्ट

• Zyla API Hub पर LiveMint API पृष्ठ से एक API कुंजी प्राप्त करें।
• नाम पैरामीटर और Authorization: Bearer हेडर के साथ GET कॉल लागू करें।
• companyName, industry, companyProfile, पहचानकर्ता, एक्सचेंज कोड, और समकक्षों को पार्स करें।
• अस्पष्ट नामों के लिए कैशिंग और उपयोगकर्ता पुष्टि जोड़ें।
• अपनी सदस्यता कोटा के खिलाफ उपयोग की निगरानी करें; आवश्यकता अनुसार अपनी योजना का विस्तार करें।

अक्सर पूछे जाने वाले प्रश्न

LiveMint API को कौन सी प्रमाणीकरण की आवश्यकता है?
प्रत्येक अनुरोध पर HTTP हेडर का उपयोग करें: Authorization: Bearer YOUR_API_KEY।

"कंपनी डेटा नाम से प्राप्त करें" के लिए कौन से पैरामीटर आवश्यक हैं?
नाम क्वेरी पैरामीटर (string) पास करें। उदाहरण: name=TCS।

प्रतिक्रिया में क्या शामिल है?
एक संरचित JSON जिसमें fields जैसे companyName, industry, companyProfile (जिसमें विवरण, पहचानकर्ता, और अधिकारी शामिल हैं), एक्सचेंज कोड, और एक peerCompanyList जिसमें तुलनीय कंपनियाँ और मैट्रिक्स शामिल हैं।

क्या मूल्य निर्धारण पे-पर-कॉल है?
नहीं। Zyla सदस्यता + कोटा का उपयोग करता है, पे-पर-कॉल नहीं। LiveMint API 7-दिन के परीक्षण या 50 अनुरोधों का पहले उपयोग का विकल्प प्रदान करती है—वर्तमान विवरण के लिए सूची की जांच करें।

क्या मैं इस API को AI एजेंट से कॉल कर सकता हूँ?
हाँ। अपनी API कुंजी के साथ Zyla MCP एंडपॉइंट का उपयोग करें। आपका एजेंट आपकी सदस्यता और कोटा का पुन: उपयोग करते हुए LiveMint API URL पर वही GET अनुरोध जारी कर सकता है।

क्या आप कंपनी-नाम खोज और समृद्धि को लागू करने के लिए तैयार हैं? यहाँ अपना परीक्षण शुरू करें और अपनी API कुंजी प्राप्त करें: LiveMint API पर 7-दिन का परीक्षण शुरू करें

आधिकारिक 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…

आधिकारिक 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…