Friday, June 26, 2026
finlight API क्या कर सकता है: एक संपूर्ण अवलोकन
finlight API क्या कर सकता है
finlight एक फाइनेंशियल न्यूज़ API है। यह दुनिया भर की लगातार चलती, अव्यवस्थित मार्केट न्यूज़ को साफ़, संरचित और AI से समृद्ध डेटा में बदल देता है, जिसे आप क्वेरी कर सकते हैं, स्ट्रीम कर सकते हैं, या अपने पास पुश करवा सकते हैं। वेबसाइटें खुद स्क्रैप करने और HTML पार्स करने के बजाय, आपको एक ही सुसंगत इंटरफ़ेस मिलता है जिसमें सेंटिमेंट, कंपनी टैगिंग और समृद्ध फ़िल्टरिंग पहले से बनी हुई है।
यह पेज एक नक़्शा है। इसमें बताया गया है कि finlight आपको क्या देता है, इसे पाने के चार तरीके, और आगे कहाँ जाना है। अगर आप बस अपनी पहली कॉल करना चाहते हैं, तो क्विक स्टार्ट गाइड से शुरुआत करें।
हर लेख में क्या होता है
finlight जो हर लेख लौटाता है वह संरचित और समृद्ध होता है, न कि बस एक हेडलाइन और एक लिंक। आपको मिलता है:
- मुख्य फ़ील्ड्स: शीर्षक, सारांश, पूरा कंटेंट (वैकल्पिक), स्रोत, प्रकाशन तिथि, भाषा और इमेज।
- सेंटिमेंट: हर लेख को कॉन्फ़िडेंस वैल्यू के साथ
positive,neutral, याnegativeस्कोर दिया जाता है, ताकि आप हर खबर पढ़े बिना टोन को मापे जा सकें। - कंपनी एंटिटीज़: finlight उन कंपनियों को टैग करता है जिनके बारे में खबर है और उन्हें असली पहचानकर्ताओं में हल करता है: टिकर, ISIN, OpenFIGI, सेक्टर और इंडस्ट्री, साथ ही हर वह एक्सचेंज जहाँ कंपनी लिस्टेड है (प्राइमरी और सेकेंडरी लिस्टिंग, हर एक के साथ एक्सचेंज कोड और देश)।
- वर्गीकरण: हर लेख को उन देशों के साथ टैग किया जाता है जिन पर वह असर डालता है, और 13 कैटेगरीज़ में से एक या अधिक के साथ।
इसका मतलब है कि आप "इस हफ़्ते AAPL पर सेंटिमेंट कैसे बदला?" या "मुझे हर वह रेगुलेशन खबर दिखाओ जो कंपनियों के एक समूह को प्रभावित करती है" जैसे सवालों का जवाब बिना खुद एक NLP पाइपलाइन बनाए दे सकते हैं।
डेटा पाने के चार तरीके
वही समृद्ध डेटा चार डिलीवरी तरीकों से उपलब्ध है। आप अपने वर्कलोड के अनुकूल तरीका चुनें।
REST API
माँग के अनुसार न्यूज़ क्वेरी करें: एक रिक्वेस्ट भेजें, मिलते-जुलते लेखों का एक पेज वापस पाएँ। सर्च, बैकफ़िल,
शेड्यूल किए गए डैशबोर्ड, और किसी भी रिक्वेस्ट/रिस्पॉन्स वर्कफ़्लो के लिए सबसे बढ़िया। एडवांस्ड POST /v2/articles
एंडपॉइंट पूरे फ़िल्टर सेट को सपोर्ट करता है, और किसी एक लेख को URL से प्राप्त करने तथा उपलब्ध स्रोतों की सूची देने
के लिए भी एंडपॉइंट हैं। देखें REST डॉक्स।
WebSocket
लेख प्रकाशित होते ही उन्हें रियल-टाइम में स्ट्रीम करें, बिना किसी पोलिंग के। यह दो रूपों में आता है: पूरी समृद्धि (सेंटिमेंट और एंटिटीज़) वाला एक एन्हांस्ड स्ट्रीम, और तब के लिए एक हल्का रॉ स्ट्रीम जब आपको केवल बुनियादी जानकारी तेज़ी से चाहिए। लाइव डैशबोर्ड, ट्रेडिंग सिग्नल और मॉनिटरिंग के लिए आदर्श। देखें WebSocket डॉक्स।
Webhooks
finlight से न्यूज़ को उस क्षण अपने एंडपॉइंट पर पुश करवाएँ जब वह आपके फ़िल्टर से मेल खाए। एन्हांस्ड और रॉ दोनों प्रकार उपलब्ध हैं, और डिलीवरीज़ साइन की जाती हैं ताकि आप उन्हें सत्यापित कर सकें। इवेंट-संचालित पाइपलाइन, अलर्ट, और ऐसी ऑटोमेशन के लिए सबसे बढ़िया जो आपकी पोलिंग के बिना चलनी चाहिए। देखें webhook डॉक्स।
MCP सर्वर
Model Context Protocol के ज़रिए finlight को Claude या ChatGPT जैसे किसी AI असिस्टेंट से जोड़ें, फिर सादी भाषा में मार्केट न्यूज़ माँगें। बिना कोड लिखे रिसर्च और तात्कालिक विश्लेषण के लिए सबसे बढ़िया। देखें AI असिस्टेंट डॉक्स।
मोटे तौर पर: माँग के लिए REST, लाइव के लिए WebSocket, पुश ऑटोमेशन के लिए webhooks, और AI-संचालित रिसर्च के लिए MCP। एक समर्पित तुलना गाइड जल्द आ रही है।
सटीक फ़िल्टरिंग
finlight इसी सोच पर बना है कि आपको ठीक वही न्यूज़ मिले जो आप चाहते हैं। REST, WebSocket और webhooks में आप इनके अनुसार फ़िल्टर कर सकते हैं:
- टिकर:
AAPLयाNVDAजैसी कंपनियाँ। - देश: विशिष्ट मार्केट्स पर ध्यान केंद्रित करने के लिए ISO देश कोड।
- कैटेगरी: 13 में से कोई भी,
marketsऔरeconomyसे लेकरcrypto,regulation, औरenergyतक। - स्रोत: विशिष्ट मीडिया को शामिल करें या बाहर रखें, या अतिरिक्त स्रोतों को चुनें।
- डेट रेंज और एक पूरी क्वेरी लैंग्वेज, बूलियन ऑपरेटर और फ़ील्ड फ़िल्टर के साथ, उदाहरण के लिए
(ticker:AAPL OR ticker:NVDA) AND NOT source:reuters.com।
पूरी क्वेरी सिंटैक्स के लिए देखें एडवांस्ड क्वेरी डॉक्स।
वैश्विक, बहुभाषी कवरेज
finlight 9 भाषाओं में न्यूज़ कवर करता है: अंग्रेज़ी, सरलीकृत चीनी, हिंदी, स्पेनिश, जापानी, कोरियाई, पुर्तगाली, अरबी और रूसी। देश और कैटेगरी फ़िल्टर के साथ मिलकर, यह आपको किसी मार्केट को उसकी अपनी भाषा और क्षेत्र में ट्रैक करने देता है, बजाय केवल-अंग्रेज़ी कवरेज पर निर्भर रहने के।
डेवलपर्स के लिए बना
आप finlight को सादे HTTP से कॉल कर सकते हैं, या ऑफ़िशियल SDK इस्तेमाल कर सकते हैं:
- Node / TypeScript:
npm install finlight-client - Python:
pip install finlight-client
दोनों REST और WebSocket APIs को रैप करते हैं, ऑथ और रिट्राई संभालते हैं, और टाइप्ड ऑब्जेक्ट लौटाते हैं।
ऑथेंटिकेशन हर रिक्वेस्ट पर एक ही X-API-KEY हेडर है, जिसमें वह key होती है जो आप
डैशबोर्ड में जनरेट करते हैं। एक न्यूनतम रिक्वेस्ट इस तरह दिखती है:
curl -X POST https://api.finlight.me/v2/articles \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "tickers": ["AAPL"], "pageSize": 5 }'
प्लान्स
finlight में टेस्टिंग के लिए एक free टियर से लेकर enterprise तक के प्लान्स हैं, जो मुख्यतः रिक्वेस्ट वॉल्यूम, हिस्ट्री की गहराई, रियल-टाइम एक्सेस, और कस्टम स्रोतों जैसी सुविधाओं में भिन्न हैं। free प्लान केवल REST के लिए है और मूल्यांकन के लिए आदर्श है। मौजूदा सीमाओं और हर टियर में क्या अनलॉक होता है, यह देखने के लिए finlight.me/pricing देखें।
बनाना शुरू करें
- यहाँ नए हैं? पाँच मिनट में अपनी पहली कॉल करने के लिए क्विक स्टार्ट गाइड का पालन करें।
- गहराई में जाने के लिए तैयार हैं? पूरी डॉक्युमेंटेशन ब्राउज़ करें।
- सवाल हैं? Discord से जुड़ें या info@finlight.me पर ईमेल करें।
