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

Lighthouse ٹاسکس سیٹ کرنا

Felo API Support
MIT
سرور:https://openapi.felo.ai
کلائنٹ لائبریریاں
Shell Curl

DataForSEO

​

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

DataForSEO آپریشنز

Lighthouse ٹاسکس سیٹ کرنا

​

انتظار کرنے کے بجائے Lighthouse آڈٹ کو قطار میں ڈالتا ہے اور ٹاسک id واپس کرتا ہے۔ اسے تب استعمال کریں جب آڈٹ ٹول کال کے صبر سے زیادہ طویل ہو؛ get_dataforseo_on_page_lighthouse_task_get_json سے حاصل کریں، اور get_dataforseo_on_page_lighthouse_ready سے دیکھیں کیا تیار ہے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ ⚠️ آخر میں وہی 245 KB رپورٹ، اس لیے کانٹیکسٹ لاگت مؤخر ہوتی ہے، ٹلتی نہیں - اسے یہیں categories یا audits سے محدود کریں، بعد میں نہیں۔

قیمت کا حوالہ

  • میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
  • حوالہ جاتی درخواست کا تخمینہ: USD 0.0051۔
  • حوالہ جاتی صارف ملٹی پلائر: 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

    • pingback_url
      قسم: string | null

      مکمل شدہ ٹاسک کا نوٹیفکیشن URL
      اختیاری فیلڈ
      ٹاسک مکمل ہونے پر ہم آپ کو آپ کے متعین کردہ URL پر GET درخواست بھیج کر مطلع کریں گے
      آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے۔
      مثال:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      نوٹ: pingback_url میں خصوصی حروف urlencoded ہو جائیں گے؛
      یعنی، # حرف %23 میں انکوڈ ہو جائے گا۔ ہمارے Help Center پر مزید جانیں

    • 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_OnPageLighthouseTaskPostResponseInfo
    • cost
      قسم: number | null فارمیٹ: double

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

    • status_code
      قسم: integer | null

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

    • status_message
      قسم: string | null

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

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

      ٹاسکس کی صف

      • قسم: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostTaskInfo
        • 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
          • 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/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/lighthouse/task_post \
  --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",
    "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
  }
]'

{
  "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
      ]
    }
  ]
}

کامیاب آپریشن

Setting Lighthouse Tasks