DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
تنظیم وظایف 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 محدود کنید، نه بعداً.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.0051 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: 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نوع: number | null
_cpu _throttling _multiplier ضریب محدودسازی CPU مرورگر
الزامی اگرbrowser_network_throttling_methodرویdevtoolsتنظیم شده باشد؛
ضریب محدودسازی CPU را برای شبیه‌سازی شرایط عملکرد دستگاه در طول ممیزی Lighthouse تنظیم کنید؛
می‌توان آن را در بازه زیر مشخص کرد:1–4؛
توجه: این پارامتر فقط زمانی اعمال می‌شود کهbrowser_network_throttling_methodرویdevtoolsتنظیم شده باشد؛ - browserنوع: string | null
_network _throttling محدودسازی شبکه مرورگر
الزامی اگرbrowser_network_throttling_methodرویdevtoolsتنظیم شده باشد؛
پروفایل محدودسازی شبکه را برای شبیه‌سازی شرایط سرعت اتصال در طول ممیزی Lighthouse تنظیم کنید؛
مقادیر ممکن:no_throttling،fast_4g،slow_4g،regular_3g،pc؛
توجه: این پارامتر فقط زمانی اعمال می‌شود کهbrowser_network_throttling_methodرویdevtoolsتنظیم شده باشد؛ - browserنوع: string | null
_network _throttling _method روش محدودسازی شبکه مرورگر
فیلد اختیاری
روشی را تعیین می‌کند که برای اعمال محدودسازی در طول ممیزی Lighthouse استفاده می‌شود؛
مقادیر ممکن:simulate- معیارهای عملکرد تخمینی را بدون اعمال محدودسازی صریح محاسبه می‌کند؛devtools- تنظیمات محدودسازی مشخص‌شده درbrowser_network_throttlingوbrowser_cpu_throttling_multiplierرا اعمال می‌کند؛provided- از شرایط شبکه محیط خزش استفاده می‌کند؛ - browserنوع: integer | null
_screen _height ارتفاع صفحه نمایش مرورگر
فیلد اختیاری
ارتفاع صفحه نمایش مرورگر مورد استفاده در ممیزی Lighthouse را برای شبیه‌سازی یک دستگاه خاص تنظیم کنید؛
می‌توان آن را در بازه زیر مشخص کرد:240–9999؛ - browserنوع: number | null
_screen _scale _factor ضریب مقیاس صفحه نمایش مرورگر
فیلد اختیاری
نسبت پیکسل دستگاه مرورگر مورد استفاده در ممیزی Lighthouse را تنظیم کنید؛
می‌توان آن را در بازه زیر مشخص کرد:0.5–3؛ - browserنوع: integer | null قالب: int64
_screen _width عرض صفحه نمایش مرورگر
فیلد اختیاری
عرض صفحه نمایش مرورگر مورد استفاده در ممیزی Lighthouse را برای شبیه‌سازی یک دستگاه خاص تنظیم کنید؛
می‌توان آن را در بازه زیر مشخص کرد:240–9999؛ - categoriesنوع: array string[] | null
دسته‌های ممیزی Lighthouse
فیلد اختیاری
هر دسته مجموعه‌ای از ممیزی‌ها و گروه‌های ممیزی است که وزن‌دهی و امتیازدهی را روی بخش اعمال می‌کند (تعریف رسمی را ببینید)اگر این فیلد را نادیده بگیرید، داده‌های همه دسته‌ها را برمی‌گردانیم مگر اینکهauditsرا مشخص کنید
از این فیلد برای دریافت داده‌های دسته‌های مشخصی که اینجا تعیین می‌کنید استفاده کنیدمقادیر ممکن:
seo،performance،best_practices،accessibility - customنوع: string | null
_user _agent user agent سفارشی
فیلد اختیاری
user agent سفارشی مورد استفاده مرورگر هنگام اجرای ممیزی Lighthouse را مشخص کنید؛
می‌توان تا 254 کاراکتر مشخص کرد؛ - forنوع: boolean | null
_mobile اعمال شبیه‌سازی موبایل
فیلد اختیاری
اگر رویtrueتنظیم شود، Lighthouse از شبیه‌سازی دستگاه و صفحه نمایش موبایل برای آزمون صفحه در محیط موبایل استفاده می‌کند
اگر رویfalseتنظیم شود، نتایج برای دسکتاپ ارائه می‌شود
مقدار پیش‌فرض:false - languageنوع: string | null
_code کد زبان Lighthouse
فیلد اختیاری
می‌توانید فهرست زبان‌های موجود موتور جستجو را همراه باlanguage_codeآن‌ها با ارسال درخواست جداگانه بهhttps://api.dataforseo.com/v3/on_page/lighthouse/languagesدریافت کنید
مقدار پیش‌فرض:en - languageنوع: string | null
_name نام زبان Lighthouse
فیلد اختیاری
می‌توانید فهرست زبان‌های موجود موتور جستجو را همراه باlanguage_nameآن‌ها با ارسال درخواست جداگانه بهhttps://api.dataforseo.com/v3/on_page/lighthouse/languagesدریافت کنید
مقدار پیش‌فرض:English - pingbackنوع: string | null
_url نشانی URL اطلاع‌رسانی برای وظیفه تکمیل‌شده
فیلد اختیاری
وقتی وظیفه تکمیل شد، با درخواست GET به نشانی URL تعیین‌شده به شما اطلاع می‌دهیم
می‌توانید از رشته ‘$id’ به‌عنوان متغیر$idو از ‘$tag’ به‌عنوان متغیر$tagکدگذاری‌شده در URL استفاده کنید. مقادیر لازم را پیش از ارسال درخواست تنظیم می‌کنیم.
مثال:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
توجه: کاراکترهای ویژه درpingback_urlبا URL کدگذاری می‌شوند؛
از جمله کاراکتر#به%23کدگذاری می‌شود اطلاعات بیشتر در مرکز راهنمایی ما - tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید - urlنوع: string
نشانی URL هدف
فیلد الزامی
صفحه هدف باید با نشانی URL مطلق آن (شامل http:// یا https://) مشخص شود
مثال:https://dataforseo.com/ - versionنوع: string | null
- نوع: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostTaskInfo
- costنوع: number | null قالب: double
هزینه کل وظایف، دلار آمریکا
- dataنوع: object | null
همان پارامترهایی را دارد که در درخواست POST تعیین کرده‌اید
- propertyنوع: object | null
Name
- idنوع: string | null
شناسه وظیفه شناسه یکتای وظیفه در سیستم ما در قالب UUID
- pathنوع: array (string | null)[] | null
مسیر URL
- resultنوع: array (object | null)[] | null
- propertyنوع: object | null
Name
- resultنوع: integer | null قالب: int64
_count تعداد عناصر در آرایه result
- statusنوع: integer | null
_code کد وضعیت وظیفه توسط DataForSEO تولید می‌شود و می‌تواند در بازه زیر باشد: 10000-60000 فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- statusنوع: string | null
_message پیام اطلاعاتی وظیفه فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- timeنوع: string | null
زمان اجرا، ثانیه
- نوع: integer | null قالب: int64tasks
_count تعداد وظایف در آرایه tasks
- نوع: integer | null قالب: int64tasks
_error تعداد وظایف در آرایه tasks که با خطا برگردانده شده‌اند
- نوع: string | nulltime
زمان کل اجرا، بر حسب ثانیه
- نوع: string | nullversion
نسخه فعلی API
application/json - 400
درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
- 401
یک کلید API معتبر Felo لازم است.
- 402
درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.
- 403
حساب مجاز به انجام این عملیات نیست.
- 429
به سقف درخواست یا هزینه رسیده‌اید.
- 502
سرویس نتوانست درخواست را کامل کند.
- 503
سرویس API یا صورت‌حساب موقتاً در دسترس نیست.
- 504
سرویس هنگام پردازش درخواست به پایان مهلت رسید.
- default
پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند
application/json
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
]
}
]
}