Felo API PlatformFelo API Platform

Felo APIs

Web Fetch API

ویب صفحے کا مواد HTML، متن یا Markdown کے طور پر منتخب کنندہ اور پڑھنے کی آسانی کے اختیارات کے ساتھ نکالیں۔

POST/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_KEY

API کلیدیں بنانے اور منظم کرنے کی تفصیلات کے لیے تصدیق کی گائیڈ دیکھیں۔

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 ہونا چاہیے

باڈی پیرامیٹرز

پیرامیٹرقسملازمیڈیفالٹتفصیل
urlstringہاں-نکالنے کے لیے ویب صفحے کا URL۔
crawl_modestringنہیںfastایکسٹریکشن موڈ۔ تیز تر حصول کے لیے fast یا زیادہ باریک کرال کے لیے fine استعمال کریں جو زیادہ پیچیدہ صفحات سنبھال سکتا ہے۔
output_formatstringنہیںhtmlآؤٹ پٹ فارمیٹ۔ معاون ویلیوز: html، text، markdown۔
with_readabilityboolean یا stringنہیں-مرکزی مواد پر توجہ اور صفحے کے شور کو کم کرنے کے لیے readability پروسیسنگ فعال کریں۔
with_links_summarybooleanنہیں-جب ڈاؤن اسٹریم ایکسٹریکٹر معاونت کرے تو لنکس کا خلاصہ شامل کریں۔
with_images_summarybooleanنہیں-جب معاونت ہو تو تصاویر کا خلاصہ شامل کریں۔
with_images_readabilitybooleanنہیں-جب معاونت ہو تو تصویر ایکسٹریکشن پر readability ہینڈلنگ لاگو کریں۔
with_imagesbooleanنہیں-نکالے گئے نتیجے میں تصویر کی معلومات شامل کریں۔
with_linksbooleanنہیں-نکالے گئے نتیجے میں لنک کی معلومات شامل کریں۔
ignore_empty_text_imagebooleanنہیں-جب معاونت ہو تو اُن تصاویر کو نظر انداز کریں جن میں مفید متن نہیں۔
target_selectorstringنہیں-ہدف عنصر کے لیے CSS selector، مثلاً article.main-content۔
wait_for_selectorstringنہیں-ایکسٹریکشن سے پہلے CSS selector کے ظاہر ہونے تک انتظار کریں۔ متحرک طور پر رینڈر ہونے والے صفحات کے لیے مفید۔
set_cookiesarrayنہیں-ایکسٹریکشن درخواست کے ساتھ بھیجے جانے والے cookies۔
user_agentstringنہیں-ایکسٹریکشن درخواست کے لیے حسب ضرورت User-Agent سٹرنگ۔
timeoutintegerنہیں-درخواست کا ٹائم آؤٹ ملی سیکنڈز میں۔
with_cachebooleanنہیںtrueڈاؤن اسٹریم ایکسٹریکٹر cache استعمال کر سکتا ہے یا نہیں۔
with_stypesbooleanنہیںfalseجب معاونت ہو تو style-type میٹاڈیٹا شامل کریں۔

جواب

کامیاب جواب

جواب شفاف پاس تھرو ڈیزائن استعمال کرتا ہے۔ data کے اندر اصل فیلڈز output_format اور دیگر ایکسٹریکشن آپشنز کے لحاظ سے مختلف ہو سکتے ہیں۔

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

جواب کے فیلڈز

فیلڈقسمتفصیل
statusstringجواب کی حالت۔ کامیاب درخواست کے لیے عام طور پر ok۔
messagestring یا nullاضافی پیغام۔ کامیاب درخواستوں کے لیے عام طور پر null۔
dataobjectڈاؤن اسٹریم ایکسٹریکشن سروس کی واپس کردہ نکالی گئی مواد اور میٹاڈیٹا۔
data.contentstring یا objectنکالا گیا مواد۔ ساخت output_format اور منتخب آپشنز پر منحصر ہے۔

ایرر جوابات

HTTP اسٹیٹسایرر کوڈتفصیلتجویز کردہ اقدام
400WEB_EXTRACT_FAILEDدرخواست کی ویلیڈیشن ناکام، URL غلط، یا ڈاؤن اسٹریم ایکسٹریکٹر نے کلائنٹ سائیڈ ایرر واپس کیا۔url، selectors اور درخواست پیرامیٹرز چیک کریں۔
401UNAUTHORIZEDAPI کلید غائب، غلط یا منسوخ ہے۔اپنی API کلید اور authorization ہیڈر کی تصدیق کریں۔
500WEB_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 کی ضرورت رکھ سکتے ہیں۔