DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
লাইভ Google Organic SERP HTML
Google-এ একটি কিওয়ার্ডের র্যাংক করা ফলাফল সিঙ্ক্রোনাসভাবে ফেরত দেয়। পার্স করা ফলাফলের বদলে কাঁচা পেজ সোর্স। DataForSEO-র এনভেলপে মোড়া: ডেটা tasks[0].result-এ, ফলাফল tasks[0].status_code-এ — প্রত্যাখ্যাত রিকোয়েস্টও HTTP 200 ফেরত দেয়।
মূল্য রেফারেন্স
- মিটারিং: রিপোর্ট করা রেসপন্স খরচ
- রেফারেন্স রিকোয়েস্ট অনুমান: USD 0.02
- রেফারেন্স গ্রাহক গুণক: 1.0। নিষ্পত্তিকৃত গ্রাহক অঙ্কে এটি আবার প্রয়োগ করবেন না।
এটি কেবল রেফারেন্স মেটাডেটা; অ্যাকাউন্টের কোটেশন, নিশ্চিত মূল্য বা ব্যয়সীমা নয়। রিসোর্স ক্রেডিট Felo ক্রেডিট নয়। চূড়ান্ত চার্জ Felo-এর বিলিং রেকর্ড অনুযায়ী হয়।
- টাইপ: array (object | null)[]
- depthটাইপ: integer | null
পার্সিং গভীরতা
ঐচ্ছিক ফিল্ড
SERP-এ ফলাফলের সংখ্যা
ডিফল্ট মান:
10সর্বোচ্চ মান:
200
আপনার অ্যাকাউন্ট থেকে প্রতিটি SERP-এর জন্য বিল নেওয়া হবে যাতে সর্বোচ্চ 10টি ফলাফল থাকে;গভীরতা 10-এর বেশি সেট করলে অতিরিক্ত চার্জ হতে পারে যদি সার্চ ইঞ্জিন 10-এর বেশি ফলাফল ফেরত দেয়;
খরচ Pricing পেজে হিসাব করা যায়।
- deviceটাইপ: string | null
ডিভাইসের ধরন
ঐচ্ছিক ফিল্ড
নির্দিষ্ট ডিভাইস ধরনের জন্য ফলাফল ফেরত দিন
নিম্নলিখিত মান নিতে পারে:
desktop,mobileডিফল্ট মান:
desktop - expandটাইপ: boolean | null
_ai _overview AI overview প্রসারিত করুন
ঐচ্ছিক ফিল্ড
ai_overviewআইটেম প্রসারিত করতেtrueসেট করুন;ডিফল্ট মান:
false - findটাইপ: array string[] | null
_targets _in টার্গেটের জন্য যে SERP এলিমেন্ট প্রকারগুলো যাচাই করতে হবে
ঐচ্ছিক ফিল্ড
এই প্যারামিটার সক্রিয় করতে
stop_crawl_on_match-ও সক্রিয় থাকতে হবেনির্ধারণ করে টার্গেট ম্যাচের জন্য কোন SERP এলিমেন্ট প্রকার যাচাই করা হবে
যদি নির্দিষ্ট না করা হয়,
urlওdomainফিল্ডযুক্ত সব প্রথম-স্তরের এলিমেন্ট টার্গেটের জন্য যাচাই করা হয়সম্ভাব্য মান:
organic,paid,local_pack,featured_snippet,events,google_flights,images,jobs,knowledge_graph,local_service,map,scholarly_articles,third_party_reviews,twitterনোট:
ignore_targets_in-এর মতো একই এলিমেন্ট প্রকার থাকতে পারবে নাউদাহরণ:
"find_targets_in": ["organic", "featured_snippet"]আমাদের Help Center-এ এই প্যারামিটার সম্পর্কে আরও জানুন
- ignoreটাইপ: array string[] | null
_targets _in টার্গেট অনুসন্ধান থেকে বাদ দেওয়ার SERP এলিমেন্ট প্রকার
ঐচ্ছিক ফিল্ড
এই প্যারামিটার সক্রিয় করতে
stop_crawl_on_match-ও সক্রিয় থাকতে হবেটার্গেট ম্যাচ অনুসন্ধানের সময় কোন SERP এলিমেন্ট প্রকার বাদ দেওয়া হবে তা নির্ধারণ করে
সম্ভাব্য মান:
organic,paid,local_pack,featured_snippet,events,google_flights,images,jobs,knowledge_graph,local_service,map,scholarly_articles,third_party_reviews,twitterনোট:
find_targets_in-এর মতো একই এলিমেন্ট প্রকার থাকতে পারবে নাউদাহরণ:
"ignore_targets_in": ["paid", "images"]আমাদের Help Center-এ এই প্যারামিটার সম্পর্কে আরও জানুন
- keywordটাইপ: string
কীওয়ার্ড
আবশ্যক ফিল্ড
আপনি
keywordফিল্ডে সর্বোচ্চ 700 অক্ষর নির্দিষ্ট করতে পারেনসব %## ডিকোড করা হবে ('+' অক্ষর একটি স্পেস অক্ষরে ডিকোড হবে)
আপনার
keyword-এর জন্য "%" অক্ষর ব্যবহার করতে হলে এটি "%25" হিসেবে নির্দিষ্ট করুন;আপনার
keyword-এর জন্য “+” অক্ষর ব্যবহার করতে হলে এটি “%2B” হিসেবে নির্দিষ্ট করুন;এই ফিল্ডে 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', ‘cache:’, 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:' ইত্যাদি প্যারামিটার থাকলে প্রতি টাস্কের চার্জ 5 গুণ হবে
- languageটাইপ: string
_code সার্চ ইঞ্জিন ভাষা কোড
language_nameনির্দিষ্ট না করলে আবশ্যক ফিল্ডআপনি এই ফিল্ড ব্যবহার করলে
language_nameনির্দিষ্ট করার প্রয়োজন নেইআপনি
language_code-সহ সার্চ ইঞ্জিনের উপলব্ধ ভাষার তালিকাhttps://api.dataforseo.com/v3/serp/google/languages-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেনউদাহরণ:
en - languageটাইপ: string
_name সার্চ ইঞ্জিন ভাষার পূর্ণ নাম
language_codeনির্দিষ্ট না করলে আবশ্যক ফিল্ডআপনি এই ফিল্ড ব্যবহার করলে
language_codeনির্দিষ্ট করার প্রয়োজন নেইআপনি
language_name-সহ সার্চ ইঞ্জিনের উপলব্ধ ভাষার তালিকাhttps://api.dataforseo.com/v3/serp/google/languages-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেনউদাহরণ:
English - loadটাইপ: boolean | null
_async _ai _overview AI overview অ্যাসিনক্রোনাসভাবে লোড করুন
ঐচ্ছিক ফিল্ড
ai_overviewআইটেম পেতেtrueসেট করুন, এমনকি সেগুলো SERP-এ অ্যাসিনক্রোনাসভাবে লোড হলেও;falseসেট করলে আপনি শুধু ক্যাশ থেকেai_overviewআইটেম পাবেন;ডিফল্ট মান:
falseনোট প্রতিটি রিকোয়েস্টের জন্য আপনার অ্যাকাউন্ট থেকে অতিরিক্ত $0.002 বিল নেওয়া হবে;
এলিমেন্ট অনুপস্থিত থাকলে বা এতে
"asynchronous_ai_overview": falseথাকলে সব অতিরিক্ত চার্জ আপনার অ্যাকাউন্ট ব্যালেন্সে ফেরত দেওয়া হবে - locationটাইপ: integer
_code সার্চ ইঞ্জিন অবস্থান কোড
আবশ্যক ফিল্ড যদি আপনি
location_nameবাlocation_coordinateনির্দিষ্ট না করেনআপনি এই ফিল্ড ব্যবহার করলে
location_nameবাlocation_coordinateনির্দিষ্ট করার প্রয়োজন নেইআপনি
location_code-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকাhttps://api.dataforseo.com/v3/serp/google/locations-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেনউদাহরণ:
2840 - locationটাইপ: string
_coordinate অবস্থানের GPS স্থানাঙ্ক
location_nameবাlocation_codeনির্দিষ্ট না করলে আবশ্যক ফিল্ডআপনি এই ফিল্ড ব্যবহার করলে
location_nameবাlocation_codeনির্দিষ্ট করার প্রয়োজন নেইlocation_coordinateপ্যারামিটার "latitude,longitude,radius" ফরম্যাটে নির্দিষ্ট করতে হবে"latitude" ও "longitude"-এর জন্য সর্বোচ্চ দশমিক অঙ্ক: 7
"radius"-এর সর্বনিম্ন মান: 199 (mm)
"radius"-এর সর্বোচ্চ মান: 199999 (mm)
উদাহরণ:
53.476225,-2.243572,200 - locationটাইপ: string
_name সার্চ ইঞ্জিন অবস্থানের পূর্ণ নাম
আবশ্যক ফিল্ড যদি আপনি
location_codeবাlocation_coordinateনির্দিষ্ট না করেনআপনি এই ফিল্ড ব্যবহার করলে
location_codeবাlocation_coordinateনির্দিষ্ট করার প্রয়োজন নেইআপনি
location_name-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকাhttps://api.dataforseo.com/v3/serp/google/locations-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেনউদাহরণ:
London,England,United Kingdom - matchটাইপ: string
_type টার্গেট ম্যাচের ধরন
আবশ্যক ফিল্ড যদি
stop_crawl_on_matchনির্দিষ্ট করা থাকেmatch_value-এর জন্য ম্যাচের ধরনসম্ভাব্য মান:
domain– নির্দিষ্ট ডোমেইন বা সাবডোমেইনwith_subdomains– মূল ডোমেইন ও সাবডোমেইনwildcard– ওয়াইল্ডকার্ড প্যাটার্ন - matchটাইপ: string
_value টার্গেট ডোমেইন, সাবডোমেইন বা ওয়াইল্ডকার্ড মান
আবশ্যক ফিল্ড যদি
stop_crawl_on_matchনির্দিষ্ট করা থাকেটার্গেট ডোমেইন, সাবডোমেইন বা ওয়াইল্ডকার্ড মান নির্দিষ্ট করুন;
নোট: ডোমেইন বা সাবডোমেইন রিকোয়েস্ট প্রোটোকল ছাড়া নির্দিষ্ট করতে হবে;
উদাহরণ:
"match_value": "dataforseo.com","match_value": "/blog/post-*" - maxটাইপ: integer | null
_crawl _pages পেজ ক্রল সীমা
ঐচ্ছিক ফিল্ড
ক্রল করার জন্য সার্চ ফলাফল পেজের সংখ্যা
সর্বোচ্চ মান:
100নোট: ক্রল করা প্রতিটি পেজের জন্য আপনার কাছ থেকে চার্জ নেওয়া হবে (প্রতি পেজে 10 অর্গানিক ফলাফল);
আমাদের Pricing পেজে মূল্য সম্পর্কে আরও জানুন;
নোট#2:
max_crawl_pagesওdepthপ্যারামিটার একে অপরের পরিপূরক;আরও জানুন আমাদের help center-এ
- osটাইপ: string | null
ডিভাইস অপারেটিং সিস্টেম
ঐচ্ছিক ফিল্ড
deviceফিল্ডেdesktopনির্দিষ্ট করলে নিচের মধ্যে থেকে বেছে নিন:windows,macosডিফল্ট মান:
windowsdeviceফিল্ডেmobileনির্দিষ্ট করলে নিচের মধ্যে থেকে বেছে নিন:android,iosডিফল্ট মান:
android - seটাইপ: string | null
_domain সার্চ ইঞ্জিন ডোমেইন
ঐচ্ছিক ফিল্ড
আপনার নির্দিষ্ট অবস্থান ও ভাষা অনুযায়ী আমরা প্রাসঙ্গিক সার্চ ইঞ্জিন ডোমেইন স্বয়ংক্রিয়ভাবে বেছে নিই
তবে, আপনি এই ফিল্ডে একটি কাস্টম সার্চ ইঞ্জিন ডোমেইন সেট করতে পারেন
উদাহরণ:
google.co.uk,google.com.au,google.de, ইত্যাদি - searchটাইপ: string | null
_param সার্চ কোয়েরির অতিরিক্ত প্যারামিটার
ঐচ্ছিক ফিল্ড
উপলব্ধ প্যারামিটারের তালিকা ও অতিরিক্ত বিবরণ এখানে পান
নোট: নিম্নলিখিত সার্চ ইঞ্জিন প্যারামিটার সমর্থিত নয় এবং নির্দিষ্ট করলে স্বয়ংক্রিয়ভাবে আনসেট হয়ে যাবে:lr,cr,as_qdr,as_sitesearch,as_occt,as_filetype. - stopটাইপ: array (object | null)[] | null
_crawl _on _match ক্রলিং বন্ধ করার জন্য টার্গেটের অ্যারে ঐচ্ছিক ফিল্ড নির্দিষ্ট করা হলে, response-এ নির্দিষ্ট match_value পর্যন্ত এবং সেটিসহ SERP ফলাফল থাকবে; আপনি এই অ্যারেতে সর্বোচ্চ 10টি টার্গেট মান নির্দিষ্ট করতে পারেন উদাহরণ: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] এই প্যারামিটার সম্পর্কে আমাদের Help Center-এ আরও জানুন - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api নির্দিষ্ট টার্গেটের মাধ্যমে ক্রল করা প্রতিটি SERP-এর জন্য আপনার অ্যাকাউন্ট থেকে বিল নেওয়া হবে
- matchটাইপ: string | null
_type টার্গেট ম্যাচের ধরন stop_crawl_on_match নির্দিষ্ট করা থাকলে আবশ্যক ফিল্ড; match_value-এর জন্য ম্যাচের ধরন সম্ভাব্য মান: domain, with_subdomains, wildcard
- matchটাইপ: string | null
_value টার্গেট ডোমেইন বা ওয়াইল্ডকার্ড মান stop_crawl_on_match নির্দিষ্ট করা থাকলে আবশ্যক ফিল্ড; একটি টার্গেট ডোমেইন বা ওয়াইল্ডকার্ড মান নির্দিষ্ট করুন; নোট: ডোমেইন নাম রিকোয়েস্ট প্রোটোকল ছাড়া নির্দিষ্ট করতে হবে; উদাহরণ: dataforseo.com
- tagটাইপ: string | null
ব্যবহারকারী-নির্ধারিত টাস্ক আইডেন্টিফায়ার
ঐচ্ছিক ফিল্ড
অক্ষরের সীমা 255
আপনি এই প্যারামিটার দিয়ে টাস্ক শনাক্ত করে তা ফলাফলের সঙ্গে মেলাতে পারেন
আপনি নির্দিষ্ট
tagমান response-এরdataঅবজেক্টে পাবেন - targetটাইপ: string | null
_search _mode টার্গেট ম্যাচিং মোড
ঐচ্ছিক ফিল্ড
এই প্যারামিটার সক্রিয় করতে
stop_crawl_on_match-ও সক্রিয় থাকতে হবেstop_crawl_on_match-এ একাধিক টার্গেট নির্দিষ্ট করা থাকলে ক্রল কীভাবে থামবে তা নির্ধারণ করেসম্ভাব্য মান:
all,anyall– সব নির্দিষ্ট টার্গেট পাওয়া গেলেই ক্রল থামেany– যেকোনো একটি টার্গেট পাওয়া গেলেই ক্রল থামেডিফল্ট মান:
anyএই প্যারামিটার সম্পর্কে Help Center-এ আরও জানুন
- urlটাইপ: string | null
সরাসরি সার্চ URL
ঐচ্ছিক ফিল্ড
আপনি সরাসরি URL উল্লেখ করতে পারেন এবং আমরা তা প্রয়োজনীয় ফিল্ডে পার্স করব। মনে রাখবেন, এই পদ্ধতি আমাদের API-এর জন্য প্রক্রিয়া করা সবচেয়ে কঠিন এবং এতে URL-এ ভাষা ও অবস্থান সঠিকভাবে মিলতে হবে। বেশিরভাগ ক্ষেত্রে আমরা এই পদ্ধতি ব্যবহার করার পরামর্শ দিই না
উদাহরণ:
https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
নোট: নিচের সার্চ ইঞ্জিন প্যারামিটারগুলো সমর্থিত নয় এবং URL-এ নির্দিষ্ট করলে স্বয়ংক্রিয়ভাবে আনসেট হয়ে যাবে:lr,cr,as_qdr,as_sitesearch,as_occt,as_filetype.
- টাইপ: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveHtmlResponseInfo200
- টাইপ: number | null ফরম্যাট: doublecost
টাস্কের মোট খরচ, USD
- টাইপ: integer | nullstatus
_code সাধারণ স্ট্যাটাস কোড সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন
- টাইপ: string | nullstatus
_message সাধারণ তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন
- টাইপ: array (object | null)[] | nulltasks
টাস্কের অ্যারে
- টাইপ: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveHtmlTaskInfo
- 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
ফলাফলের অ্যারে
- datetimeটাইপ: string | null
ফলাফল পাওয়ার তারিখ ও সময়
UTC ফরম্যাটে: “yyyy-mm-dd hh-mm-ss +00:00”
উদাহরণ:2019-11-15 12:57:46 +00:00 - itemsটাইপ: array (object | null)[] | null
SERP-এ পাওয়া সার্চ ফলাফলের এলিমেন্ট
- dateটাইপ: string | null
HTML পেজ স্ক্যান হওয়ার তারিখ ও সময়
UTC ফরম্যাটে: “yyyy-mm-dd hh-mm-ss +00:00”
উদাহরণ:2019-11-15 12:57:46 +00:00 - htmlটাইপ: string | null
HTML পেজ
- pageটাইপ: integer | null
ফেরত দেওয়া HTML পেজের ক্রমিক সংখ্যা
- itemsটাইপ: integer | null ফরম্যাট: int64
_count itemsঅ্যারেতে ফেরত দেওয়া ফলাফলের সংখ্যা - keywordটাইপ: string | null
POST অ্যারেতে পাওয়া কিওয়ার্ড
কিওয়ার্ড ডিকোড করা %## সহ ফেরত আসে ('+' অক্ষর একটি স্পেসে ডিকোড হয়) - languageটাইপ: string | null
_code POST অ্যারেতে ভাষা কোড
- locationটাইপ: integer | null
_code POST অ্যারেতে অবস্থান কোড
- seটাইপ: string | null
_domain POST অ্যারেতে সার্চ ইঞ্জিন ডোমেইন
- typeটাইপ: string | null
এলিমেন্টের ধরন
- 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/serp/google/organic/live/html \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
}
]'
{
"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": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"datetime": null,
"items_count": null,
"items": [
{
"page": null,
"date": null,
"html": null
}
]
}
]
}
]
}