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-র এনভেলপে মোড়া: ডেটা tasks[0].result-এ, ফলাফল tasks[0].status_code-এ — প্রত্যাখ্যাত রিকোয়েস্টও HTTP 200 ফেরত দেয়। ⚠️ শেষে একই 245 KB রিপোর্ট, তাই context খরচ পিছিয়ে যায়, এড়ানো যায় না — এখানেই categories বা audits দিয়ে সংকুচিত করুন, পরে নয়।
মূল্য রেফারেন্স
- মিটারিং: সফল রিকোয়েস্টের নির্দিষ্ট খরচের ভিত্তিতে
- রেফারেন্স রিকোয়েস্ট অনুমান: 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-এ আলাদা রিকোয়েস্ট পাঠিয়ে পেতে পারেন
ডিফল্ট মান:en - languageটাইপ: string | null
_name lighthouse ভাষার নাম
ঐচ্ছিক ফিল্ড
আপনি সার্চ ইঞ্জিনের উপলব্ধ ভাষার তালিকা তাদেরlanguage_nameসহhttps://api.dataforseo.com/v3/on_page/lighthouse/languages-এ আলাদা রিকোয়েস্ট পাঠিয়ে পেতে পারেন
ডিফল্ট মান:English - pingbackটাইপ: string | null
_url সম্পন্ন টাস্কের নোটিফিকেশন URL
ঐচ্ছিক ফিল্ড
টাস্ক সম্পন্ন হলে আমরা আপনার নির্দিষ্ট URL-এ GET রিকোয়েস্ট পাঠিয়ে আপনাকে জানাব
আপনি ‘$id’ স্ট্রিংকে$idভেরিয়েবল হিসেবে এবং ‘$tag’কে urlencoded$tagভেরিয়েবল হিসেবে ব্যবহার করতে পারেন। রিকোয়েস্ট পাঠানোর আগে আমরা প্রয়োজনীয় মান সেট করব।
উদাহরণ: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 রিকোয়েস্টে আপনি যে প্যারামিটারগুলো নির্দিষ্ট করেছিলেন সেগুলোই থাকে
- 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
রিকোয়েস্ট প্রক্রিয়া করা যায়নি। রিকোয়েস্ট প্যারামিটার যাচাই করুন।
- 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/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
]
}
]
}