आपको एक ऐसा फीचर शिप करना है जो ताजा, अनुभाग-विशिष्ट समाचार खींचता है (उदाहरण के लिए: “Technology → AI” या “World → Middle East”) बिना किसी कस्टम स्क्रैपर बनाने या कई फीड को संभालने के। इस लेख के अंत तक, आप जानेंगे कि अनुभाग के अनुसार विषय समाचार प्राप्त करने के लिए किस एंडपॉइंट को कॉल करना है, देश और भाषा के अनुसार कैसे फ़िल्टर करना है, और इसे अपने ऐप में कॉपी-पेस्ट करने योग्य कर्ल या पायथन स्निपेट का उपयोग करके कैसे वायर करना है।
यह API क्या करती है और यह क्यों उपयोगी है
Zyla API Hub पर रियल-टाइम न्यूज डेटा API संरचित समाचार डेटा प्रदान करता है जिसे आप तीन तरीकों से क्वेरी कर सकते हैं:
- खोज: समाचार लेखों के बीच कीवर्ड-आधारित खोज।
- शीर्ष सुर्खियाँ: देश के अनुसार नवीनतम शीर्ष कहानियाँ (और वैकल्पिक भाषा/सीमा)।
- विषय समाचार अनुभाग द्वारा: किसी विषय (जैसे, प्रौद्योगिकी) या प्रकाशन (जैसे, CNN, BBC) के एक विशिष्ट अनुभाग के भीतर लेख।
ये एंडपॉइंट सामान्यीकृत फ़ील्ड लौटाते हैं जैसे शीर्षक, लिंक, स्निपेट, मीडिया यूआरएल, लेखक, स्रोत विवरण, और एक UTC टाइमस्टैम्प। सामान्य उपयोग के मामलों में व्यक्तिगत समाचार विजेट, संपादकीय डैशबोर्ड, स्वचालित अलर्ट, या सामग्री अनुशंसा प्रणालियों के लिए समृद्धि शामिल हैं।
यदि आप Zyla में नए हैं, तो यह एक API मार्केटप्लेस है जिसमें 10,000 से अधिक सार्वजनिक APIs और प्रमाणित करने और सदस्यता लेने का एक मानकीकृत तरीका है। आप Zyla API Hub पर सीधे श्रेणियों और प्रदाताओं का अन्वेषण कर सकते हैं, फिर आप जिस सूची की सदस्यता लेते हैं, उसमें वही API कुंजी प्लग करें।
Zyla API Hub पर शुरुआत करना
रियल-टाइम न्यूज डेटा API पृष्ठ खोलें और एक परीक्षण शुरू करें। Zyla एक सदस्यता + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। आपके पहले API के लिए, आप 7-दिन का परीक्षण या 50 अनुरोध शुरू कर सकते हैं। कोई मुफ्त योजना नहीं है। सदस्यता लेने के बाद, आपको इस API के एंडपॉइंट्स में उपयोग करने के लिए एक API कुंजी प्राप्त होगी।
- सूची पर जाएं: रियल-टाइम न्यूज डेटा API पर 7-दिन का परीक्षण शुरू करें
- सदस्यता लें (या यदि उपलब्ध हो तो मुफ्त परीक्षण शुरू करें) और अपनी API कुंजी प्राप्त करें।
- हर अनुरोध में Authorization: Bearer YOUR_API_KEY का उपयोग करें।
बाद में अन्य डेटा सेट का मूल्यांकन करने की आवश्यकता है? आप उसी खाते और मानक प्रमाणीकरण के साथ zylalabs.com पर अधिक सूचियों को ब्राउज़ और सदस्यता ले सकते हैं।
आप जिन एंडपॉइंट्स का उपयोग करेंगे
1) विषय समाचार अनुभाग द्वारा
इसका उपयोग किसी विषय (जैसे “World, Sports, Technology”) या प्रकाशन (जैसे CNN, BBC) के एक विशिष्ट अनुभाग के भीतर लेख प्राप्त करने के लिए करें। यह “API for topic news by section” को लागू करने का सबसे सीधा तरीका है।
- विधि: GET
- यूआरएल: https://zylalabs.com/api/7339/real-time-news-data-api/11656/topic-news-by-section
- विवरण: किसी विषय (World, Sports, Technology, आदि) या प्रकाशन (CNN, BBC, आदि) के एक विशिष्ट अनुभाग में समाचार लेख प्राप्त करें।
- अनुरोध पैरामीटर:
- topic (string, आवश्यक): उदाहरण के लिए, TECHNOLOGY
- section (string, आवश्यक): अपारदर्शी अनुभाग पहचानकर्ता
- limit (number, वैकल्पिक): उदाहरण के लिए, 500
- country (string, वैकल्पिक): उदाहरण के लिए, US
- language (string, वैकल्पिक): उदाहरण के लिए, en
उदाहरण कर्ल (कॉपी-पेस्ट करें और YOUR_API_KEY को बदलें):
curl -s -X GET "https://zylalabs.com/api/7339/real-time-news-data-api/11653/search?query=Elon+Musk"
-H "Authorization: Bearer YOUR_API_KEY"
नोट्स:
- published_datetime_utc मान ISO-8601 टाइमस्टैम्प UTC में हैं।
- यदि आपको स्थानीयकृत अनुभागों की आवश्यकता है या परिणामों को संकीर्ण करना चाहते हैं तो देश और भाषा द्वारा फ़िल्टर करें।
- अनुभाग पैरामीटर एक आवश्यक अपारदर्शी पहचानकर्ता है। उस मान का उपयोग करें जिसे आप चुने हुए विषय या प्रकाशन के लिए लक्षित करना चाहते हैं।
2) खोज
खोज शब्द द्वारा लेख खोजें। यह आपके अनुभाग-आधारित फीड को मान्य करने या कीवर्ड-मैच सामग्री के साथ अंतराल भरने के लिए उपयोगी है।
- विधि: GET
- यूआरएल: https://zylalabs.com/api/7339/real-time-news-data-api/11653/search
- विवरण: क्वेरी द्वारा समाचार लेखों की खोज करें जिसमें परिणामों को एक विशिष्ट समय सीमा तक सीमित करने का विकल्प हो।
- अनुरोध पैरामीटर:
- query (string, आवश्यक): उदाहरण के लिए, Elon Musk
आधिकारिक उदाहरण कर्ल (इसे ठीक इसी तरह कॉपी-पेस्ट करें):
आधिकारिक प्रतिक्रिया उदाहरण (फील्ड जिन्हें आप पार्स कर सकते हैं जैसे शीर्षक, लिंक, published_datetime_utc, लेखक, source_name):
{
"status": "OK",
"request_id": "1254b56e-7238-4807-9fa7-bd9256c0b66c",
"data": [
{
"title": "How the roots of the ‘PayPal mafia’ extend to apartheid South Africa",
"link": "https://www.theguardian.com/technology/2025/jan/26/elon-musk-peter-thiel-apartheid-south-africa",
"snippet": "Musk is part of the “PayPal mafia” of libertarian billionaires with roots in South Africa under white rule now hugely influential in the US tech ...",
"photo_url": "https://i.guim.co.uk/img/media/01d10e660767815cd5799030b4ff658664343b13/1_0_2998_1800/master/2998.jpg?width=465&dpr=1&s=none&crop=none",
"thumbnail_url": "https://news.google.com/api/attachments/CC8iL0NnNXphbFpzWm10S09YQnVSWGxTVFJDWEFoalJBeWdLTWdrQklKcEdIcWtXWndJ=-w200-h200-p-df-rw",
"published_datetime_utc": "2025-01-26T16:00:00.000Z",
"authors": [
"Chris McGreal"
],
"source_url": "https://www.theguardian.com",
"source_name": "The Guardian",
"source_logo_url": "https://lh3.googleusercontent.com/SU8FywVNtcrG-wgjvZ_0D1-3JR_pN9LNSgjULFH74N748KVyEdkF1jdbvP4Lr7_ClbPZxL-iPw",
"source_favicon_url": "https://encrypted-tbn0.gstatic.com/faviconV2?url=https://www.theguardian.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"source_publication_id": "CAAqBggKMJeqezDfswk",
"related_topics": [
{
"topic_id": "CAAqIggKIhxDQkFTRHdvSkwyMHZNR1ppWm13MUVnSmxiaWdBUAE",
"topic_name": "Chris McGreal"
}
]
},
{
"title": "Bill Gates says he thinks it's 'insane' that Elon Musk is allowed to 'destabilize' politics in other countries",
"link": "https://www.businessinsider.com/gates-its-insane-that-musk-can-destabilize-foreign-politics-2025-1",
"snippet": "Bill Gates doesn't like how Elon Musk has involved himself in the politics of foreign countries like the UK and Germany.",
"photo_url": "https://i.insider.com/679751e2eb4be2fff9a22f97?width=700",
"thumbnail_url": "https://news.google.com/api/attachments/CC8iI0NnNVpaRXhyYlRkVE9WRXhTbnB3VFJEZ0F4aUFCU2dLTWdB=-w200-h200-p-df-rw",
"published_datetime_utc": "2025-01-27T09:36:00.000Z",
"authors": [
"Kevin Tan"
],
"source_url": "https://www.businessinsider.com",
"source_name": "Business Insider",
"source_logo_url": "https://lh3.googleusercontent.com/MD0yHuvt1mX8YyHUcdTCsQqMKGubFCwbWmpxzkT1xnE5wZ4aDRmb2zvkgfgG_b0mHNhaSxqO2A",
"source_favicon_url": "https://encrypted-tbn3.gstatic.com/faviconV2?url=https://www.businessinsider.com&c…
फील्ड नोट्स जिनका आप संभवतः उपयोग करेंगे:
- title, link, snippet: कार्ड या पूर्वावलोकन को रेंडर करने के लिए।
- photo_url, thumbnail_url: उपलब्ध होने पर छवि संपत्तियाँ।
- published_datetime_utc: ISO-8601 UTC टाइमस्टैम्प जिसे आप स्थानीय समय में परिवर्तित कर सकते हैं।
- authors, source_name: श्रेय और लेबलिंग।
3) शीर्ष सुर्खियाँ
विभिन्न देशों से नवीनतम सुर्खियाँ जल्दी प्राप्त करें, वैकल्पिक भाषा और सीमा पैरामीटर के साथ।
- विधि: GET
- यूआरएल: https://zylalabs.com/api/7339/real-time-news-data-api/11654/top-headlines
- विवरण: किसी देश के लिए नवीनतम समाचार सुर्खियाँ/शीर्ष कहानियाँ प्राप्त करें।
- अनुरोध पैरामीटर:
- limit (number, वैकल्पिक): उदाहरण के लिए, 500
- country (string, वैकल्पिक): उदाहरण के लिए, US
- lang (string, वैकल्पिक): उदाहरण के लिए, en
उदाहरण कर्ल:
पायथन उदाहरण: अनुभाग द्वारा विषय समाचार प्राप्त करें
यह स्क्रिप्ट विषय समाचार अनुभाग द्वारा एंडपॉइंट को कॉल करती है, फिर आवश्यक फ़ील्ड को प्रिंट करती है। अपने कुंजी के साथ YOUR_API_KEY को बदलें और अपने उपयोग के मामले के लिए topic/section/country/language को समायोजित करें।
import os
import requests
API_KEY = os.getenv("ZylaApiKey", "YOUR_API_KEY")
url = "https://zylalabs.com/api/7339/real-time-news-data-api/11656/topic-news-by-section"
params = {
"topic": "TECHNOLOGY",
"section": "CAQiSkNCQVNNUW9JTDIwdk1EZGpNWFlTQldWdUxVZENHZ0pKVENJT0NBUWFDZ29JTDIwdk1ETnliSFFxQ2hJSUwyMHZNRE55YkhRb0FBKi4IACoqCAoiJENCQVNGUW9JTDIwdk1EZGpNWFlTQldWdUxVZENHZ0pKVENnQVABUAE",
"limit": 50,
"country": "US",
"language": "en",
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
if data.get("status") == "OK":
for item in data.get("data", []):
title = item.get("title")
link = item.get("link")
published = item.get("published_datetime_utc")
source = item.get("source_name")
print(f"[{published}] {title} — {source} :: {link}")
else:
print("Non-OK status:", data)
कार्यान्वयन टिप्स:
- जब उपयोगकर्ता बार-बार रिफ्रेश करते हैं तो अनावश्यक फ़ेचिंग से बचने के लिए अपने UI आवश्यकताओं के आधार पर प्रतिक्रियाओं को एक छोटे विंडो के लिए कैश करें।
- सदस्यता + कोटा मॉडल का सम्मान करें; हर पृष्ठ दृश्य पर अनावश्यक पोलिंग से बचें। आवश्यकतानुसार सर्वर-साइड पर फैला दें।
- टाइमस्टैम्प UTC में हैं; क्लाइंट पर बार-बार टाइमज़ोन लॉजिक को रोकने के लिए अपने API/service लेयर में एक बार परिवर्तित करें।
व्यावहारिक उपयोग के मामले जिन्हें आप इस सप्ताह लागू कर सकते हैं
- विषय लैंडिंग पृष्ठ: अनुभागों को स्थानीयकरण के लिए देश/भाषा फ़िल्टर के साथ विषय समाचार अनुभाग द्वारा एंडपॉइंट से चलाएं जैसे “Technology → AI” या “Sports → Soccer”।
- संपादकीय बैकफिल: जब किसी अनुभाग में अपेक्षित से कम कहानियाँ होती हैं, तो विशिष्ट कीवर्ड के लिए खोज चलाएं और परिणामों को फीड में मर्ज करें।
- बाजार/उद्योग मॉनिटर: निवेशक डैशबोर्ड को शक्ति देने के लिए प्रौद्योगिकी अनुभाग लेखों को नामित कंपनियों के लिए खोज के साथ मिलाएं।
- अलर्ट/सूचनाएँ: अपने उपयोगकर्ताओं के लिए प्रासंगिक अनुभागों को पोल करें और नए लेखों के प्रकट होने पर अपडेट भेजें (अपने अंतिम देखे गए सेट से लिंक या शीर्षक की तुलना करें)।
AI एजेंट (MCP) से API कॉल करना
आप Zyla APIs को MCP-संगत क्लाइंट (जैसे, Claude Code, Cursor, Windsurf) के माध्यम से MCP एंडपॉइंट का उपयोग करके भी कॉल कर सकते हैं। अपने एजेंट या उपकरण को इस पर इंगित करें:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
वहां से, ऊपर दिखाए गए Authorization हेडर के साथ वही HTTP GET अनुरोध करें। MCP परिवहन के बारे में अधिक जानकारी के लिए देखें MCP.
समय बचाने वाले संचालन विवरण
- प्रमाणन: हर अनुरोध के लिए HTTP हेडर Authorization: Bearer YOUR_API_KEY का उपयोग करें।
- टाइमस्टैम्प: published_datetime_utc UTC (ISO-8601) में है। अपने पाइपलाइन में जल्दी सामान्यीकृत करें।
- फ़िल्टरिंग: विषय समाचार अनुभाग द्वारा, विषय और अनुभाग आवश्यक हैं। देश और भाषा वैकल्पिक सुधार हैं; पेलोड आकार को सीमित करने के लिए सीमा का उपयोग करें।
- कोटा: Zyla बिलिंग सदस्यता + कोटा है। पहले API के लिए, आप 7-दिन का परीक्षण या 50 अनुरोध शुरू कर सकते हैं। परीक्षण के बाद वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
- डेटा मॉडल: लेख वस्तुओं में source_name, source_url, और लेखक सूचियाँ शामिल होती हैं ताकि आपके UI में उचित श्रेय का समर्थन किया जा सके।
फीचर शिप करने के लिए एंड-टू-एंड फ्लो
- रियल-टाइम न्यूज डेटा API का परीक्षण शुरू करें और अपनी API कुंजी प्राप्त करें: रियल-टाइम न्यूज डेटा API पर 7-दिन का परीक्षण शुरू करें.
- विषय और अनुभाग पहचानकर्ता चुनें जिसे आप शक्ति देना चाहते हैं (जैसे, TECHNOLOGY + आवश्यक अनुभाग मान)।
- Authorization: Bearer YOUR_API_KEY के साथ सर्वर-साइड पर विषय समाचार अनुभाग द्वारा एंडपॉइंट को कॉल करें।
- शीर्षक, लिंक, स्निपेट, photo_url/thumbnail_url, और source_name को रेंडर करें। published_datetime_utc को अपने उपयोगकर्ताओं के समय क्षेत्र में परिवर्तित करें।
- रिफ्रेश पर अनावश्यक कॉल को समाप्त करने के लिए अपनी तरफ एक हल्का कैश या ETag-समान जोड़ें।
- वैकल्पिक रूप से, खोज में परत करें ताकि अंतराल भर सकें या कीवर्ड द्वारा ड्रिलडाउन बना सकें।
अक्सर पूछे जाने वाले प्रश्न
मैं प्रमाणीकरण कैसे करूँ?
हर अनुरोध में हेडर Authorization: Bearer YOUR_API_KEY शामिल करें।
कौन सा एंडपॉइंट अनुभाग द्वारा विषय समाचार लौटाता है?
GET https://zylalabs.com/api/7339/real-time-news-data-api/11656/topic-news-by-section आवश्यक विषय और अनुभाग पैरामीटर के साथ। वैकल्पिक पैरामीटर में सीमा, देश, और भाषा शामिल हैं।
प्रकाशन तिथियाँ किस समय क्षेत्र में हैं?
published_datetime_utc UTC (ISO-8601) में प्रदान किया गया है। इसे अपने क्लाइंट या सर्वर लेयर में आवश्यकतानुसार परिवर्तित करें।
क्या मैं देश के अनुसार सामान्य शीर्षक भी प्राप्त कर सकता हूँ?
हाँ। GET https://zylalabs.com/api/7339/real-time-news-data-api/11654/top-headlines का उपयोग करें जिसमें वैकल्पिक सीमा, देश, और lang पैरामीटर हों।
मैं इसे AI कोड सहायक या एजेंट से कैसे कॉल करूँ?
MCP-संगत क्लाइंट में https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY पर MCP परिवहन का उपयोग करें, फिर Authorization हेडर के साथ वही GET अनुरोध करें। देखें MCP.
क्या आप आज अनुभाग-आधारित समाचार लागू करने के लिए तैयार हैं? अपना परीक्षण शुरू करें, अपनी कुंजी प्राप्त करें, और यहां विषय समाचार अनुभाग द्वारा एंडपॉइंट में प्लग करें: रियल-टाइम न्यूज डेटा API पर 7-दिन का परीक्षण शुरू करें.