यह पृष्ठ मशीन द्वारा अनुवादित है। अंग्रेज़ी संस्करण मूल स्रोत है और अधिक सटीक या अधिक अद्यतन हो सकता है। अंग्रेज़ी में देखें

उन्नत क्वेरी निर्माण

finlight.me API के साथ काम करते समय, उन्नत क्वेरी निर्माण तकनीकें आपको ठीक वही डेटा पुनर्प्राप्त करने देती हैं जिसकी आपको आवश्यकता है। यह गाइड आपको जटिल फ़िल्टरिंग, सॉर्टिंग और पेजिनेशन के माध्यम से चरण-दर-चरण ले जाती है, जिससे आपको अपनी डेटा पुनर्प्राप्ति प्रक्रिया को अनुकूलित करने में मदद मिलती है।

API तक त्वरित पहुँच और अपनी क्वेरीज़ का परीक्षण करने के लिए डैशबोर्ड - API टेस्टर का उपयोग करें।

भाषा और बहुभाषी दायरा

finlight कई भाषाओं में समाचार अनुक्रमित करता है, लेकिन प्रत्येक अनुरोध एक भाषा के अनुसार फ़िल्टर किया जाता है। language पैरामीटर का डिफ़ॉल्ट मान en है, इसलिए यदि आप इसे सेट नहीं करते हैं तो आपको केवल अंग्रेज़ी लेख मिलेंगे — अन्य भाषाओं की सामग्री चुपचाप बाहर कर दी जाती है।

महत्वपूर्ण: language का डिफ़ॉल्ट en है। language के बिना अनुरोध केवल अंग्रेज़ी लौटाता है। अन्य भाषाओं में प्रकाशित लेख (जैसे कई चीनी प्रकाशन, zh) तब तक नहीं लौटाए जाते जब तक आप स्पष्ट रूप से उस भाषा का अनुरोध न करें।

यह कैसे काम करता है

  • लेख स्तर, सटीक मिलान। language प्रत्येक लेख के ISO 639-1 कोड के अनुसार सटीक मिलान के रूप में फ़िल्टर करता है। language=en केवल en लेख लौटाता है और कभी de, zh आदि नहीं।
  • प्रति अनुरोध एक भाषा। language एक मान स्वीकार करता है — सरणियाँ/अल्पविराम-सूचियाँ समर्थित नहीं हैं, और कोई "सभी भाषाएँ" विकल्प नहीं है। कई भाषाओं को कवर करने के लिए, प्रति भाषा एक अनुरोध भेजें और परिणामों को मर्ज करें।
  • स्रोत बहुभाषी हो सकते हैं। एक ही स्रोत एक से अधिक भाषाओं में प्रकाशित कर सकता है। फ़िल्टर लेख की भाषा के अनुसार चुनता है, स्रोत के अनुसार नहीं। किसी प्रकाशन के गैर-अंग्रेज़ी लेख तभी दिखेंगे जब आप उस भाषा का अनुरोध करेंगे।

उदाहरण

डिफ़ॉल्ट (केवल अंग्रेज़ी) — समान:

query=Alibaba
query=Alibaba&language=en

चीनी दायरा:

query=Alibaba&language=zh

अंग्रेज़ी + चीनी को कवर करना — दो अनुरोध, फिर मर्ज:

query=Alibaba&language=en
query=Alibaba&language=zh

सुझाव: ISO 639-1 कोड (en, de, fr, zh आदि) का उपयोग करें। finlight का आधार स्रोत समूह कई भाषाओं में फैला है — अंग्रेज़ी केवल एक डिफ़ॉल्ट फ़िल्टर है, दायरे की सीमा नहीं।

क्वेरी फ़िल्टरिंग

query पैरामीटर लचीली कीवर्ड-आधारित लॉजिक और फ़ील्ड-स्तरीय सटीकता सक्षम करता है। अब आप ticker, exchange, isin, source, openfigi आदि जैसे विशिष्ट फ़ील्ड को लक्षित कर सकते हैं।

बुनियादी कीवर्ड उपयोग

एकल कीवर्ड:

query=Nvidia stock

सटीक वाक्यांश: सटीक मिलान खोजने के लिए, वाक्यांश को दोहरे उद्धरण चिह्नों में रखें।

query="Elon Musk"

ऑपरेटरों के साथ समावेशन / बहिष्करण

समावेशन (+) और बहिष्करण (-) को बाध्य करना:

किसी पद या फ़ील्ड-विशिष्ट मान को आवश्यक/शामिल करने के लिए + का और बाहर करने के लिए - का उपयोग करें।

query=stock +market -google

यह "stock" और "market" वाले लेख लौटाएगा लेकिन "google" का उल्लेख करने वाले लेखों को बाहर कर देगा।

फ़ील्ड-स्तरीय फ़िल्टरिंग

नोट: यह एक शक्तिशाली नई सुविधा है जो आपको query पैरामीटर के भीतर सीधे विशिष्ट फ़ील्ड के अनुसार परिणामों को फ़िल्टर करने देती है।

अब आप query पैरामीटर में field:value सिंटैक्स का उपयोग करके सीधे विशिष्ट फ़ील्ड क्वेरी कर सकते हैं। यह अधिक सटीक और जटिल क्वेरीज़ सक्षम करता है, जिससे आप टिकर सिंबल, एक्सचेंज, ISIN, स्रोत आदि जैसी विशेष विशेषताओं के अनुसार परिणामों को फ़िल्टर कर सकते हैं।

✨ नया: किसी भी मान से मिलान करने के लिए source, ticker, और exchange फ़ील्ड के साथ वाइल्डकार्ड * का उपयोग करें (जैसे source:*, ticker:*, exchange:*)।

समर्थित फ़ील्ड

  • ticker (वाइल्डकार्ड * समर्थित)

  • isin

  • title

  • summary

  • content

  • openfigi

  • exchange (वाइल्डकार्ड * समर्थित)

    • सभी एक्सचेंज MIC (मार्केट आइडेंटिफ़ायर कोड) मानक के हैं। समर्थित कोड हैं: ASEX, BVCA, BVMF, DSMD, HSTC, XSTC, MISX, NEOE, PFTS, ROCO, XADS, XAMM, XAMS, XASX, XBAH, XBEL, XBEY, XBKK, XBOG, XBOM, XBOT, XBRA, XBRU, XBSE, XBUD, XBUE, XBUL, XCAS, XCNQ, XCOL, XCSE, XCYS, XDAR, XDFM, XDHA, XDUS, XETR, XFKA, XFRA, XGHA, XHAM, XHEL, XHKG, XICE, XIDX, XIST, XJAM, XJSE, XKAR, XKAZ, XKLS, XKOR, XKUW, XLIM, XLIS, XLIT, XLJS, XLUS, XLUX, XMAL, XMAU, XMEX, XMIL, XMSW, XMUN, XNAI, XNAM, XNAS, XNGM, XNGO, XNSA, XNSE, XNYS, XASE, XOSL, XPAR, XPHS, XPRA, XRIS, XSAP, XSAU, XSES, XSCA, XSGO, XSHE, XSHG, XKRX, XSTU, XSWX, XTAE, XTAI, XTAL, XTSE, XTSX, XTUN, XUBS, XUGA, XWAR, XWBO, XZAG, XZIM, XSTO, OTCM, BMEX, XDUB, XJPX, BCXE, XPAE, XLON, XMUS, XNZE, XCAI, XBRV

  • country

    • ISO 3166-1 alpha-2 देश कोड का उपयोग करके कंपनी के देश के अनुसार फ़िल्टर करें (जैसे US, GB, DE, JP, CN, FR, CA, AU, IN, BR आदि)

  • category

    • लेख श्रेणी के अनुसार फ़िल्टर करें। संभावित मान: markets, economy, business, politics, geopolitics, regulation, technology, energy, commodities, crypto, health, climate, security

  • source (वाइल्डकार्ड * समर्थित)

वाइल्डकार्ड समर्थन

वाइल्डकार्ड * आपको अपनी क्वेरी में स्पष्ट रूप से सभी स्रोत, टिकर या एक्सचेंज शामिल करने देता है। यह व्यापक कवरेज सुनिश्चित करने या अन्य फ़िल्टर के साथ संयोजन करते समय विशेष रूप से उपयोगी है।

उदाहरण:

query=source:*

सभी उपलब्ध स्रोतों से लेख लौटाता है।

query=ticker:* country:US

अमेरिका की कंपनियों के सभी टिकरों के लिए लेख लौटाता है।

query=exchange:* -crypto

क्रिप्टो सामग्री को छोड़कर सभी एक्सचेंजों से लेख लौटाता है।

फ़ील्ड फ़िल्टर उदाहरण

API टेस्टर में देखें कि यह कैसे काम करता है और आसानी से अपनी जटिल क्वेरीज़ बनाएँ।

सटीक स्रोत के अनुसार फ़िल्टर करें:

query=source:www.some-source.de

किसी स्रोत को बाहर करें:

query=-source:www.some-source.de

किसी विशिष्ट टिकर की आवश्यकता और कुछ स्रोतों को बाहर करना:

query=ticker:AAPL -source:www.some-source.de

ऐसे परिणाम खोजें जहाँ सामग्री "earnings" का उल्लेख करती है और एक्सचेंज NASDAQ है:

query=content:earnings exchange:nasdaq

किसी विशिष्ट देश की कंपनियों के अनुसार फ़िल्टर करें:

query=country:US

जर्मन कंपनियों के बारे में समाचार खोजें लेकिन Schulden को बाहर करें:

query=country:DE -Schulden

देश और टिकर फ़िल्टरिंग का संयोजन:

query=country:US ticker:NVD

फ़ील्ड फ़िल्टरिंग को सामान्य खोज के साथ संयोजित करना:

query="quarterly report" source:www.some-source.com -crypto

बूलियन ऑपरेटर

नोट: शब्द डिफ़ॉल्ट रूप से AND से जुड़ते हैं, इसलिए जब तक आप OR या NOT के साथ संयोजन नहीं कर रहे हों, तब तक स्पष्ट रूप से AND का उपयोग करने की आवश्यकता नहीं है।

AND / OR / NOT लॉजिक पूरी तरह समर्थित है:

query=stock AND google
query=amazon OR google
query=market AND NOT bitcoin

समूहीकरण के लिए कोष्ठक का उपयोग करें: उन्नत फ़िल्टरिंग के लिए तार्किक अभिव्यक्तियों को संयोजित करें।

query=("Elon Musk") AND (twitter OR tesla)

शक्तिशाली क्वेरीज़ के लिए वाइल्डकार्ड के साथ संयोजित करें:

query=ticker:* AND (country:US OR country:GB) -crypto
query=source:* exchange:XNAS

💡 उन्नत उपयोगकर्ताओं के लिए सुझाव

  • फ़ील्ड फ़िल्टर आवश्यक और बहिष्कृत मानों के लिए + और - का समर्थन करते हैं।
  • वाइल्डकार्ड * का उपयोग किसी भी मान से मिलान करने के लिए source, ticker और exchange फ़ील्ड के साथ किया जा सकता है।
  • आप अत्यधिक लक्षित क्वेरीज़ के लिए कई फ़ील्ड और कीवर्ड संयोजित कर सकते हैं।
  • AND, OR, NOT जैसे बूलियन ऑपरेटर केस-असंवेदनशील हैं।
  • कोष्ठक () जटिल क्वेरीज़ में प्राथमिकता को नियंत्रित करने में मदद करते हैं।
  • आंशिक मिलान से बचने के लिए बहु-शब्द वाक्यांशों को दोहरे उद्धरण चिह्नों " में रखें।

निष्कर्ष - सब कुछ एक साथ संयोजित करना

उदाहरण: विश्वसनीय स्रोतों से Tesla (ticker:TSLA) के गैर-क्रिप्टो समाचार चाहिए?

query=+ticker:TSLA -crypto AND (+source:www.bloomberg.com OR +source:www.reuters.com)

उदाहरण: Bloomberg से Tesla (ticker:TSLA) या Apple (ticker:AAPL) के समाचार चाहिए?

query=source:www.bloomberg.com AND ticker:TSLA OR source:www.bloomberg.com AND ticker:APPL

उदाहरण: NASDAQ पर सूचीबद्ध अमेरिकी कंपनियों के बारे में समाचार चाहिए लेकिन क्रिप्टो सामग्री के बिना?

query=country:US exchange:XNAS -crypto

उदाहरण: कमाई के उल्लेख के साथ यूरोपीय तकनीकी कंपनियों (जर्मनी, फ़्रांस या यूके) के समाचार चाहिए?

query=earnings AND (country:DE OR country:FR OR country:GB)

उदाहरण: क्रिप्टो को छोड़कर सभी स्रोतों से सभी टिकरों के समाचार चाहिए?

query=ticker:* source:* -crypto

API टेस्टर में देखें कि यह कैसे काम करता है और आसानी से अपनी जटिल क्वेरीज़ बनाएँ।

Raw WebSocket क्वेरी फ़ील्ड

Raw WebSocket फ़ील्ड-स्तरीय फ़िल्टर के एक उपसमूह का समर्थन करता है, जो इसके सरलीकृत डेटा मॉडल के अनुरूप है। समृद्ध WebSocket और REST API के विपरीत, Raw WebSocket टिकर, एक्सचेंज या कंपनी से संबंधित फ़ील्ड फ़िल्टर का समर्थन नहीं करता।

समर्थित फ़ील्ड

  • source - लेख स्रोत डोमेन के अनुसार फ़िल्टर करें
  • title - लेख शीर्षक सामग्री के अनुसार फ़िल्टर करें
  • summary - लेख सारांश सामग्री के अनुसार फ़िल्टर करें

उदाहरण

शीर्षक सामग्री के अनुसार फ़िल्टर करें:

query=title:Nvidia

शीर्षक और सारांश फ़िल्टर का संयोजन:

query=summary:earnings +title:Tesla

स्रोत के अनुसार फ़िल्टर करें और कीवर्ड को बाहर करें:

query=source:www.reuters.com -crypto

बूलियन ऑपरेटरों के साथ कई फ़ील्ड फ़िल्टर का संयोजन:

query=title:Apple AND summary:revenue

नोट: सभी मानक क्वेरी ऑपरेटर (+, -, AND, OR, NOT, कोष्ठक, दोहरे उद्धरण चिह्न) Raw WebSocket फ़ील्ड फ़िल्टर के साथ काम करते हैं।

मदद चाहिए?

यदि आप अटक जाते हैं, आपके कोई प्रश्न हैं, या आपको कुछ बेहतर किया जा सकता है ऐसा दिखता है, तो बेझिझक संपर्क करें। हम आपसे सुनकर खुश होंगे और finlight.me API के साथ आपकी सफलता का समर्थन करने के लिए यहाँ हैं।