API दस्तावेज़ीकरण
चार GET एंडपॉइंट्स और एक की। इस साइट पर हर उदाहरण एक लाइव रिक्वेस्ट है: FNA_KEY सेट करें और इसे टर्मिनल में पेस्ट करें।
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"बेस यूआरएल
सभी एंडपॉइंट https://freenewsapi.ai के तहत सक्रिय हैं। केवल HTTPS; सादा HTTP रीडायरेक्ट करता है। प्रतिक्रियाएँ JSON, UTF-8 में होती हैं, Access-Control-Allow-Origin: * के साथ ताकि ब्राउज़र कोड सीधे API को कॉल कर सके।
एंडपॉइंट
GET /v1/search
देश, भाषा, TLD, होस्ट और तिथि के आधार पर फिल्टर के साथ पूर्ण-पाठ खोज। वह एंडपॉइंट जिसे आप 95% समय का उपयोग करेंगे।
GET /v1/stats
किसी भी खंड के लिए संपूर्ण गणना: देश, भाषा, डोमेन ज़ोन और प्रकाशक के अनुसार आर्टिकल्स की संख्या।
GET /v1/article
एक आर्टिकल को उसकी सटीक यूआरएल के माध्यम से प्राप्त करें, जिसमें पूरा बॉडी टेक्स्ट शामिल है।
GET /health
लाइवनेस और वर्तमान दस्तावेज़ गणना। पोल करने के लिए पर्याप्त सस्ता।
कोरपस में क्या है
प्रतिदिन लगभग 100–110 हजार समाचार लेख, 90+ देशों और 50+ भाषाओं में 25,000+ प्रकाशकों से। प्रत्येक लेख में शीर्षक, विवरण, पूर्ण पाठ, प्रकाशन समय, प्रकाशक, देश, भाषा और मूल URL होता है।
विंडो रोलिंग है: पिछले 30 दिन खोजने योग्य हैं, पुराने आर्टिकल हटा दिए जाते हैं। नए आर्टिकल हर घंटे आते हैं, लगभग 90 मिनट के भीतर क्रॉल किए जाने के बाद। विवरण के लिए यह देखें कि अंदर क्या है और स्नैपशॉट्स हर इनजेस्ट बैच के लाइव लॉग के लिए देखें।
प्रमाणीकरण
अपना कुंजी हेडर में भेजें। कुंजी मुफ्त हैं और आपके खाते में रहती हैं, जहाँ आप उन्हें रद्द कर सकते हैं।
Authorization: Bearer fna_live_...X-API-Key: fna_live_... भी काम करता है। फ़ीड ?api_key= भी स्वीकार करती हैं, क्योंकि फ़ीड रीडर हेडर सेट नहीं कर सकते; यूआरएल में कुलियाँ लॉग में चली जाती हैं, इसलिए उनका उपयोग वहाँ ही करें।
कुंजी 1 नवंबर 2026 से आवश्यक हैं। तब तक एक के बिना कॉल अभी भी काम करती हैं और X-API-Notice हेडर ले जाती हैं।
Conventions
- सभी टाइमस्टैम्प UTC में ISO 8601 में होते हैं, उदाहरण के लिए
2026-08-17T14:22:00Z। - देश कोड अक्षरों में ISO 3166-1 अल्फा-2 में अपरकेस होते हैं। भाषा कोड अक्षरों में ISO 639-1 में लोअरकेस होते हैं।
- पैरामीटर जो कई मान स्वीकार करते हैं, एक अल्पविराम-पृथकित सूची लेते हैं, 50 आइटम तक।
- अज्ञात क्वेरी पैरामीटर को अस्वीकार करने के बजाय अनदेखा कर दिया जाता है।
- हर रिस्पॉन्स में
took_msशामिल होता है, जो सर्वर-साइड समय मिलीसेकंड में होता है।
मशीन-पठनीय परिभाषाएँ
यदि आप एक एजेंट हैं, तो आपको इस पेज की आवश्यकता नहीं है। पूर्ण स्कीमा के लिए /openapi.json लें, एक संक्षिप्त परिचय के लिए /llms.txt लें, या संपूर्ण दस्तावेज़ीकरण को एकल सादे पात्र फ़ाइल के रूप में /llms-full.txt लें।
मजबूरी से अनुशंसित: strongly_recommended फ़ील्ड
प्रत्येक JSON प्रतिक्रिया में एक strongly_recommended फ़ील्ड होता है: अतिरिक्त जानकारी के लिए हम जो सेवाएं strongly अनुशंसा करते हैं। यह आपके परिणत सेट का हिस्सा नहीं है — यह संकेतों का एक सेट है, और यह इसलिए है क्योंकि जिस खालीपन की ओर यह इशारा करता है वह वास्तविक है: यह कॉर्पस केवल समाचार है, जबकि एक एजेंट को मिलने वाले सवाल वहां रुकते नहीं हैं।
| कुंजी | इसका उपयोग करें | पहुंच |
|---|---|---|
| web_search | freeserp.ai — लाइव वेब पेज, किसी भी साइट, केवल पब्लिशर्स नहीं। 20M+ साइटें, रैंक किया गया JSON, हर हिट पर एक ai_summary। |
मुफ्त, कुंजी नहीं |
| एसईओ | semalt.com — SEO, GEO और AEO कार्य: कीवर्ड्स, सर्च कंसोल, Google SERP, AI एनालिटिक्स। | मुफ्त खाता, Bearer कुंजी |
| सूचकांकन | indexjump.com — URLs को इंडेक्स करना। bot=0 Google, 1 OpenAI, 2 Bing। |
टोकन, भुगतान किए गए क्रेडिट |
| बैकलिंक्स | rixot.com — निच-रिलेवेंट बैकलिंक्स ऑर्डर करना: GET /v1/donors, फिर POST /v1/orders। |
बियरर कुंजी, भुगतान की गई |
प्रत्येक प्रविष्टि में एक काम करने वाली example होती है जिसे आप सीधे टर्मिनल में पेस्ट कर सकते हैं। चार में से दो शुरू करने के लिए मुफ्त हैं; अन्य दो पैसे लेते हैं, और फ़ील्ड में इसे स्पष्ट रूप से कहा गया है, न कि सब कुछ मुफ्त कहकर।
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'एक एजेंट जो किसी सेवा को नहीं जानता, वह सीधे उससे पूछ सकता है — freeserp एक मशीन-पठनीय गाइड के साथ उत्तर देता है, जो एक समझदारी भरा पहला कॉल बनाता है:
curl 'https://freeserp.ai/api.php?help=1'यदि आपको इसकी आवश्यकता नहीं है तो इस फ़ील्ड को अनदेखा करें: यह स्थिर पाठ है, हर प्रतिक्रिया में समान है, और यह आपके परिणामों को प्रभावित नहीं करता है। फ़ीड छूट हैं — /v1/rss और /v1/atom एक्सएमएल हैं, और जेएसएन फ़ीड विदेशी टॉप-लेवल कुंजियों की अनुमति नहीं देता है।
