finlight Logo

Friday, June 26, 2026

finlight फाइनेंशियल न्यूज़ API के साथ शुरुआत करें

Finlight - Content Manager
Tutorial

finlight फाइनेंशियल न्यूज़ API के साथ शुरुआत करें

रियल-टाइम फाइनेंशियल न्यूज़ अक्सर अव्यवस्थित होती है। दर्जनों स्रोत, अलग-अलग फ़ॉर्मेट, कोई संरचना नहीं, और कोई सिग्नल नहीं। finlight इस सूचना के सैलाब को साफ़, संरचित और AI से समृद्ध डेटा में बदल देता है, जिसे आप एक ही रिक्वेस्ट में क्वेरी कर सकते हैं, साथ ही सेंटिमेंट और हर खबर से जुड़ी कंपनियों की जानकारी भी।

यह गाइड आपको लगभग पाँच मिनट में शून्य से आपकी पहली API कॉल तक ले जाएगी। अंत तक आप किसी स्टॉक की ताज़ा खबरें खींच चुके होंगे, रिस्पॉन्स पढ़ चुके होंगे, और देख चुके होंगे कि रियल-टाइम स्ट्रीम कैसे चालू करनी है।

आपको क्या मिलता है

finlight एक फाइनेंशियल न्यूज़ API है, जो उसी समृद्ध डेटा को पाने के चार तरीके देता है:

  • REST. माँग के अनुसार न्यूज़ क्वेरी करें (यही गाइड)।
  • WebSocket. लेख प्रकाशित होते ही उन्हें रियल-टाइम में स्ट्रीम करें।
  • Webhooks. न्यूज़ को अपने एंडपॉइंट पर पुश करवाएँ।
  • MCP सर्वर. किसी AI असिस्टेंट (Claude, ChatGPT) से अपने लिए न्यूज़ क्वेरी करवाएँ।

हर लेख संरचित और समृद्ध रूप में लौटता है, जिसमें शामिल है:

  • सेंटिमेंट (positive, neutral, या negative) और साथ में एक कॉन्फ़िडेंस स्कोर।
  • कंपनी एंटिटी: टिकर, ISIN, एक्सचेंज लिस्टिंग, सेक्टर और इंडस्ट्री।
  • 9 भाषाओं और 13 कैटेगरीज़ (markets, economy, crypto, technology, और बहुत कुछ) में कवरेज।

स्टेप 1: अपनी API key प्राप्त करें

  1. app.finlight.me पर एक मुफ़्त अकाउंट बनाएँ।
  2. डैशबोर्ड खोलें और एक API key जनरेट करें।
  3. इसे कहीं सुरक्षित रखें। आप इसे हर रिक्वेस्ट में X-API-KEY हेडर में भेजेंगे।

free प्लान केवल REST के लिए है और टेस्टिंग के लिए बढ़िया है। मौजूदा सीमाओं और हर प्लान में क्या अनलॉक होता है, यह देखने के लिए finlight.me/pricing देखें।

स्टेप 2: क्लाइंट इंस्टॉल करें (वैकल्पिक)

आप API को सादे HTTP से कॉल कर सकते हैं, लेकिन ऑफ़िशियल SDK आपके लिए ऑथ, रिट्राई और टाइप्स संभाल लेते हैं।

# TypeScript / Node.js
npm install finlight-client

# Python
pip install finlight-client

रॉ HTTP पसंद है? आगे बढ़ें। नीचे दिया हर उदाहरण cURL संस्करण भी दिखाता है।

स्टेप 3: आपकी पहली रिक्वेस्ट

आइए Apple (AAPL) के बारे में ताज़ा लेख प्राप्त करें। यह POST /v2/articles को tickers फ़िल्टर के साथ कॉल करता है।

# cURL
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
  }'

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

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

const response = await client.articles.fetchArticles({
  tickers: ['AAPL'],
  pageSize: 5,
});

console.log(`Got ${response.articles.length} articles`);
for (const article of response.articles) {
  console.log(article.publishDate, article.sentiment, article.title);
}

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

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

response = client.articles.fetch_articles(
    GetArticlesParams(tickers=["AAPL"], pageSize=5)
)

print(f"Got {len(response.articles)} articles")
for article in response.articles:
    print(article.publishDate, article.sentiment, article.title)

स्टेप 4: रिस्पॉन्स पढ़ें

रिस्पॉन्स एक पेजिनेटेड एनवेलप होता है। हर लेख में उसका स्रोत, हेडलाइन, सारांश और समृद्धि (एनरिचमेंट) शामिल होती है:

{
  "status": "ok",
  "page": 1,
  "pageSize": 5,
  "articles": [
    {
      "link": "https://www.example.com/apple-earnings",
      "title": "Apple beats expectations on services revenue",
      "summary": "Apple reported quarterly results above analyst estimates...",
      "source": "www.example.com",
      "publishDate": "2026-06-18T14:32:00.000Z",
      "language": "en",
      "sentiment": "positive",
      "confidence": "0.93",
      "images": ["https://www.example.com/img/apple.jpg"]
    }
  ]
}

दो फ़्लैग आपको ज़रूरत पड़ने पर अधिक जानकारी माँगने देते हैं:

  • includeContent: true केवल सारांश नहीं, बल्कि स्क्रैप किया गया पूरा लेख टेक्स्ट लौटाता है।
  • includeEntities: true हर लेख के लिए companies ऐरे (टिकर, ISIN, एक्सचेंज लिस्टिंग) लौटाता है।

टिप: हल्के लिस्ट व्यू के लिए includeContent और includeEntities बंद रखें, और इन्हें तभी चालू करें जब आपको विवरण की ज़रूरत हो। इससे रिस्पॉन्स छोटे और तेज़ रहते हैं।

स्टेप 5: रियल-टाइम पर जाएँ (जब आप तैयार हों)

शुरुआत के लिए पोलिंग ठीक है, लेकिन लाइव डैशबोर्ड और ट्रेडिंग सिग्नल के लिए आप चाहेंगे कि न्यूज़ प्रकाशित होते ही पुश हो जाए। यही WebSocket है: वही फ़िल्टर, कोई पोलिंग नहीं।

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

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

client.websocket.connect({ tickers: ['AAPL'] }, (article) => {
  console.log('New article:', article.sentiment, article.title);
});

WebSocket स्ट्रीमिंग paid प्लान में उपलब्ध है। पूरी सेटअप के लिए WebSocket डॉक्स देखें।

अगले कदम

आपने अपनी पहली कॉल कर ली है और डेटा का स्वरूप देख लिया है। यहाँ से:

  • पूरी API डॉक्स पढ़ें — एंडपॉइंट्स, पैरामीटर, और WebSocket तथा webhook गाइड्स के लिए।
  • एडवांस्ड फ़िल्टरिंग सीखें। टिकर, देश, कैटेगरी और एक क्वेरी लैंग्वेज को मिलाकर ठीक वही न्यूज़ पाएँ जो आप चाहते हैं (लेख जल्द आ रहा है)।
  • प्लान्स की तुलना करें जब आप free टियर से आगे बढ़ने के लिए तैयार हों।

सवाल हैं? Discord से जुड़ें या info@finlight.me पर ईमेल करें।

मुफ़्त में बनाना शुरू करें →

Back to blog