Felo APIs
Web Fetch API
ویب صفحے کا مواد HTML، متن یا Markdown کے طور پر منتخب کنندہ اور پڑھنے کی آسانی کے اختیارات کے ساتھ نکالیں۔
/v2/web/extractتصدیق
Bearer API key
مواد کی قسم
application/json
ریٹ نوٹس
endpoint کے مخصوص حدود لاگو ہو سکتے ہیں۔
Web Fetch API کسی ہدف URL سے مواد نکالتا ہے اور نتیجہ ایسی شکل میں واپس کرتا ہے جو ایجنٹس، RAG نظاموں اور مواد کے ورک فلوز کے لیے پروسیس کرنا آسان ہو۔ یہ HTML، سادہ متن یا Markdown واپس کر سکتا ہے، اور selectors، readability آپشنز، cache کنٹرول، حسب ضرورت user agents اور درخواست cookies کی معاونت کرتا ہے۔
endpoint
POST https://openapi.felo.ai/v2/web/extractتصدیق
اپنی API کلید Authorization ہیڈر میں بھیجیں:
Authorization: Bearer YOUR_API_KEYAPI کلیدیں بنانے اور منظم کرنے کی تفصیلات کے لیے تصدیق کی گائیڈ دیکھیں۔
AI ایجنٹس کے ساتھ استعمال
جب آپ چاہتے ہیں کہ ایجنٹ باقی تمام دستیاب Felo Skills کے ساتھ ویب صفحات بھی نکالے تو مکمل felo-ai پیکج انسٹال کریں۔ انسٹالر SKILL.md رکھنے والی ہر پیکج ڈائریکٹری کو متحرک طور پر دریافت کرتا ہے، لہٰذا یہ کبھی کسی مقررہ فہرست پر انحصار نہیں کرتا۔ دریافت شدہ تمام Skills کو Codex میں ~/.codex/skills، Claude Code میں ~/.claude/skills، OpenClaw میں ~/.agents/skills یا Hermes Agent میں ~/.hermes/skills پر انسٹال کریں۔ ہر پلیٹ فارم کے محفوظ تنصیبی اور API کلید کے مراحل کے لیے AI ایجنٹ کی دستی سیٹ اپ گائیڈ استعمال کریں۔
درخواست
ہیڈرز
| ہیڈر | لازمی | تفصیل |
|---|---|---|
Authorization | ہاں | آپ کی API کلید Bearer YOUR_API_KEY کی شکل میں |
Content-Type | ہاں | application/json ہونا چاہیے |
باڈی پیرامیٹرز
| پیرامیٹر | قسم | لازمی | ڈیفالٹ | تفصیل |
|---|---|---|---|---|
url | string | ہاں | - | نکالنے کے لیے ویب صفحے کا URL۔ |
crawl_mode | string | نہیں | fast | ایکسٹریکشن موڈ۔ تیز تر حصول کے لیے fast یا زیادہ باریک کرال کے لیے fine استعمال کریں جو زیادہ پیچیدہ صفحات سنبھال سکتا ہے۔ |
output_format | string | نہیں | html | آؤٹ پٹ فارمیٹ۔ معاون ویلیوز: html، text، markdown۔ |
with_readability | boolean یا string | نہیں | - | مرکزی مواد پر توجہ اور صفحے کے شور کو کم کرنے کے لیے readability پروسیسنگ فعال کریں۔ |
with_links_summary | boolean | نہیں | - | جب ڈاؤن اسٹریم ایکسٹریکٹر معاونت کرے تو لنکس کا خلاصہ شامل کریں۔ |
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 | نہیں | - | درخواست کا ٹائم آؤٹ ملی سیکنڈز میں۔ |
with_cache | boolean | نہیں | true | ڈاؤن اسٹریم ایکسٹریکٹر cache استعمال کر سکتا ہے یا نہیں۔ |
with_stypes | boolean | نہیں | false | جب معاونت ہو تو style-type میٹاڈیٹا شامل کریں۔ |
جواب
کامیاب جواب
جواب شفاف پاس تھرو ڈیزائن استعمال کرتا ہے۔ data کے اندر اصل فیلڈز output_format اور دیگر ایکسٹریکشن آپشنز کے لحاظ سے مختلف ہو سکتے ہیں۔
{
"status": "ok",
"message": null,
"data": {
"content": "# Example Article\n\nExtracted article content..."
}
}جواب کے فیلڈز
| فیلڈ | قسم | تفصیل |
|---|---|---|
status | string | جواب کی حالت۔ کامیاب درخواست کے لیے عام طور پر ok۔ |
message | string یا null | اضافی پیغام۔ کامیاب درخواستوں کے لیے عام طور پر null۔ |
data | object | ڈاؤن اسٹریم ایکسٹریکشن سروس کی واپس کردہ نکالی گئی مواد اور میٹاڈیٹا۔ |
data.content | string یا object | نکالا گیا مواد۔ ساخت output_format اور منتخب آپشنز پر منحصر ہے۔ |
ایرر جوابات
| HTTP اسٹیٹس | ایرر کوڈ | تفصیل | تجویز کردہ اقدام |
|---|---|---|---|
| 400 | WEB_EXTRACT_FAILED | درخواست کی ویلیڈیشن ناکام، URL غلط، یا ڈاؤن اسٹریم ایکسٹریکٹر نے کلائنٹ سائیڈ ایرر واپس کیا۔ | url، selectors اور درخواست پیرامیٹرز چیک کریں۔ |
| 401 | UNAUTHORIZED | API کلید غائب، غلط یا منسوخ ہے۔ | اپنی API کلید اور 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
}'استعمال کے مواقع
- سوال کا جواب دینے سے پہلے ایجنٹ کو ویب صفحے کا سیاق و سباق دیں۔
- RAG میں شامل کرنے یا نالج بیس بنانے کے لیے مضمون کا متن نکالیں۔
- آرکائیو یا دستاویزی ورک فلوز کے لیے ویب صفحات کو Markdown میں بدلیں۔
- CSS selectors استعمال کرتے ہوئے صفحے سے مرکوز مواد نکالیں۔
- ڈاؤن اسٹریم AI تجزیہ سے پہلے readability پروسیسنگ سے صفحے کا شور کم کریں۔
نوٹس
- API فی درخواست ایک URL سنبھالتا ہے۔
dataڈاؤن اسٹریم ایکسٹریکشن سروس سے پاس تھرو آتا ہے، لہٰذا وقت کے ساتھ اضافی فیلڈز ظاہر ہو سکتے ہیں۔fineموڈfastسے سست ہو سکتا ہے، لیکن جب صفحے کو زیادہ بھرپور رینڈرنگ رویہ درکار ہو تو مفید ثابت ہوتا ہے۔- کچھ صفحات ایکسٹریکشن روک سکتے ہیں، cookies طلب کر سکتے ہیں یا حسب ضرورت
user_agentکی ضرورت رکھ سکتے ہیں۔