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 ওয়েবসাইট অ্যাক্সেসের জন্য ভাষা হেডার
ঐচ্ছিক ফিল্ড
সব 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 রিকোয়েস্টে আপনি যে প্যারামিটারগুলো নির্দিষ্ট করেছিলেন সেগুলোই থাকে
- 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
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
রিকোয়েস্ট প্রক্রিয়া করা যায়নি। রিকোয়েস্ট প্যারামিটার যাচাই করুন।
- 401
একটি বৈধ Felo API key আবশ্যক।
- 402
বিলিং শর্ত পূরণ না হওয়ায় রিকোয়েস্ট এগোতে পারছে না।
- 403
অ্যাকাউন্টটিকে এই অপারেশন করার অনুমতি নেই।
- 429
রিকোয়েস্ট বা ব্যয়ের সীমায় পৌঁছে গেছে।
- 502
পরিষেবা রিকোয়েস্টটি সম্পন্ন করতে পারেনি।
- 503
API বা বিলিং পরিষেবা সাময়িকভাবে অনুপলভ্য।
- 504
রিকোয়েস্ট প্রক্রিয়াকরণের সময় পরিষেবার সময় শেষ হয়ে গেছে।
- default
ত্রুটি রেসপন্স; আপস্ট্রিম passthrough রেসপন্স প্রোভাইডারের ফর্ম্যাট ব্যবহার করতে পারে।
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
}
]
}
]
}
]
}