Felo API PlatformFelo API Platform
تمام DataForSEO endpoints
v0.2.0-beta
OpenAPI 3.1.0

لائیو OnPage Lighthouse JSON

سرور:https://openapi.felo.ai
کلائنٹ لائبریریاں

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

لائیو OnPage Lighthouse JSON

​

ایک url پر Google Lighthouse آڈٹ چلاتا ہے اور مکمل رپورٹ واپس کرتا ہے: lighthouseVersion، requestedUrl، finalUrl، fetchTime، gatherMode، runWarnings اور ہر آڈٹ اور زمرے کا اسکور۔ for_mobile ایمولیٹ شدہ ڈیوائس تبدیل کرتا ہے، categories اور audits رن کو محدود کرتے ہیں۔ اسے کم کرنے کے لیے categories یا audits دیں، اور جب سوال صرف یہ ہو کہ صفحہ کیوں سست ہے تو post_dataforseo_on_page_waterfall کو ترجیح دیں۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔

قیمت کا حوالہ

  • میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
  • حوالہ جاتی درخواست کا تخمینہ: USD 0.005۔
  • حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔

صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔

باڈی
application/json
  • قسم: array (object | null)[]
    • audits
      قسم: array string[] | null

      Lighthouse آڈٹس
      اختیاری فیلڈ
      آڈٹس انفرادی ٹیسٹ ہیں جو Lighthouse ہر مخصوص فیچر/آپٹیمائزیشن/میٹرک کے لیے چلاتا ہے تاکہ عددی اسکور تیار ہو (سرکاری تعریف دیکھیں)؛

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

      نوٹ: کچھ آڈٹس کسی مخصوص زمرے سے تعلق نہیں رکھتے اور صفحے کے معیار کی خودمختار پیمائشیں ہیں؛

      عام طور پر کئی استعمال کے معاملات ہو سکتے ہیں:

      1. اگر آپ categories نظر انداز کریں تو آپ یہ فیلڈ صرف متعین کردہ آڈٹس کے لیے ڈیٹا حاصل کرنے کے لیے استعمال کر سکتے ہیں
      مثلاً، اگر آپ "categories" نظر انداز کریں اور "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"] متعین کریں تو آپ کو صرف ان آڈٹس کا ڈیٹا ملے گا

      2. اگر آپ کوئی زمرہ متعین کریں تو آپ یہ فیلڈ اپنے متعین کردہ زمرے (زمرہ جات) سے تعلق نہ رکھنے والے آڈٹس اضافی طور پر حاصل کرنے کے لیے استعمال کر سکتے ہیں
      مثلاً، اگر آپ "categories": ["seo"] اور "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"] متعین کریں تو آپ کو "performance" کے تحت صرف یہی آڈٹس اور "seo" کے تحت تمام آڈٹس ملیں گے

      آپ ممکنہ آڈٹس کی مکمل فہرست یہاں حاصل کر سکتے ہیں

    • browser_cpu_throttling_multiplier
      قسم: number | null

      براؤزر CPU تھروٹلنگ ملٹی پلائر
      اگر browser_network_throttling_method کو devtools پر سیٹ کیا جائے تو درکار ہے؛
      Lighthouse آڈٹ کے دوران ڈیوائس کی کارکردگی کے حالات کی نقل کرنے کے لیے CPU تھروٹلنگ ملٹی پلائر سیٹ کریں؛
      درج ذیل رینج میں متعین کیا جا سکتا ہے: 1–4؛
      نوٹ: یہ پیرامیٹر صرف اس وقت لاگو ہوتا ہے جب browser_network_throttling_method کو devtools پر سیٹ کیا جائے؛

    • browser_network_throttling
      قسم: string | null

      براؤزر نیٹ ورک تھروٹلنگ
      اگر browser_network_throttling_method کو devtools پر سیٹ کیا جائے تو درکار ہے؛
      Lighthouse آڈٹ کے دوران کنکشن کی رفتار کے حالات کی نقل کرنے کے لیے نیٹ ورک تھروٹلنگ پروفائل سیٹ کریں؛
      ممکنہ اقدار: no_throttling، fast_4g، slow_4g، regular_3g، pc؛
      نوٹ: یہ پیرامیٹر صرف اس وقت لاگو ہوتا ہے جب browser_network_throttling_method کو devtools پر سیٹ کیا جائے؛

    • browser_network_throttling_method
      قسم: string | null

      براؤزر نیٹ ورک تھروٹلنگ کا طریقہ
      اختیاری فیلڈ
      Lighthouse آڈٹ کے دوران تھروٹلنگ لاگو کرنے کا طریقہ متعین کرتا ہے؛
      ممکنہ اقدار:
      simulate - واضح تھروٹلنگ لاگو کیے بغیر تخمینی کارکردگی میٹرکس شمار کرتا ہے؛
      devtools - browser_network_throttling اور browser_cpu_throttling_multiplier میں متعین تھروٹلنگ سیٹنگز لاگو کرتا ہے؛
      provided - کرالنگ ماحول کے نیٹ ورک حالات استعمال کرتا ہے؛

    • browser_screen_height
      قسم: integer | null

      براؤزر اسکرین کی اونچائی
      اختیاری فیلڈ
      کسی مخصوص ڈیوائس کی نقل کرنے کے لیے Lighthouse آڈٹ میں استعمال ہونے والے براؤزر کی اسکرین اونچائی سیٹ کریں؛
      درج ذیل رینج میں متعین کیا جا سکتا ہے: 240–9999؛

    • browser_screen_scale_factor
      قسم: number | null

      براؤزر اسکرین اسکیل فیکٹر
      اختیاری فیلڈ
      Lighthouse آڈٹ میں استعمال ہونے والے براؤزر کا ڈیوائس پکسل تناسب سیٹ کریں؛
      درج ذیل رینج میں متعین کیا جا سکتا ہے: 0.5–3؛

    • browser_screen_width
      قسم: integer | null فارمیٹ: int64

      براؤزر اسکرین کی چوڑائی
      اختیاری فیلڈ
      کسی مخصوص ڈیوائس کی نقل کرنے کے لیے Lighthouse آڈٹ میں استعمال ہونے والے براؤزر کی اسکرین چوڑائی سیٹ کریں؛
      درج ذیل رینج میں متعین کیا جا سکتا ہے: 240–9999؛

    • categories
      قسم: array string[] | null

      Lighthouse آڈٹس کے زمرے
      اختیاری فیلڈ
      ہر زمرہ آڈٹس اور آڈٹ گروپس کا مجموعہ ہے جو اس حصے پر وزن اور اسکورنگ لاگو کرتا ہے (سرکاری تعریف دیکھیں)

      اگر آپ یہ فیلڈ نظر انداز کریں تو ہم تمام زمروں کے لیے ڈیٹا واپس کریں گے، الا یہ کہ آپ audits متعین کریں
      یہاں بتائے گئے مخصوص زمروں کے لیے ڈیٹا حاصل کرنے کے لیے یہ فیلڈ استعمال کریں

      ممکنہ اقدار:
      seo، performance، best_practices، accessibility

    • custom_user_agent
      قسم: string | null

      حسب ضرورت user agent
      اختیاری فیلڈ
      Lighthouse آڈٹ چلاتے وقت براؤزر کا استعمال کردہ حسب ضرورت user agent متعین کریں؛
      زیادہ سے زیادہ 254 حروف کے ساتھ متعین کیا جا سکتا ہے؛

    • for_mobile
      قسم: boolean | null

      موبائل ایمولیشن لاگو کرتا ہے
      اختیاری فیلڈ
      اگر true پر سیٹ کیا جائے تو Lighthouse صفحے کو موبائل ماحول کے خلاف جانچنے کے لیے موبائل ڈیوائس اور اسکرین ایمولیشن استعمال کرے گا
      اگر false پر سیٹ کیا جائے تو نتائج ڈیسک ٹاپ کے لیے فراہم کیے جائیں گے
      ڈیفالٹ قدر: false

    • language_code
      قسم: string | null

      Lighthouse زبان کا کوڈ
      اختیاری فیلڈ
      آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے language_code کے ساتھ https://api.dataforseo.com/v3/on_page/lighthouse/languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      ڈیفالٹ قدر:
      en

    • language_name
      قسم: string | null

      Lighthouse زبان کا نام
      اختیاری فیلڈ
      آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے language_name کے ساتھ https://api.dataforseo.com/v3/on_page/lighthouse/languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      ڈیفالٹ قدر:
      English

    • tag
      قسم: string | null

      صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
      اختیاری فیلڈ
      حروف کی حد 255 ہے
      آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
      آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے

    • url
      قسم: string

      ہدف URL
      درکار فیلڈ
      ہدف صفحہ اس کے مطلق URL کے ساتھ متعین کرنا چاہیے (http:// یا https:// سمیت)
      مثال:
      https://dataforseo.com/

    • version
      قسم: string | null

      Lighthouse ورژن
      اختیاری فیلڈ
      آپ اس کا نمبر متعین کر کے کسی مخصوص Lighthouse ورژن کے نتائج حاصل کر سکتے ہیں
      دستیاب ورژنز کی فہرست Lighthouse Versions endpoint کے ذریعے دستیاب ہے

جوابات
  • 200
    قسم: object | null · Response36Afe1097B20_OnPageLighthouseLiveJsonResponseInfo
    • cost
      قسم: number | null فارمیٹ: double

      ٹاسکس کی کل لاگت، USD

    • status_code
      قسم: integer | null

      عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

    • status_message
      قسم: string | null

      عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے

    • tasks
      قسم: array (object | null)[] | null

      ٹاسکس کی صف

      • قسم: object | null · Response36Afe1097B20_OnPageLighthouseLiveJsonTaskInfo
        • cost
          قسم: number | null فارمیٹ: double

          ٹاسکس کی کل لاگت، USD

        • data
          قسم: object | null

          وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔

          • propertyName
            قسم: object | null
        • id
          قسم: string | null

          ٹاسک شناخت کنندہ ہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ

        • path
          قسم: array (string | null)[] | null

          URL پاتھ

        • result
          قسم: array (object | null)[] | null

          Lighthouse آڈٹ کے نتائج
          یہ صف ٹاسک سیٹ کرتے وقت آپ کے متعین کردہ پیرامیٹرز کے مطابق ڈیٹا شامل کرے گی؛

          تمام فیلڈز اور ان کی وضاحتیں اس لنک سے دستیاب سرکاری ڈاکیومنٹیشن میں موجود ہیں۔

          • propertyName
            قسم: object | null
        • result_count
          قسم: integer | null فارمیٹ: int64

          result صف میں عناصر کی تعداد

        • status_code
          قسم: integer | null

          ٹاسک کا اسٹیٹس کوڈ DataForSEO کی جانب سے تیار کردہ، درج ذیل حد میں ہو سکتا ہے: 10000-60000 رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

        • status_message
          قسم: string | null

          ٹاسک کا معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے

        • time
          قسم: string | null

          عمل درآمد کا وقت، سیکنڈز

    • tasks_count
      قسم: integer | null فارمیٹ: int64

      tasks صف میں ٹاسکس کی تعداد

    • tasks_error
      قسم: integer | null فارمیٹ: int64

      خرابی کے ساتھ واپس ہونے والے tasks صف میں ٹاسکس کی تعداد

    • time
      قسم: string | null

      کل عمل درآمد کا وقت، سیکنڈ

    • version
      قسم: string | null

      API کا موجودہ ورژن

    application/json
  • 400

    درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔

  • 401

    درست Felo API کلید درکار ہے۔

  • 402

    درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔

  • 403

    اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔

  • 429

    درخواست یا اخراجات کی حد پوری ہو گئی ہے۔

  • 502

    سروس درخواست مکمل نہیں کر سکی۔

  • 503

    API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔

  • 504

    درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔

  • default

    خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں

    application/json
Request Example for post/v1/beta/dataforseo/on_page/lighthouse/live/json
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/lighthouse/live/json \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "url": "https://dataforseo.com",
    "for_mobile": true,
    "tag": "some_string_123"
  }
]'
{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        null
      ]
    }
  ]
}
Live OnPage Lighthouse JSON