उन्नत फ़िल्टरिंग: finlight API से सटीक क्वेरी

एक व्यापक न्यूज़ फ़ीड शोर है। असली मूल्य उन्हीं कहानियों को ठीक-ठीक पाने में है जिनकी आपको परवाह है। finlight इसके लिए दो तरीके देता है, और वे एक साथ काम करते हैं:

1. आम मामलों के लिए संरचित फ़िल्टर (ticker, देश, श्रेणियाँ, स्रोत, तिथियाँ)।
2. बूलियन लॉजिक और फ़ुल-टेक्स्ट मिलान के लिए query फ़ील्ड में एक क्वेरी भाषा।

यह गाइड POST /v2/articles का उपयोग करते हुए दोनों को कवर करती है। अगर आपने अभी तक पहली कॉल नहीं की है, तो क्विक स्टार्ट गाइड से शुरू करें।

संरचित फ़िल्टर

ये वे पैरामीटर हैं जिन्हें आप सबसे अधिक इस्तेमाल करेंगे:

• tickers — कंपनियाँ, जैसे ["AAPL", "NVDA"]
• countries — ISO 3166-1 alpha-2 कोड, जैसे ["US", "GB"]
• categories — 13 श्रेणियों में से एक या अधिक, जैसे ["markets", "regulation"]
• sources / excludeSources / optInSources — विशिष्ट मीडिया को शामिल करें, बाहर रखें या अतिरिक्त रूप से चुनें
• from / to — तिथि सीमा, YYYY-MM-DD या ISO 8601
• order (ASC / DESC) और orderBy (publishDate, createdAt, revisedDate)

एक सरल संरचित अनुरोध:

curl -X POST https://api.finlight.me/v2/articles \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tickers": ["AAPL", "NVDA"],
    "categories": ["markets"],
    "from": "2026-01-01",
    "pageSize": 50
  }'

क्वेरी भाषा

जब आपको बूलियन लॉजिक या टेक्स्ट मिलान चाहिए, तब query फ़ील्ड का उपयोग करें। यह फ़ील्ड फ़िल्टर, बूलियन ऑपरेटर, समूहन, सटीक वाक्यांश और वाइल्डकार्ड का समर्थन करता है।

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

ऑपरेटर

• शर्तों को जोड़ने के लिए AND / OR / NOT।
• समूहन के लिए कोष्ठक ( ), जैसे (ticker:AAPL OR ticker:NVDA)।
• सटीक वाक्यांश के लिए उद्धरण चिह्न " ", जैसे "interest rates"।
• वाइल्डकार्ड * जो ticker, source और exchange पर लगते हैं, जैसे ticker:BRK*।
• किसी शर्त को अनिवार्य करने या बाहर रखने के लिए + / -, जैसे +ticker:AAPL -category:crypto।

सब मिलाकर

Apple या Nvidia के बारे में earnings कहानियाँ खोजें, पर किसी विशिष्ट स्रोत से नहीं:

(ticker:AAPL OR ticker:NVDA) AND "earnings" AND NOT source:www.example.com

संरचित फ़िल्टर और क्वेरी स्ट्रिंग को आपस में जोड़ा जाता है (AND के साथ), इसलिए आप इन्हें मिला सकते हैं। उदाहरण के लिए, बूलियन लॉजिक के लिए query भेजें और संरचित फ़िल्टर के रूप में categories / from:

// TypeScript
import { FinlightApi } from 'finlight-client';

const client = new FinlightApi({ apiKey: 'YOUR_API_KEY' });

const response = await client.articles.fetchArticles({
  query: '(ticker:AAPL OR ticker:NVDA) AND "earnings"',
  categories: ['markets'],
  from: '2026-01-01',
  pageSize: 50,
});

# Python
from finlight_client import FinlightApi, ApiConfig
from finlight_client.models import GetArticlesParams

client = FinlightApi(config=ApiConfig(api_key="YOUR_API_KEY"))

params = GetArticlesParams(
    query='(ticker:AAPL OR ticker:NVDA) AND "earnings"',
    categories=["markets"],
    from_="2026-01-01",
    pageSize=50,
)
response = client.articles.fetch_articles(params)

पेजिनेशन और गहरा इतिहास

परिणामों के बीच पेज करने के लिए page और pageSize (प्रति पेज अधिकतम 100) का उपयोग करें। जानने योग्य एक नियम है: ऑफ़सेट (page * pageSize) की सीमा 10,000 है। इतिहास में और गहरे जाने के लिए page को लगातार बढ़ाते मत रहें, बल्कि from और to से विंडो को संकीर्ण करें और प्रत्येक विंडो के भीतर पेज करें। इससे क्वेरियाँ तेज़ बनी रहती हैं और आप किसी भी अवधि के इतिहास से गुज़र सकते हैं।

आगे कहाँ जाएँ

• Ticker और एक्सचेंज सही तरीके से — डुअल-लिस्टेड कंपनियों के लिए सटीक फ़िल्टर करें।
• देश और श्रेणी के अनुसार वैश्विक समाचार।
• पूरा दस्तावेज़ीकरण।

अपनी मुफ़्त API key पाएँ →