Free News API: 21 मिलियन लेखों, 25,000 प्रकाशकों और 100 देशों पर फुल-टेक्स्ट सर्च — बिना किसी कुंजी के

समाचार API आमतौर पर अनुरोध के आधार पर बेचे जाते हैं, एक कुंजी के पीछे गेट किए जाते हैं, और फ्री टियर पर प्रतिदिन सौ कॉल्स तक सीमित होते हैं। Free News API इनमें से कोई भी नहीं है: 90-दिवसीय रोलिंग विंडो में 21.5 मिलियन लेख, 25,000+ प्रकाशक, कोई कुंजी नहीं, कोई साइनअप नहीं, कोई क्वाटा नहीं, वाणिज्यिक उपयोग की अनुमति है। यहाँ संपूर्ण सतह है — सर्च, आँकड़े, ट्रेंड, बाज़ार, फ़ीड्स और MCP — और यह सच्चाई की खातिर कि डेटा कहाँ गलत हो सकता है।

समस्या का स्वरूप

एक AI एजेंट से पूछें कि दुनिया अभी किस बारे में लिख रही है, और उसके पास तीन बुरे विकल्प हैं। यह सीधे प्रकाशकों से स्क्रैप कर सकता है, जो नाज़ुक, धीमा और कानूनी रूप से अस्पष्ट है। यह एक वाणिज्यिक समाचार API को कॉल कर सकता है, जिसका मतलब है एक खाता, एक कुंजी, मासिक बिल और — बाज़ार में हर फ्री टियर पर — प्रतिदिन सौ अनुरोध और लेखों में चौबीस घंटे की देरी। या यह ट्रेनिंग डेटा से अनुमान लगा सकता है जो महीनों पहले रुक गया था।

Free News API मध्यम विकल्प की लागत और कागज़ात हटा देता है, बिना उसकी क्षमता को हटाए। एक GET अनुरोध, कोई क्रेडेंशियल नहीं, एक ऐसे कोरपस पर जिसमें लेखन के समय 21,557,044 लेख हैं, पच्चीस हज़ार से अधिक प्रकाशकों द्वारा, 90-दिवसीय रोलिंग विंडो पर रखे गए और लगातार अपडेट किए जाते हुए — इंडेक्स में सबसे नया लेख आमतौर पर दो मिनट से भी कम पुराना होता है।

चार मुख्य एंडपॉइंट, और फिर भी कुछ

सेवा का कोर चार GET एंडपॉइंट्स हैं, सभी https://freenewsapi.ai के तहत, सभी UTF-8 JSON लौटाते हैं Access-Control-Allow-Origin: * के साथ ताकि ब्राउज़र कोड उन्हें सीधे कॉल कर सके, और सभी सर्वर-साइड समय took_ms में रिपोर्ट करते हैं।

उस मुख्य कोर के चारों ओर चार और परिवार स्थित हैं, जिनमें से प्रत्येक कहीं और एक अलग उत्पाद होता: ट्रेंड्स (देश के अनुसार लाइव स्टोरी क्लस्टरिंग), मार्केट्स (कवरेज की मात्रा के साथ संरेखित मूल्य श्रृंखलाएं), क्रिप्टो सेंटिमेंट (बिटकॉइन ब्लॉक के सात एंडपॉइंट्स), और सिंडिकेशन (वही खोज RSS, Atom या JSON फ़ीड के रूप में प्रस्तुत की गई है)। इन सभी का विस्तृत विवरण नीचे दिया गया है।

curl "https://freenewsapi.ai/v1/search?q=climate+summit&size=2"

{
  "took_ms": 41,
  "total": 1284,
  "total_is_lower_bound": false,
  "size": 2,
  "offset": 0,
  "results": [
    {
      "id": "9c1f8a4b2d3e5f6071829304a5b6c7d8",
      "url": "https://example-news.com/world/climate-summit-opens",
      "title": "Climate summit opens with a call for binding targets",
      "description": "Delegates from 190 countries gathered on Monday ...",
      "published_at": "2026-08-17T09:12:00Z",
      "crawled_at": "2026-08-17T10:48:31Z",
      "host": "example-news.com",
      "sitename": "Example News",
      "country": "GB",
      "country_source": "cctld",
      "lang": "en",
      "tld": "com"
    }
  ]
}

उस प्रतिक्रिया में तीन फ़ील्ड हैं जिन्हें तुरंत ध्यान देना चाहिए, क्योंकि वे पूरे डेटासेट की ईमानदारी को एन्कोड करती हैं। total_is_lower_bound आपको बताता है कि मेल (match) की संख्या 10,000 की छत तक पहुंच गई थी और गिनती बंद कर दी गई थी। country_source बताता है कि देश को कैसे निर्धारित किया गया — क्योंकि किसी भी समाचार डेटासेट में देश के मानों का एक बड़ा हिस्सा निष्कर्ष (inferences) होते हैं, तथ्य नहीं। और crawled_at एक विश्वसनीय टाइमस्टैम्प है: प्रकाशक published_at को नियमित रूप से पीछे की तारीख देते हैं, लेकिन क्रॉल समय पाइपलाइन द्वारा सौंपा जाता है और केवल आगे की ओर ही बढ़ता है।

खोज: हर वह पैरामीटर जो मायने रखता है

सभी पैरामीटर वैकल्पिक हैं। एक साधारण कॉल इंडेक्स में सबसे नए आलेख लौटाती है।

क्वेरी

• q शीर्षक (वजन 3), विवरण (वजन 2) और आलेख के शरीर के साथ मेल खाती है। AND सेमैंटिक्स — हर शब्द का मौजूद होना अनिवार्य है, इसलिए एक शब्द जोड़ने से परिणाम चौड़े होने के बजाय संकीर्ण (narrow) हो जाते हैं। अधिकतम 500 वर्ण।

फ़िल्टर

फ़िल्टर पैरामीटर के बीच AND और एक ही पैरामीटर के भीतर OR के साथ जुड़ते हैं। इसलिए country=DE,AT&lang=de का अर्थ है "जर्मनी या ऑस्ट्रिया से जर्मन भाषा के आलेख"। प्रत्येक 50 मानों की एक अल्पविराम-पृथकित सूली स्वीकार करता है।

आउटपुट नियंत्रण

curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=date&size=10"

curl "https://freenewsapi.ai/v1/search?q=merger&country=DE&date=48h&sort=date&size=20"

खोज से पहले गिनती

सर्विस में सबसे कम उपयोग किया जाने वाला एंडपॉइंट /v1/stats है। अक्सर उपयोगी सवाल यह नहीं होता कि "लेख क्या हैं" बल्कि यह होता है कि "क्या यहाँ कुछ भी मौजूद है, और वह कहाँ है"। गिनती इसका उत्तर बहुत कम लागत पर देती है — लगभग दो सौ टोकन, जबकि परिणामों के एक पृष्ठ के लिए कई हजार टोकन की आवश्यकता होती है — जिससे यह एजेंट के लिए यह निर्णय लेने की सही पहली कॉल बन जाता है कि खोज चलाना मूल्यवान है या नहीं।

curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"

यह देश, भाषा, TLD, प्रकाशक और दिन के आधार पर गिनती लौटाता है, जो पूरे मिलते-जुलते सेट पर गणना किया जाता है, वर्तमान पृष्ठ पर नहीं। यह भी वही तरीका है जिससे आप इसे भरोसा करने से पहले कवरेज को मापते हैं। लेखन के समय का अनफ़िल्टर्ड स्नैपशॉट:

शीर्ष देश

प्रमुख भाषाएँ

अंग्रेज़ी 5,513,650 · स्पैनिश 2,699,457 · रूसी 1,785,796 · तुर्की 1,501,004 · इतालवी 992,200 · जर्मन 733,677 · फ़्रेंच 689,136 · अरबी 664,016 · पुर्तगाली 637,607 · हिंदी 560,840 · ग्रीक 466,504 · जापानी 427,085 · वियतनामी 385,719 · रोमानियाई 358,766 · चीनी 352,720 · यूक्रेनी 345,809 · कोरियाई 335,079 · फ़ारसी 268,126 · पोलिश 238,904 · बल्गेरियाई 183,204.

यह वितरण एक पल के लिए ध्यान देने योग्य है, क्योंकि यह अधिकांश समाचार APIों द्वारा प्रदान किए जाने वाले दृष्टिकोण के विपरीत है। सामान्य अंग्रेज़ी-प्रधान, अमेरिका-प्रधान पाठ समूह यहाँ मौजूद नहीं है: भारत संयुक्त राज्य अमेरिका से आगे है, तुर्की जर्मन से आगे है, और ग्रीक, वियतनामी, फ़ारसी और बल्गेरियाई भाषाओं में भी लाखों की संख्या में प्रतिनिधित्व है। यदि आपका प्रश्न अंग्रेज़ी-अन्य प्रेस के बारे में है, तो यह एक मौलिक रूप से भिन्न डेटासेट है।

आयतन

by_day में दैनिक वक्र पूरे नब्बे दिनों के विंडो को कवर करता है। हाल के दिनों में दैनिक आयतन लगभग प्रतिदिन 400,000 से 700,000 आर्टिकल्स की सीमा में था; विंडो के शुरुआती हिस्से में, जब RSS परत को आर्काइव इनजेस्ट के साथ जोड़ा गया था, तो दैनिक आयतन 130,000–230,000 के बीच था। दोनों ही आंकड़े एक ही प्रतिक्रिया में दिखाई देते हैं, जो कि मुख्य बात है — सेवा आपको मार्केटिंग औसत का हवाला देने के बजाय अपनी खुद की वृद्धि प्रक्रिया दिखाती है।

प्रवृत्तियाँ: प्रेस वास्तव में अभी क्या कवर कर रहा है

खोज "X के बारे में क्या लिखा गया" का जवाब देती है। प्रवृत्तियाँ एक भिन्न और अक्सर बेहतर सवाल का जवाब देती हैं: "क्या हो रहा है" — बिना किसी X के।

एक रोबोट आर्टिकल्स को देश के हिसाब से कहानियों में समूहित करता है और उन्हें अपडेट रखता है। हर पांच मिनट में नए आर्टिकल्स उनकी पहचान शब्दों के आधार पर ज्ञात कहानियों से जुड़े जाते हैं, बिना किसी मॉडल कॉल के; हर कुछ घंटों में एक देश पूरी तरह से एक चक्र से गुजरता है जहाँ एक भाषा मॉडल हेडलाइन्स पढ़ता है और कहानियों का नाम शून्य से बनाता है। लेखन के समय, प्रवृत्ति परत 115 देशों को कवर करती है, जिन्हें पिछले कुछ मिनटों के भीतर फिर से गणना किया गया है।

curl "https://freenewsapi.ai/v1/trends?country=US&window=24h&size=5"

{
  "window": "24h",
  "filters": { "country": ["US"], "min_publishers": 1 },
  "trends": [
    {
      "title": "Hurricane Marie threatens Labor Day weather",
      "slug": "hurricane-marie-threatens-labor-day-weather",
      "country": "US",
      "category": "weather",
      "articles": 57,
      "publishers": 24,
      "first_seen": "2026-09-05T19:24:36Z",
      "latest": "2026-09-06T19:00:04Z",
      "url": "https://freenewsapi.ai/trends/us/hurricane-marie-…",
      "headlines": [ … ]
    }
  ]
}

प्रत्येक कहानी के साथ दो गणनाएँ आती हैं और उनका अर्थ अलग-अलग होता है। articles (आर्टिकल्स) तेज़ी को दर्शाता है; publishers (प्रकाशक) विस्तार को दर्शाता है। 4 मीडिया हाउसों से 200 आर्टिकल्स वाली एक कहानी किसी एक समाचार पत्र की जुनून है। 40 मीडिया हाउसों से 60 आर्टिकल्स वाली एक कहानी एक घटना है। डिफ़ॉल्ट सॉर्ट प्रकाशकों के आधार पर की जाती है, और min_publishers / min_articles आपको अपनी शर्तें खुद सेट करने की अनुमति देते हैं।

कहानियाँ एक निश्चित समूह से श्रेणी लेती हैं: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.

विंडो पाठक की पसंद है, रोबोट की नहीं

यह एक सच में सुंदर डिज़ाइन निर्णय है। हर लेख को उसकी प्रकाशन समय के साथ संग्रहीत किया जाता है और उसे अपनी कहानी से जोड़ा जाता है, इसलिए कोई भी विंडो — पंद्रह मिनट, एक घंटा, एक दिन, एक विशिष्ट कैलेंडर तिथि — केवल एक ही संग्रहीत डेटा पर एक रेंज क्वेरी है। एक ही गणना एक साथ हर विंडो के लिए काम करती है। window=15m, window=1h, window=24h, date=2026-09-01, या एक स्पष्ट since/until जोड़ी सभी एक ही इंडेक्स पर बिना पुनर्गणना के काम करती हैं।

कीवर्ड: समाचार जिन शब्दों पर बना है

curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"

प्रत्येक कीवर्ड वापस आता है यह बताते हुए कि कितनी अलग-अलग कहानियाँ उसे लेती हैं, उन कहानियों में कितने लेख हैं, और — दिलचस्प बात — कितने राष्ट्रीय प्रेस उसे उपयोग करते हैं। वह आखिरी नंबर वैश्विक घटना और घरेलू घटना के बीच का अंतर है। एक शब्द जो सत्ताईश देशों में प्रकट होता है वह एक विश्व कहानी है; एक शब्द जो एक देश के प्रेस पर हावी होता है वह एक घरेलू कहानी है, चाहे वहाँ वह कितना भी शोर मचा रहा हो।

कौन से देश लाइव हैं

curl "https://freenewsapi.ai/v1/trends/countries"

हर ट्रैक किए गए देश को उसके लाइव कहानी गणना और कितने मिनट पहले इसे पुनर्गणना की गई — यह बताता है — तुर्की, रूस, ईरान, ग्रीस, भारत, इटली, यूक्रेन, रोमानिया, अर्जेंटीना, जर्मनी और ब्राज़ील सभी वर्तमान में हजारों लाइव कहानियाँ लेते हैं, जो पिछले दस मिनटों में पुनर्गणना की गई हैं। और /v1/trends/{cc}/{slug} किसी भी एक कहानी को उसकी पूर्ण लेख सूची के साथ खोलता है।

बाजार बनाम कवरेज: एक अक्ष पर कीमत, दूसरी पर ध्यान

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

curl "https://freenewsapi.ai/v1/markets"

चौदह उपकरणों को चार संपत्ति वर्गों में ट्रैक किया जाता है:

curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"

यह एकमात्र कॉल आपको डॉलर के सापेक्ष लिरा और उसी अवधि में तुर्की प्रेस की कवरेज की मात्रा घंटा-दर-घंटा प्रदान करता है। तुर्की प्रेस इस कोरपस का तीसरा सबसे बड़ा हिस्सा है, जिसके कारण यह जोड़ी शोर के बजाय कुछ अर्थपूर्ण उत्पन्न करती है।

और एक पूर्ण बिटकॉइन भावना ब्लॉक

बिटकॉइन को अपनी सात-बिंदु वाली श्रृंखला मिली है, क्योंकि यह एकमात्र ऐसा उपकरण है जिस पर समाचारों के स्वर और कीमत में होने वाले उतार-चढ़ाव के बारे में लगातार बहस की जाती है, लेकिन इसे कम ही मापा जाता है:

संवेदना लेबल एक भाषा मॉडल से आते हैं जो हर पांच मिनट में ताज़ा क्रिप्टो आर्टिकल्स पर चलता है, एक कैलिब्रेटेड सिक्कों की सूची के विरुद्ध। /v1/btc/correlation और max_shift पैरामीटर के साथ, वह एंडपॉइंट है जिसका उपयोग करें यदि आपने कभी "समाचार ने बाज़ार को हिलाया" वाले दावे को दोहराने के बजाय उसे परखना चाहा हो।

वही खोज, एक फ़ीड के रूप में

तीन और एंडपॉइंट्स समान खोज पैरामीटर लेते हैं और परिणामों को JSON के बजाय सिंडिकेशन फ़ॉर्मेट में प्रस्तुत करते हैं:

• GET /v1/rss — RSS 2.0
• GET /v1/atom — Atom 1.0
• GET /v1/feed.json — JSON फ़ीड 1.1

https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=date

इसका मतलब है कि कोई भी सहेजी गई खोज एक फ़ीड बन जाती है जिसे आप किसी रीडर, n8n नोड, Slack इंटीग्रेशन, Zapier ट्रिगर या एक स्टैटिक साइट जनरेटर में पेस्ट कर सकते हैं — बिना किसी कोड और बिना किसी कुंजी के। यह एक छोटा फीचर है जो गैर-प्रोग्रामरों के लिए एक पूरी इंटीग्रेशन परत को चुपचाप हटा देता है।

MCP: अठारह उपकरण, दो परतें

MCP सर्वर एक URL पर रहता है, Streamable HTTP (JSON-RPC 2.0, POST के माध्यम से, प्रोटोकॉल संस्करण 2025-06-18) बोलता है, बैचिंग का समर्थन करता है, और — यहाँ हर चीज़ की तरह — इसमें कोई अधिकारता (authorization) चरण और कोई सत्र ID नहीं है।

claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcp

यह दो जानबूझकर बनाई गई परतों में 28 उपकरण प्रकट करता है।

परत एक: छह शॉर्टकट्स जो एक ही कॉल में एक पूरा सवाल का जवाब देते हैं

परत दो: हर एंडपॉइंट, जो स्वयं सेवा से जनरेट किया गया है

शॉर्टकट्स के नीचे, प्रत्येक रॉ एंडपॉइंट को एक अलग टूल के रूप में उजागर किया गया है जिसमें API द्वारा स्वीकार किए जाने वाले प्रत्येक पैरामीटर हैं — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, पूरा news_get_btc_* परिवार, फ़ीड रेंडरर्स, और news_get_health। ये लाइव सेवा से जनरेट किए गए हैं, इसलिए ये API द्वारा वास्तव में स्वीकार किए जाने वाले डेटा से विचलित नहीं हो सकते।

लूप को पूरा करने वाले दो मेटा-टूल्स हैं: news_list_endpoints उस सबका कैटलॉग लौटाता है जो मौजूद है, और news_get किसी भी पाथ पर एक रॉ GET करता है — ताकि एक एजेंट जिसके टूल लिस्ट में कवर न किया गया हो, फिर भी किसी एंडपॉइंट तक पहुँच सके।

curl "https://freenewsapi.ai/mcp?format=json"

एक GET, कोई हैंडशेक नहीं, और आपके पास पूरी मशीन-पठनीय कैटलॉग है: सर्वर, ट्रांसपोर्ट, प्रोटोकॉल, टूल की संख्या, प्रत्येक टूल की विवरण सहित, और प्रत्येक एंडपॉइंट की पैरामीटर सूची।

मशीनों द्वारा पढ़ने के लिए बनाया गया

दस्तावेज़ीकरण API पर बाद में जोड़ा गया कोई अतिरिक्त हिस्सा नहीं है — यह इसका एक प्रथम-श्रेणी (first-class) आउटपुट है। साइट 665 स्थिर पेज शिप करती है, और उनमें से कई विशेष रूप से इसलिए मौजूद हैं ताकि एक मॉडल को HTML कभी पढ़ने की ज़रूरत न पड़े:

• /openapi.json पूरा OpenAPI स्कीमा।
• /llms.txt एक संक्षिप्त ओरिएंटेशन फ़ाइल — सेवा क्या है, एंडपॉइंट्स, अच्छी तरह से क्वेरी कैसे करें, और त्रुटियाँ।
• /llms-full.txt संपूर्ण दस्तावेज़ीकरण एक ही सादे पात्र फ़ाइल के रूप में, जिसका आकार सौ किलोबाइट से भी अधिक है, ताकि एक एजेंट पूरा मैनुअल एक ही फ़ेच में इन्हेस्ट कर सके।
• /agents एजेंट बिल्डर्स के लिए समर्पित अट्ठाईस पृष्ठ: तैयार-ओपनएआई फ़ंक्शन परिभाषाएँ, एंट्रोपिक टूल-यूज़ परिभाषाएँ, न्यूज़ रीट्रीवल के लिए सिस्टम प्रॉम्प्ट्स, RAG रेसिपीज़, टोकन-लागत तालिकाएँ, और एजेंट रेसिपीज़।
• /agents/models प्रत्येक मॉडल परिवार के लिए टूल-कॉलिंग कोड — क्वेन, डीपसीक, मिनिमैक्स, किमी, जीएलएम, डबो, हुनियां, एर्नी, ई, स्टेप, जीपीटी, क्लॉड, जेमिनी, ग्रॉक, मिस्ट्रल, लामा, कमांड, नोवा, फ़ी, जम्बा, सॉनार, ओपनरूटर, ओलामा, वीएलएम।
• /data कोरपस के अंदर क्या है, विधि, इंडेक्स स्कीमा, और डेटा क्वालिटी नामक एक पृष्ठ जो दस्तावेज़ करता है कि डेटासेट में क्या गलतियाँ हैं।
• /sources 11,668 प्रकाशकों का एक ब्राज़ेबल कैटलॉग, जिसकी कटौती देश, भाषा और डोमेन ज़ोन के अनुसार की जा सकती है।
• /compare NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube और FreeNewsAPI.io के साथ साइड-बाय-साइड पृष्ठ।

इसमें 168 देश पृष्ठ, 121 भाषा पृष्ठ और 275 TLD पृष्ठ शामिल हैं — प्रत्येक कोरपस के हिस्से के लिए एक ब्राउज़ करने योग्य सतह, जो यह दिखाती है कि उसमें वास्तव में क्या है।

लेख कहाँ से आते हैं

दो इनगेस्ट पाथ एक ही इंडेक्स को फीड करते हैं, और उनके बीच का अंतर मायने रखता है।

आर्काइव पाथ

हर दस मिनट में एक जॉब Common Crawl के CC-NEWS आर्काइव में नए WARC फ़ाइलों के लिए जाँच करता है और जो कुछ भी वह पहले नहीं देख चुका है, उसे फॉर्टी समानांतर वर्करों का उपयोग करके प्रोसेस करता है। एक्सट्रैक्टर रॉ क्रॉल से प्रत्येक आर्टिकल को फ़ील्ड के लिए दस्तावेज़ित कैस्केड का उपयोग करके बाहर निकालता है — और कैस्केड को मान्यताओं के बजाय वास्तविक डेटा के खिलाफ मापा गया था:

वह देश-संबंधी आँकड़ा ईमानदार है, और यही कारण है कि country_source हर आलेख पर उजागर किया गया है: लगभग एक-पंचाई रिकॉर्ड में कोई भरोसेमंद देश संकेत ही नहीं है, और मौजूद मानों में से लगभग एक-तिहाई तथ्यों के बजाय अनुमान हैं। API आपको बताता है कि कौन-सा कौन-सा है, बजाय यह दिखाने के कि सब कुछ सटीक है।

लाइव पाथ

एक दूसरा रोबोट प्रकाशक RSS के फ़ीड्स को पाँच मिनट के अंतराल पर पोल करता है, शर्तों वाले अनुरोधों के साथ एक चक्र में — एक फ़ीड जो 304 Not Modified उत्तर देता है, उसकी लागत लगभग शून्य होती है, और प्रत्येक फ़ीड के पोलिंग अंतराल को इस बात के अनुसार समायोजित किया गया है कि वह वास्तव में कितनी बार प्रकाशित करता है। एक आउटलेट जो दिन में पाँच कहानियाँ पोस्ट करता है, हर पंद्रह मिनट में ज़बरदस्त लोड नहीं झेलता।

यह केवल उही लेता है जो प्रकाशक ने फ़ीड में डाला है: शीर्षक, सारांश, और पूर्ण पाठ जब फ़ीड उसे धारण करता है। यह प्रकाशक की वेबसाइट पर नहीं जाता अधिक डेटा लाने के लिए। यह एक जानबूझकर बनाया गया सीमांकन है, और यही कारण है कि सेवा अपने प्रकाशक-मुखी कानूनी पृष्ठ पर जो वादे करती है, उन्हें वह पूरा कर सकती है।

और उनके आसपास की मशीनरी

दो इनजेस्ट पाथ्स के चारों ओर एक दर्जन से अधिक रोबोट शेड्यूल पर बैठे हैं: स्रोत खोज और सिंक, डोमेन-वार देश निर्धारण, रुझान निर्माण और ऑडिट, कीवर्ड बैकफिल, क्रिप्टो भावना, बाज़ार डेटा खींचना, एक टैक्सोनॉमी कैटलॉग, रिटेंशन (नब्बे-दिन की विंडो published_at पर एक रात्रि क्वेरी द्वारा लागू की जाती है, न कि इंडेक्स उम्र द्वारा), दिन की पुष्टि, खाली-आलेख पुनरीक्षण, और एक हेल्थ गार्ड जो कुछ भी जो रुक गया है उसे पुनः शुरू करता है। कॉरपस एक समर्पित Elasticsearch क्लस्टर पर रहता है।

इस डेटासेट में क्या गलत है

सेवा अपनी सीमाओं को प्रकाशित करती है, जो यह निर्णय लेने का सबसे तेज़ तरीका है कि क्या यह आपकी समस्या के लिए उपयुक्त है।

• देश का अनुमान लगाया गया है हर आलेख पर country_source पढ़ें, और strict_country=true जोड़ें जब आप देश के आधार पर गिनती कर रहे हों, न कि ब्राउज़िंग कर रहे हों।
• published_at प्रकाशक द्वारा प्रदान किया गया है बैकडेटिंग आम है। जब आप नए डेटा के लिए पोल कर रहे हों, तो crawled पर सॉर्ट करें।
• total को 10,000 तक सीमित किया गया है गति के लिए। total_is_lower_bound आपको बताता है कि जब आप छत तक पहुँच जाते हैं।
• कोई भावना या एंटिटी एक्सट्रैक्शन नहीं बिटकॉइन ब्लॉक के बाहर, आलेकों में कोई भावना स्कोर और कोई नामित एंटिटी नहीं होती। यह दायरे में नहीं है।
• नब्बे दिन और इससे ज़्यादा नहीं इससे गहरा आर्काइव कोई नहीं है। यदि आपको 2019 की सामग्री चाहिए, तो यह सही उपकरण नहीं है।
• कोई SLA नहीं यह मुफ्त है। इसे निगरानी में रखा गया है और सुरक्षित रखा गया है, लेकिन लिखित रूप में कुछ भी वादा नहीं किया गया है।
• पाठ प्रकाशकों का है प्रत्येक प्रतिक्रिया में मूल URL शामिल होता है, और कॉल करने वालों से उम्मीद की जाती है कि वे उसी की ओर लिंक करेंगे।

इसका सही उपयोग: लागत, पेजिंग और त्रुटियाँ

टोकन अनुशासन

एजेंट के लिए, प्रतिक्रिया का आकार ही वास्तविक लागत है। इसकी दस्तावेज़ित संरचना इस प्रकार है:

full_text=true के साथ बीस आर्टिकल्स लगभग 40,000 टोकन हैं। अनुशंसित पैटर्न हमेशा समान होता है: गिनती करें, स्कैन करें, और फिर उन कम आर्टिकल्स के बॉडी फ़ेच करें जिनकी आपको आवश्यकता है।

छत से परे पेजिंग

offset 9,900 पर रुक जाता है। एक बड़े सेट को टहलने के लिए, छत से लड़ने के बजाय समय के आधार पर विभाजित करें। from/to और sort=date के साथ दिन-दर-दिन, या भीड़भाड़ वाली क्वेरी पर घंटे-दर-घंटे लूप चलाएं। दस्तावेज़ीकरण में एक पूरे दिन को टहलने के लिए एक समर्पित पृष्ठ है।

त्रुटियाँ

संविदा स्पष्ट और कोड करने में आसान है: 4xx का अर्थ है कि अनुरोध गलत है — इसे ठीक करें, दोबारा प्रयास न करें। 5xx का अर्थ है कि सेवा डाउन है — पीछे हटें। 429 का अर्थ है धीमे चलाएं और पुनः प्रयास करें। अज्ञात क्वेरी पैरामीटर को अनदेखा किया जाता है, इसलिए एक फ़ील्ड जोड़ने से मौजूदा कॉलर कभी नहीं टूटेगा।

अपनी पहचान बताएं (वैकल्पिक, और वास्तव में वैकल्पिक)

बिना कुंजी के कॉलर तक पहुँचने का कोई रास्ता नहीं है। सुझाई गई विनम्रता एक हेडर है जो आपके एजेंट, उस फ्रेमवर्क को दर्शाता है जिसके माध्यम से यह चलता है और उस मॉडल को चलाता है:

X-Agent: agent_name=<agent>; software=<langchain|llamaindex|n8n|claude-desktop|cursor|openai-assistants|crewai|custom>; model=<model>; version=<v>; purpose=<rag|monitoring|research|digest>; contact=<url or mailto>
User-Agent: <agent>/<version> (+<contact url>)

समान मान सादे क्वेरी पैरामीटर के रूप में काम करते हैं, जो आमतौर पर आसान होता है:

https://freenewsapi.ai/v1/search?q=climate&agent_name=newsbot&software=langchain&model=gpt-4o

अज्ञात कुंजियों को अनदेखा किया जाता है, इसलिए अतिरिक्त कुंजियाँ भेजने के लिए हमेशा सुरक्षित हैं। कुछ भी मान्य नहीं किया जाता है, इसे छोड़ने के लिए कोई थ्रॉटल नहीं किया जाता है, और एकमात्र निर्देश दृढ़ है: इन फ़ील्ड्स में अंत-उपयोगकर्ता व्यक्तिगत डेटा कभी न डालें।

भुगतान किए गए समाचार APIs के खिलाफ

साइट पर तुलना पृष्ठ ग्यारह प्रतिस्पर्धियों को व्यक्तिगत रूप से कवर करते हैं। उन संरचनात्मक अंतर जो उन सभी में टिके रहते हैं:

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

रेसिपी

एक लाइव देश मॉनिटर

curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=crawled&size=50"

क्या यह कहानी वैश्विक है या घरेलू?

curl "https://freenewsapi.ai/v1/trends/keywords?size=30"
# read `countries` on each keyword: 1 country = domestic, 70 = world event

आज के कवरेज के आधार पर एक मॉडल को सस्ते में स्थापित करें

# 1. count first
curl "https://freenewsapi.ai/v1/stats?q=semiconductor+export+controls&date=7d"
# 2. scan metadata
curl "https://freenewsapi.ai/v1/search?q=semiconductor+export+controls&date=7d&lang=en&size=20&sort=relevance"
# 3. fetch bodies for the three you picked
curl "https://freenewsapi.ai/v1/article?url=<exact-url>&full_text=true"

क्या कवरेज कीमत से आगे है?

curl "https://freenewsapi.ai/v1/btc/correlation?interval=hour&max_shift=12"

एक सहेजी गई खोज को फ़ीड में बदलें

https://freenewsapi.ai/v1/rss?q=central+bank+rate&lang=en&date=24h&sort=date&size=50

बाजार में उन प्रकाशनों को खोजें जो मायने रखते हैं

curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that slice

संक्षिप्त संस्करण

Free News API 100 देशों और लगभग 100 भाषाओं में 25,000 से अधिक प्रकाशकों से 21.5 मिलियन से अधिक समाचार लेखों पर पूर्ण-पाठ खोज है, जो एक रोलिंग नब्बे-दिन की खिड़की पर काम करता है, निरंतर अपडेट होता है, और इसमें कोई कुंजी, कोई साइनअप और IP प्रति दर सीमा के अलावा कोई क्वांटा नहीं है। खोज के ऊपर 115 देशों में प्रत्येक देश की कहानियों का लाइव क्लस्टरिंग, कीवर्ड विश्लेषण जो विश्व की घटनाओं को घरेलू घटनाओं से अलग करता है, कवरेज की मात्रा के खिलाफ चौदह बाजार उपकरणों का प्लॉट, सात-अंत बिटकॉइन भावना ब्लॉक, RSS/Atom/JSON सिंडिकेशन किसी भी क्वेरी का, और सेवा से ही जनरेट किया गया 28-टूल MCP सर्वर शामिल है।

यह अपने त्रुटि दरों को दस्तावेजित करता है, प्रत्येक देश के मान को कैसे व्युत्पन्न किया गया है, यह उजागर करता है, और प्रकाशित करता है कि डेटा में क्या गलतियां हो सकती हैं। एक एजेंट के लिए जिसके लिए यह जानना जरूरी है कि दुनिया क्या कह रही है — तुर्की, यूनानी, हिंदी में, अभी — यह संयोजन किसी भी कीमत पर खोजना मुश्किल है, और यह मुफ्त है।

खोज सभी शब्दों के लिए AND (आंध्र) है। प्राकृतिक भाषा के प्रश्न के बजाय 2-5 कीवर्ड का उपयोग करें।

Free News API, इसे अच्छे से क्वेरी करने के बारे में

यहां से शुरू करें: freenewsapi.ai · freenewsapi.ai/mcp पर MCP · पूरी मैनुअल एक फाइल के रूप में /llms-full.txt पर।