DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Lighthouse टास्क सेट करना
Lighthouse audit को प्रतीक्षा करने के बजाय कतार में डालता है और task id लौटाता है। इसका उपयोग तब करें जब audit एक टूल कॉल के धैर्य से अधिक समय ले; get_dataforseo_on_page_lighthouse_task_get_json से प्राप्त करें, और get_dataforseo_on_page_lighthouse_ready से देखें कि क्या तैयार है। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है। ⚠️ अंत में वही 245 KB रिपोर्ट मिलती है, इसलिए context लागत टाल दी जाती है, उससे बचा नहीं जाता — इसे यहीं categories या audits से सीमित करें, बाद में नहीं।
मूल्य संदर्भ
- मीटरिंग: सफल request के निश्चित लागत आधार पर
- संदर्भ request अनुमान: USD 0.0051
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array (object | null)[]
- auditsटाइप: array string[] | null
Lighthouse audit
वैकल्पिक फ़ील्ड
audit व्यक्तिगत परीक्षण हैं जो Lighthouse प्रत्येक विशिष्ट सुविधा/अनुकूलन/मेट्रिक के लिए चलाता है ताकि संख्यात्मक स्कोर उत्पन्न हो सके (आधिकारिक परिभाषा देखें)यदि आप इस फ़ील्ड को अनदेखा करते हैं, तो हम सभी audit के लिए डेटा लौटाएँगे
यहाँ आप जिन विशिष्ट audit को इंगित करते हैं, उनके लिए डेटा प्राप्त करने हेतु यह फ़ील्ड उपयोग करेंनोट कि कुछ audit किसी विशिष्ट श्रेणी में नहीं आते और स्वतंत्र पेज गुणवत्ता माप हैं
सामान्यतः, कई उपयोग परिदृश्य हो सकते हैं:
1. यदि आप
categoriesको अनदेखा करते हैं, तो आप इस फ़ील्ड का उपयोग केवल निर्दिष्ट audit के लिए डेटा प्राप्त करने हेतु कर सकते हैं
उदाहरण के लिए, यदि आप"categories"को अनदेखा करते हैं और"audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"]निर्दिष्ट करते हैं, तो आपको केवल इन audit के लिए डेटा मिलेगा2. यदि आप कोई श्रेणी निर्दिष्ट करते हैं, तो आप इस फ़ील्ड का उपयोग उन audit को अतिरिक्त रूप से प्राप्त करने के लिए कर सकते हैं जो आपकी निर्दिष्ट श्रेणी(-यों) में नहीं आते
उदाहरण के लिए, यदि आप"categories": ["seo"]और"audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"]निर्दिष्ट करते हैं, तो आपको "performance" के अंतर्गत केवल ये audit और "seo" के अंतर्गत सभी audit मिलेंगे - browserटाइप: number | null
_cpu _throttling _multiplier ब्राउज़र CPU थ्रॉटलिंग गुणक
आवश्यक यदिbrowser_network_throttling_methoddevtoolsपर सेट है;
Lighthouse audit के दौरान डिवाइस प्रदर्शन स्थितियों को एम्युलेट करने के लिए CPU थ्रॉटलिंग गुणक सेट करें;
निम्नलिखित श्रेणी में निर्दिष्ट किया जा सकता है:1–4;
नोट: यह पैरामीटर केवल तब लागू होता है जबbrowser_network_throttling_methoddevtoolsपर सेट हो; - browserटाइप: string | null
_network _throttling ब्राउज़र नेटवर्क थ्रॉटलिंग
आवश्यक यदिbrowser_network_throttling_methoddevtoolsपर सेट है;
Lighthouse audit के दौरान कनेक्शन गति स्थितियों को एम्युलेट करने के लिए नेटवर्क थ्रॉटलिंग प्रोफ़ाइल सेट करें;
संभावित मान:no_throttling,fast_4g,slow_4g,regular_3g,pc;
नोट: यह पैरामीटर केवल तब लागू होता है जबbrowser_network_throttling_methoddevtoolsपर सेट हो; - browserटाइप: string | null
_network _throttling _method ब्राउज़र नेटवर्क थ्रॉटलिंग विधि
वैकल्पिक फ़ील्ड
Lighthouse audit के दौरान थ्रॉटलिंग लागू करने की विधि परिभाषित करता है;
संभावित मान:simulate- स्पष्ट थ्रॉटलिंग लागू किए बिना अनुमानित प्रदर्शन मेट्रिक्स की गणना करता है;devtools-browser_network_throttlingऔरbrowser_cpu_throttling_multiplierमें निर्दिष्ट थ्रॉटलिंग सेटिंग्स लागू करता है;provided- क्रॉलिंग वातावरण की नेटवर्क स्थितियों का उपयोग करता है; - browserटाइप: integer | null
_screen _height ब्राउज़र स्क्रीन ऊँचाई
वैकल्पिक फ़ील्ड
किसी विशिष्ट डिवाइस को एम्युलेट करने के लिए Lighthouse audit में उपयोग किए जाने वाले ब्राउज़र की स्क्रीन ऊँचाई सेट करें;
निम्नलिखित श्रेणी में निर्दिष्ट किया जा सकता है:240–9999; - browserटाइप: number | null
_screen _scale _factor ब्राउज़र स्क्रीन स्केल फ़ैक्टर
वैकल्पिक फ़ील्ड
Lighthouse audit में उपयोग किए जाने वाले ब्राउज़र का डिवाइस पिक्सेल अनुपात सेट करें;
निम्नलिखित श्रेणी में निर्दिष्ट किया जा सकता है:0.5–3; - browserटाइप: integer | null फ़ॉर्मेट: int64
_screen _width ब्राउज़र स्क्रीन चौड़ाई
वैकल्पिक फ़ील्ड
किसी विशिष्ट डिवाइस को एम्युलेट करने के लिए Lighthouse audit में उपयोग किए जाने वाले ब्राउज़र की स्क्रीन चौड़ाई सेट करें;
निम्नलिखित श्रेणी में निर्दिष्ट किया जा सकता है:240–9999; - categoriesटाइप: array string[] | null
Lighthouse audit की श्रेणियाँ
वैकल्पिक फ़ील्ड
प्रत्येक श्रेणी audit और audit समूहों का संग्रह है जो उस अनुभाग पर भार और स्कोरिंग लागू करती है (आधिकारिक परिभाषा देखें)यदि आप इस फ़ील्ड को अनदेखा करते हैं, तो हम सभी श्रेणियों के लिए डेटा लौटाएँगे जब तक आपauditsनिर्दिष्ट नहीं करते
यहाँ आप जिन विशिष्ट श्रेणियों को इंगित करते हैं, उनके लिए डेटा प्राप्त करने हेतु यह फ़ील्ड उपयोग करेंसंभावित मान:
seo,performance,best_practices,accessibility - customटाइप: string | null
_user _agent कस्टम user agent
वैकल्पिक फ़ील्ड
Lighthouse audit चलाते समय ब्राउज़र द्वारा उपयोग किया जाने वाला कस्टम user agent निर्दिष्ट करें;
अधिकतम 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पर अलग request भेजकर प्राप्त कर सकते हैं
डिफ़ॉल्ट मान:en - languageटाइप: string | null
_name lighthouse भाषा नाम
वैकल्पिक फ़ील्ड
आप सर्च इंजन की उपलब्ध भाषाओं की सूची उनकेlanguage_nameके साथhttps://api.dataforseo.com/v3/on_page/lighthouse/languagesपर अलग request भेजकर प्राप्त कर सकते हैं
डिफ़ॉल्ट मान:English - pingbackटाइप: string | null
_url पूर्ण हुए टास्क का नोटिफ़िकेशन URL
वैकल्पिक फ़ील्ड
टास्क पूरा होने पर हम आपके निर्दिष्ट URL पर GET request भेजकर आपको सूचित करेंगे
आप ‘$id’ स्ट्रिंग को$idवेरिएबल के रूप में और ‘$tag’ को urlencoded$tagवेरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट करेंगे।
उदाहरण:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
नोट:pingback_urlमें विशेष अक्षर urlencode किए जाएँगे;
जैसे,#अक्षर%23में एन्कोड होगा अधिक जानकारी हमारे Help Center पर देखें - tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
वैकल्पिक फ़ील्ड
अक्षर सीमा 255 है
आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
निर्दिष्टtagमान response केdataऑब्जेक्ट में मिलेगा - urlटाइप: string
लक्ष्य URL
आवश्यक फ़ील्ड
लक्ष्य पेज को उसके पूर्ण URL के साथ निर्दिष्ट किया जाना चाहिए (http:// या https:// सहित)
उदाहरण:https://dataforseo.com/ - versionटाइप: string | null
- टाइप: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostTaskInfo
- costटाइप: number | null फ़ॉर्मेट: double
टास्क की कुल लागत, USD
- dataटाइप: object | null
इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे
- 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 response कोड की पूरी सूची यहाँ देखी जा सकती है
- 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
request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।
- 401
एक वैध Felo API key आवश्यक है।
- 402
request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।
- 403
खाते को यह ऑपरेशन करने की अनुमति नहीं है।
- 429
request या खर्च की सीमा तक पहुँच गए हैं।
- 502
सेवा request पूरा नहीं कर सकी।
- 503
API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।
- 504
request संसाधित करते समय सेवा का समय समाप्त हो गया।
- default
त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।
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
]
}
]
}