Felo API PlatformFelo API Platform

ویب مطالعہ

Provider: Felo · platform balance سے ادا شدہ

Authentication اور سیٹ اپبلنگ اور غلطیاں

کسی خاص ویب page کو ایسے format میں پڑھیں جسے آپ کی application استعمال کر سکے۔

تمام examples، overview سے FELO_API_KEY استعمال کرتے ہیں۔ Calls platform balance استعمال کرتی ہیں، Felo Pro credits نہیں۔ Response examples صرف وضاحتی ہیں؛ live content اور optional fields مختلف ہو سکتے ہیں۔

نقطۂ اختتام

POST /api/v1/data/web/read

درخواست

فیلڈقسملازمیمعنی
urlstringہاںHTTP یا HTTPS صفحہ URL
formatsسٹرنگ ارےنہیںMARKDOWN، TEXT، HTML، SCREENSHOT میں سے صرف ایک؛ طے شدہ Markdown
modestringنہیںquality (طے شدہ)، fast یا auto
timeoutintegerنہیںملی سیکنڈز میں وقفۂ انتظار، 1–60,000؛ طے شدہ 30,000
totalTimeoutintegerنہیںملی سیکنڈز میں مجموعی وقفۂ انتظار، 1–60,000؛ طے شدہ timeout

ہر request میں ایک output format منتخب کریں؛ ایک ہی array میں چاروں نہ بھیجیں۔

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/read" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","formats":["MARKDOWN"],"mode":"quality","timeout":30000}'

جواب

HTTP 200 JSON root پر منتخب کردہ content field واپس کرتا ہے۔ ایک Markdown response اس طرح ہو سکتا ہے:

{
  "title": "Example Domain",
  "markdown": "# Example Domain\n\nThis domain is for use in documentation examples.",
  "metadata": {}
}

اپنے requested format کے مطابق markdown، text، html یا screenshot پڑھیں۔ دوسری metadata optional ہے؛ یہ ضروری نہ سمجھیں کہ ہر format field موجود ہو۔ مکمل response کے لیے OpenAPI definition میں WebReadResponse schema دیکھیں۔

بلنگ اور ناکامیاں

web.read کی بلنگ فی request ہوتی ہے۔ timeout خالی page نہیں ہوتا: body استعمال کرنے سے پہلے HTTP status چیک کریں۔ timeout کے بعد بار بار تیز requests پر نہ جائیں؛ Billing and Errors کی پیروی کریں۔

مدد چاہیے؟