Felo APIs

Web Fetch API

selector और readability विकल्पों के साथ वेब पेज की सामग्री को HTML, text या Markdown में निकालें।

POST/v2/web/extract

प्रमाणीकरण

Bearer API key

कंटेंट टाइप

application/json

दर संबंधी नोट

endpoint-विशिष्ट सीमाएं लागू हो सकती हैं।

YouTube Subtitling Chat API

Web Fetch API किसी लक्ष्य URL से सामग्री निकालती है और परिणाम ऐसे फ़ॉर्मेट में लौटाती है जिसे agent, RAG सिस्टम और कंटेंट वर्कफ़्लो संसाधित करना आसान पाते हैं। यह HTML, सादा टेक्स्ट या Markdown लौटा सकती है, और selectors, readability विकल्प, cache नियंत्रण, कस्टम user agents तथा अनुरोध cookies का समर्थन करती है।

Endpoint

POST https://openapi.felo.ai/v2/web/extract

प्रमाणीकरण

अपनी API key Authorization हेडर में भेजें:

Authorization: Bearer YOUR_API_KEY

API key बनाने और प्रबंधित करने के विवरण के लिए Authentication गाइड देखें।

AI Agent के साथ उपयोग करें

जब आप चाहते हैं कि Agent हर अन्य उपलब्ध Felo Skill के साथ वेबपेज निकाले, तो पूरा felo-ai पैकेज इंस्टॉल करें। इंस्टॉलर SKILL.md वाली हर पैकेज डायरेक्टरी को गतिशील रूप से खोजता है, इसलिए यह कभी स्थिर सूची पर निर्भर नहीं करता। सभी खोजी गई Skills को Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills या Hermes Agent ~/.hermes/skills में इंस्टॉल करें। हर प्लेटफ़ॉर्म के सुरक्षित इंस्टॉलेशन और API key चरणों के लिए मैन्युअल AI Agent सेटअप गाइड उपयोग करें।

अनुरोध

हेडर

हेडर	आवश्यक	विवरण
`Authorization`	हां	`Bearer YOUR_API_KEY` फ़ॉर्मेट में आपकी API key
`Content-Type`	हां	`application/json` होना चाहिए

Body पैरामीटर

पैरामीटर	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`url`	string	हां	-	निकालने के लिए वेबपेज URL।
`crawl_mode`	string	नहीं	`fast`	निष्कर्षण मोड। तेज़ fetch के लिए `fast` या अधिक सटीक crawl के लिए `fine` उपयोग करें जो समृद्ध पेज संभाल सकता है।
`output_format`	string	नहीं	`html`	आउटपुट फ़ॉर्मेट। समर्थित मान: `html`, `text`, `markdown`।
`with_readability`	boolean या string	नहीं	-	मुख्य सामग्री पर ध्यान केंद्रित करने और पेज शोर कम करने के लिए readability प्रोसेसिंग सक्षम करें।
`with_links_summary`	boolean	नहीं	-	जब downstream extractor समर्थन करे तो लिंक का सारांश शामिल करें।
`with_images_summary`	boolean	नहीं	-	जब समर्थित हो तो इमेज का सारांश शामिल करें।
`with_images_readability`	boolean	नहीं	-	जब समर्थित हो तो इमेज निष्कर्षण पर readability प्रोसेसिंग लागू करें।
`with_images`	boolean	नहीं	-	निकाले गए परिणाम में इमेज जानकारी शामिल करें।
`with_links`	boolean	नहीं	-	निकाले गए परिणाम में लिंक जानकारी शामिल करें।
`ignore_empty_text_image`	boolean	नहीं	-	जब समर्थित हो तो उन इमेज को अनदेखा करें जिनमें उपयोगी टेक्स्ट नहीं है।
`target_selector`	string	नहीं	-	निकालने के लिए लक्ष्य तत्व का CSS selector, जैसे `article.main-content`।
`wait_for_selector`	string	नहीं	-	निष्कर्षण से पहले किसी CSS selector के दिखने तक प्रतीक्षा करें। गतिशील रूप से रेंडर होने वाले पेज के लिए उपयोगी।
`set_cookies`	array	नहीं	-	निष्कर्षण अनुरोध के साथ भेजने के लिए cookies।
`user_agent`	string	नहीं	-	निष्कर्षण अनुरोध के लिए कस्टम User-Agent स्ट्रिंग।
`timeout`	integer	नहीं	-	अनुरोध timeout मिलीसेकंड में।
`with_cache`	boolean	नहीं	`true`	क्या downstream extractor cache उपयोग कर सकता है।
`with_stypes`	boolean	नहीं	`false`	जब समर्थित हो तो style-type मेटाडेटा शामिल करें।

प्रतिक्रिया

सफल प्रतिक्रिया

प्रतिक्रिया पारदर्शी pass-through डिज़ाइन का उपयोग करती है। data के भीतर सटीक फ़ील्ड output_format और अन्य निष्कर्षण विकल्पों के आधार पर बदल सकते हैं।

{
  "status": "ok",
  "message": null,
  "data": {
    "content": "# Example Article\n\nExtracted article content..."
  }
}

प्रतिक्रिया फ़ील्ड

फ़ील्ड	प्रकार	विवरण
`status`	string	प्रतिक्रिया स्थिति। सफल अनुरोध के लिए आमतौर पर `ok`।
`message`	string या null	अतिरिक्त संदेश। सफल अनुरोध के लिए आमतौर पर `null`।
`data`	object	downstream निष्कर्षण सेवा द्वारा लौटाई गई निकाली गई सामग्री और मेटाडेटा।
`data.content`	string या object	निकाली गई सामग्री। स्वरूप `output_format` और चुने गए विकल्पों पर निर्भर करता है।

त्रुटि प्रतिक्रियाएं

HTTP स्टेटस	Error Code	विवरण	सुझाया गया कार्य
400	`WEB_EXTRACT_FAILED`	अनुरोध validation विफल, URL अमान्य है, या downstream extractor ने client-side त्रुटि लौटाई।	`url`, selectors और अनुरोध पैरामीटर जांचें।
401	`UNAUTHORIZED`	API key गुम, अमान्य या रद्द है।	अपनी API key और authorization हेडर सत्यापित करें।
500	`WEB_EXTRACT_FAILED`	आंतरिक सेवा त्रुटि।	अनुरोध दोबारा प्रयास करें। समस्या बनी रहे तो सहायता से संपर्क करें।

उदाहरण

सामान्य निष्कर्षण

curl -X POST https://openapi.felo.ai/v2/web/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com"
  }'

Readability के साथ Markdown निकालें

curl -X POST https://openapi.felo.ai/v2/web/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/article",
    "output_format": "markdown",
    "with_readability": true
  }'

विशिष्ट CSS Selector निकालें

curl -X POST https://openapi.felo.ai/v2/web/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/article",
    "target_selector": "article.main-content",
    "output_format": "text"
  }'

गतिशील सामग्री की प्रतीक्षा करें

curl -X POST https://openapi.felo.ai/v2/web/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/app",
    "crawl_mode": "fine",
    "wait_for_selector": "#loaded-content",
    "output_format": "markdown",
    "timeout": 30000
  }'

उपयोग के मामले

प्रश्न का उत्तर देने से पहले agent को वेबपेज कॉन्टेक्स्ट दें।
RAG ingestion या नॉलेज-बेस निर्माण के लिए लेख का टेक्स्ट निकालें।
संग्रहण या दस्तावेज़ीकरण वर्कफ़्लो के लिए वेबपेज को Markdown में बदलें।
CSS selectors का उपयोग करके पेज से केंद्रित सामग्री खींचें।
downstream AI विश्लेषण से पहले readability प्रोसेसिंग से पेज शोर कम करें।

नोट्स

API प्रति अनुरोध एक URL संभालती है।
data downstream निष्कर्षण सेवा से pass through होता है, इसलिए समय के साथ अतिरिक्त फ़ील्ड दिख सकते हैं।
fine मोड fast से धीमा हो सकता है, लेकिन उपयोगी है जब पेज को अधिक समृद्ध रेंडरिंग व्यवहार चाहिए।
कुछ पेज निष्कर्षण अवरुद्ध कर सकते हैं, cookies मांग सकते हैं या कस्टम user_agent चाह सकते हैं।