DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
OnPage API صفحہ اسکرین شاٹ
کسی بھی url کو رینڈر کرتا ہے اور اسکرین شاٹ واپس کرتا ہے، full_page_screenshot پوری اسکرول اونچائی کے لیے اور browser_screen_width و browser_screen_height ویو پورٹ مقرر کرتے ہیں۔ خودمختار - کرال کی ضرورت نہیں۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ ⚠️ امیج ٹول کا بڑا نتیجہ ہوتی ہے، اس سے پہلے بھی کہ ایجنٹ اس کے ساتھ کچھ کر سکے؛ اسکرین شاٹ صرف تب مانگیں جب بصری چیز مقصود ہو، اور جب متن مقصود ہو تو post_dataforseo_on_page_content_parsing_live استعمال کریں۔
قیمت کا حوالہ
- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.0051۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: array (object | null)[]
- acceptقسم: string | null
_language ویب سائٹ تک رسائی کے لیے زبان کا ہیڈر
اختیاری فیلڈ
تمام لوکیل فارمیٹس معاون ہیں (xx, xx-XX, xxx-XX, وغیرہ)
نوٹ: اگر آپ یہ پیرامیٹر متعین نہ کریں تو کچھ ویب سائٹس رسائی سے انکار کر سکتی ہیں؛ ایسی صورت میں آپ کو جوابی صف میں"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 براؤزر اسکرین کی اونچائی
اختیاری فیلڈ
آپ کسی مخصوص ڈیوائس کے لیے آڈٹ کرنے کے لیے حسب ضرورت براؤزر اسکرین کی اونچائی سیٹ کر سکتے ہیں؛
اگر آپ یہ فیلڈ استعمال کریں تو آپ کوbrowser_presetبتانے کی ضرورت نہیں کیونکہ اسے نظر انداز کر دیا جائے گا؛کم از کم قدر، پکسلز میں:
240
زیادہ سے زیادہ قدر، پکسلز میں:9999 - browserقسم: number | null
_screen _scale _factor براؤزر اسکرین اسکیل فیکٹر
اختیاری فیلڈ
آپ کسی مخصوص ڈیوائس کے لیے آڈٹ کرنے کے لیے حسب ضرورت براؤزر اسکرین ریزولوشن کا تناسب سیٹ کر سکتے ہیں؛
اگر آپ یہ فیلڈ استعمال کریں تو آپ کوbrowser_presetبتانے کی ضرورت نہیں کیونکہ اسے نظر انداز کر دیا جائے گا؛کم از کم قدر:
0.5
زیادہ سے زیادہ قدر:3 - browserقسم: integer | null فارمیٹ: int64
_screen _width براؤزر اسکرین کی چوڑائی
اختیاری فیلڈ
آپ کسی مخصوص ڈیوائس کے لیے آڈٹ کرنے کے لیے حسب ضرورت براؤزر اسکرین کی چوڑائی سیٹ کر سکتے ہیں؛
اگر آپ یہ فیلڈ استعمال کریں تو آپ کو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 نہ ہو تو آپ کو جوابی صف میں"error_message":"Screenshot is empty"ملے گا
- قسم: object | null · Response36Afe1097B20_OnPagePageScreenshotResponseInfo200
- قسم: number | null فارمیٹ: doublecost
ٹاسکس کی کل لاگت، USD
- قسم: integer | nullstatus
_code عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: string | nullstatus
_message عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array (object | null)[] | nulltasks
ٹاسکس کی صف
- قسم: object | null · Response36Afe1097B20_OnPagePageScreenshotTaskInfo
- costقسم: number | null فارمیٹ: double
ٹاسکس کی کل لاگت، USD
- dataقسم: object | null
وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔
- 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 خرابی کا پیغام
اگر آپ کے متعین کردہurlنے 404 اسٹیٹس کوڈ واپس کیا یا یہ درست URL نہیں ہے تو آپ کو"error_message":"Screenshot is empty"ملے گا
اگر کوئی خرابی پیش نہ آئے تو قدرnullہوگی - itemsقسم: array (object | null)[] | null
آئٹمز کی صف
- imageقسم: string | null
درخواست کردہ صفحے کا اسکرین شاٹ
DataForSEO اسٹوریج پر صفحے کے اسکرین شاٹ کا URL
نوٹ: DataForSEO اسٹوریج پر محفوظ صفحے کا اسکرین شاٹ درخواست کرنے کے بعد صرف ایک دن تک قابل رسائی رہتا ہے
- itemsقسم: integer | null فارمیٹ: int64
_count نتائج کی صف میں آئٹمز کی تعداد
- 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
درست Felo API کلید درکار ہے۔
- 402
درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔
- 403
اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔
- 429
درخواست یا اخراجات کی حد پوری ہو گئی ہے۔
- 502
سروس درخواست مکمل نہیں کر سکی۔
- 503
API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔
- 504
درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔
- default
خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں
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
}
]
}
]
}
]
}