DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
OnPage API में पेज स्क्रीनशॉट
किसी भी url को रेंडर करता है और स्क्रीनशॉट लौटाता है, जिसमें full_page_screenshot पूरी स्क्रॉल ऊँचाई के लिए और browser_screen_width व browser_screen_height व्यूपोर्ट सेट करते हैं। स्टैंडअलोन — किसी crawl की ज़रूरत नहीं। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है। ⚠️ एजेंट कुछ भी कर सके, उससे पहले ही एक इमेज बड़ा टूल परिणाम होती है; स्क्रीनशॉट तभी माँगें जब दृश्य ही मुद्दा हो, और जब टेक्स्ट मुद्दा हो तो post_dataforseo_on_page_content_parsing_live का उपयोग करें।
मूल्य संदर्भ
- मीटरिंग: सफल request के निश्चित लागत आधार पर
- संदर्भ request अनुमान: USD 0.0051
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array (object | null)[]
- acceptटाइप: string | null
_language वेबसाइट एक्सेस करने के लिए भाषा हेडर
वैकल्पिक फ़ील्ड
सभी locale फ़ॉर्मेट समर्थित हैं (xx, xx-XX, xxx-XX, आदि)
नोट: यदि आप यह पैरामीटर निर्दिष्ट नहीं करते, तो कुछ वेबसाइटें एक्सेस से इनकार कर सकती हैं; ऐसे में, आपको response ऐरे में"error_message":"Screenshot is empty"मिलेगा - browserटाइप: string | null
_preset ब्राउज़र स्क्रीन पैरामीटर के लिए प्रीसेट
वैकल्पिक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तो आपकोbrowser_screen_width,browser_screen_height,browser_screen_scale_factorनिर्दिष्ट करने की आवश्यकता नहीं हैसंभावित मान:
desktop,mobile,tabletdesktopप्रीसेट निम्नलिखित मान लागू करेगा:browser_screen_width: 1920browser_screen_height: 1080browser_screen_scale_factor: 1mobileप्रीसेट निम्नलिखित मान लागू करेगा:browser_screen_width: 390browser_screen_height: 844browser_screen_scale_factor: 3tabletप्रीसेट निम्नलिखित मान लागू करेगा:browser_screen_width: 1024browser_screen_height: 1366browser_screen_scale_factor: 2नोट: इस endpoint में
enable_browser_rendering,enable_javascript,load_resourcesऔरenable_xhrपैरामीटर हमेशा सक्षम रहते हैं। - browserटाइप: integer | null
_screen _height ब्राउज़र स्क्रीन ऊँचाई
वैकल्पिक फ़ील्ड
किसी विशिष्ट डिवाइस के लिए audit करने हेतु आप कस्टम ब्राउज़र स्क्रीन ऊँचाई सेट कर सकते हैं;
यदि आप यह फ़ील्ड उपयोग करते हैं, तो आपकोbrowser_presetनिर्दिष्ट करने की आवश्यकता नहीं है क्योंकि इसे अनदेखा कर दिया जाएगा;न्यूनतम मान, पिक्सेल में:
240
अधिकतम मान, पिक्सेल में:9999 - browserटाइप: number | null
_screen _scale _factor ब्राउज़र स्क्रीन स्केल फ़ैक्टर
वैकल्पिक फ़ील्ड
किसी विशिष्ट डिवाइस के लिए audit करने हेतु आप कस्टम ब्राउज़र स्क्रीन रिज़ॉल्यूशन अनुपात सेट कर सकते हैं;
यदि आप यह फ़ील्ड उपयोग करते हैं, तो आपकोbrowser_presetनिर्दिष्ट करने की आवश्यकता नहीं है क्योंकि इसे अनदेखा कर दिया जाएगा;न्यूनतम मान:
0.5
अधिकतम मान:3 - browserटाइप: integer | null फ़ॉर्मेट: int64
_screen _width ब्राउज़र स्क्रीन चौड़ाई
वैकल्पिक फ़ील्ड
किसी विशिष्ट डिवाइस के लिए audit करने हेतु आप कस्टम ब्राउज़र स्क्रीन चौड़ाई सेट कर सकते हैं;
यदि आप यह फ़ील्ड उपयोग करते हैं, तो आपकोbrowser_presetनिर्दिष्ट करने की आवश्यकता नहीं है क्योंकि इसे अनदेखा कर दिया जाएगा;न्यूनतम मान, पिक्सेल में:
240
अधिकतम मान, पिक्सेल में:9999 - customटाइप: string | null
_user _agent कस्टम user agent
वैकल्पिक फ़ील्ड
वेबसाइट क्रॉल करने के लिए कस्टम user agent
उदाहरण:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
डिफ़ॉल्ट मान:Mozilla/5.0 (compatible; RSiteAuditor) - disableटाइप: boolean | null
_cookie _popup कुकी पॉपअप अक्षम करें
वैकल्पिक फ़ील्ड
यदि आप उपयोगकर्ता से कुकी सहमति माँगने वाला पॉपअप अक्षम करना चाहते हैं, तोtrueपर सेट करें;
डिफ़ॉल्ट मान:false - fullटाइप: boolean | null
_page _screenshot पूरे पेज का स्क्रीनशॉट लें
वैकल्पिक फ़ील्ड
यदि आप स्क्रॉल करने से पहले दिखाई देने वाले पेज के भाग का ही स्क्रीनशॉट लेना चाहते हैं, तोfalseपर सेट करें
डिफ़ॉल्ट मान:true - ipटाइप: string | null
_pool _for _scan प्रॉक्सी पूल
वैकल्पिक फ़ील्ड
आप अनुरोधित डेटा प्राप्त करने के लिए उपयोग किए जाने वाले प्रॉक्सी पूल का स्थान चुन सकते हैं;
यह पैरामीटर तब उपयोग किया जा सकता है जब किसी एक स्थान में पेज कंटेंट उपलब्ध न हो, जिसके परिणामस्वरूप कभी-कभीsite_unreachableत्रुटियाँ होती हैं
संभावित मान:us,de - switchटाइप: boolean | null
_pool प्रॉक्सी पूल बदलें
वैकल्पिक फ़ील्ड
यदिtrueहै, तो अनुरोधित डेटा प्राप्त करने के लिए अतिरिक्त प्रॉक्सी पूल उपयोग किए जाएँगे;
यह पैरामीटर तब उपयोग किया जा सकता है जब एक साथ बहुत से टास्क सेट किए जाते हैं, जिसके परिणामस्वरूप कभी-कभीrate-limitऔर/याsite_unreachableत्रुटियाँ होती हैं - urlटाइप: string
पेज url
आवश्यक फ़ील्ड
स्नैप करने के लिए पेज का पूर्ण URL
नोट: यदि यहाँ निर्दिष्ट URL 404 स्टेटस कोड लौटाता है या निर्दिष्ट मान मान्य URL नहीं है, तो आपको response ऐरे में"error_message":"Screenshot is empty"मिलेगा
- टाइप: object | null · Response36Afe1097B20_OnPagePageScreenshotResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_OnPagePageScreenshotTaskInfo
- 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
परिणामों का ऐरे
- crawlटाइप: string | null
_progress क्रॉलिंग सेशन की स्थिति
संभावित मान:in_progress,finished - errorटाइप: string | null
_message त्रुटि संदेश
यदि आपके द्वारा बताया गयाurl404 स्टेटस कोड लौटाता है या मान्य URL नहीं है, तो आपको"error_message":"Screenshot is empty"मिलेगा
यदि कोई त्रुटि नहीं मिली, तो मानnullहोगा - itemsटाइप: array (object | null)[] | null
items ऐरे
- imageटाइप: string | null
अनुरोधित पेज का स्क्रीनशॉट
DataForSEO स्टोरेज पर पेज स्क्रीनशॉट का URL
नोट: DataForSEO स्टोरेज पर सहेजा गया पेज स्क्रीनशॉट अनुरोध करने के बाद केवल एक दिन तक सुलभ रहता है
- itemsटाइप: integer | null फ़ॉर्मेट: int64
_count परिणाम ऐरे में आइटम की संख्या
- 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/page_screenshot \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"url": "https://dataforseo.com/apis"
}
]'
{
"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": [
{
"crawl_progress": null,
"error_message": null,
"items_count": null,
"items": [
{
"image": null
}
]
}
]
}
]
}