DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
লাইভ Google Local Finder SERP
সিঙ্ক্রোনাসভাবে Google-এ স্পষ্টভাবে স্থানীয় কোয়েরির জন্য Google-এর দেখানো সম্প্রসারিত স্থানীয় ফলাফল ফেরত দেয়। keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count ও items ফেরত দেয়। advanced ডিফল্ট পছন্দ; যখন কেবল র্যাংক করা তালিকাই গুরুত্বপূর্ণ তখন regular নিন, আর html কেবল দেখতে যে পার্সার কী বাদ দিয়েছে। 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সর্বোচ্চ মান:
100
সর্বোচ্চ 10টি ফলাফল থাকা প্রতিটি SERP-এর জন্য আপনার অ্যাকাউন্ট থেকে বিল নেওয়া হবে;10-এর বেশি গভীরতা সেট করলে অতিরিক্ত চার্জ হতে পারে যদি সার্চ ইঞ্জিন সে অনুযায়ী 10টির বেশি ফলাফল ফেরত দেয়;
নির্দিষ্ট গভীরতা response-এ ফলাফলের সংখ্যার চেয়ে বেশি হলে পার্থক্যটি স্বয়ংক্রিয়ভাবে আপনার অ্যাকাউন্ট ব্যালেন্সে ফেরত দেওয়া হবে
খরচ Pricing পেজে হিসাব করা যায়।
- deviceটাইপ: string | null
ডিভাইসের ধরন
ঐচ্ছিক ফিল্ড
নির্দিষ্ট ডিভাইস ধরনের জন্য ফলাফল ফেরত দিন
নিম্নলিখিত মান নিতে পারে:
desktop,mobileডিফল্ট মান:
desktop - keywordটাইপ: string
কীওয়ার্ড
আবশ্যক ফিল্ড
আপনি
keywordফিল্ডে সর্বোচ্চ 700 অক্ষর উল্লেখ করতে পারেনসব %## ডিকোড করা হবে (‘+’ অক্ষর একটি স্পেস অক্ষরে ডিকোড হবে)
আপনাকে
keyword-এ “%” ব্যবহার করতে হলে তা “%25” হিসেবে উল্লেখ করুন;আপনাকে
keyword-এ “+” ব্যবহার করতে হলে তা “%2B” হিসেবে উল্লেখ করুন
DataForSEO API-তে
keywordএবংkeywordsফিল্ডের নিয়ম ও সীমাবদ্ধতা সম্পর্কে Help Center নিবন্ধে জানুন - languageটাইপ: string
_code সার্চ ইঞ্জিন ভাষা কোড
language_nameনির্দিষ্ট না করলে আবশ্যক ফিল্ডআপনি এই ফিল্ড ব্যবহার করলে
language_nameনির্দিষ্ট করার প্রয়োজন নেইআপনি
language_codeসহ সার্চ ইঞ্জিনের উপলব্ধ ভাষার তালিকাhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languages-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেনউদাহরণ:
en - languageটাইপ: string
_name সার্চ ইঞ্জিন ভাষার পূর্ণ নাম
language_codeনির্দিষ্ট না করলে আবশ্যক ফিল্ডআপনি এই ফিল্ড ব্যবহার করলে
language_codeনির্দিষ্ট করার প্রয়োজন নেইআপনি
language_name-সহ সার্চ ইঞ্জিনের উপলব্ধ ভাষার তালিকাhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languages-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেনউদাহরণ:
English - locationটাইপ: integer
_code সার্চ ইঞ্জিন অবস্থান কোড
location_nameবাlocation_coordinateনির্দিষ্ট না করলে আবশ্যক ফিল্ডআপনি এই ফিল্ড ব্যবহার করলে
location_nameবাlocation_coordinateনির্দিষ্ট করার প্রয়োজন নেইআপনি
location_code-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকাhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেনউদাহরণ:
2840 - locationটাইপ: string
_coordinate অবস্থানের GPS স্থানাঙ্ক
location_nameবাlocation_codeনির্দিষ্ট না করলে আবশ্যক ফিল্ডআপনি এই ফিল্ড ব্যবহার করলে
location_nameবাlocation_codeনির্দিষ্ট করার প্রয়োজন নেইlocation_coordinateপ্যারামিটার "latitude,longitude,zoom" ফরম্যাটে নির্দিষ্ট করতে হবে"zoom" নির্দিষ্ট না থাকলে ডিফল্ট মান হিসেবে 9z প্রয়োগ হবে
"latitude" ও "longitude"-এর জন্য সর্বোচ্চ দশমিক অঙ্ক: 7
"zoom"-এর সর্বনিম্ন মান: 4z
"zoom"-এর সর্বোচ্চ মান: 18z
উদাহরণ:
52.6178549,-155.352142,20z - locationটাইপ: string
_name সার্চ ইঞ্জিন অবস্থানের পূর্ণ নাম
location_codeবাlocation_coordinateনির্দিষ্ট না করলে আবশ্যক ফিল্ডআপনি এই ফিল্ড ব্যবহার করলে
location_codeবাlocation_coordinateনির্দিষ্ট করার প্রয়োজন নেইআপনি
location_name-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকাhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেনউদাহরণ:
London,England,United Kingdom - minটাইপ: number | null ফরম্যাট: double
_rating সর্বনিম্ন রেটিং অনুসারে ফলাফল ফিল্টার করুন
ঐচ্ছিক ফিল্ড
desktop-এর সম্ভাব্য মান:3.5,4,4.5;mobile-এর সম্ভাব্য মান:2,2.5,3,3.5,4,4.5 - osটাইপ: string | null
ডিভাইস অপারেটিং সিস্টেম
ঐচ্ছিক ফিল্ড
deviceফিল্ডেdesktopনির্দিষ্ট করলে নিচের মধ্যে থেকে বেছে নিন:windows,macosডিফল্ট মান:
windowsdeviceফিল্ডেmobileনির্দিষ্ট করলে নিচের মধ্যে থেকে বেছে নিন:android,iosডিফল্ট মান:
android - priorityটাইপ: integer | null
টাস্কের অগ্রাধিকার
ঐচ্ছিক ফিল্ড
নিম্নলিখিত মান নিতে পারে:
1 – সাধারণ সম্পাদন অগ্রাধিকার (ডিফল্টভাবে সেট)
2 – উচ্চ সম্পাদন অগ্রাধিকার
উচ্চ সম্পাদন অগ্রাধিকারযুক্ত টাস্কের জন্য অতিরিক্ত চার্জ নেওয়া হবে।খরচ Pricing পেজে হিসাব করা যায়।
- tagটাইপ: string | null
ব্যবহারকারী-নির্ধারিত টাস্ক আইডেন্টিফায়ার
ঐচ্ছিক ফিল্ড
অক্ষরের সীমা 255
আপনি এই প্যারামিটার দিয়ে টাস্ক শনাক্ত করে তা ফলাফলের সঙ্গে মেলাতে পারেন
আপনি নির্দিষ্ট
tagমান response-এরdataঅবজেক্টে পাবেন - timeটাইপ: string | null
_filter খোলার সময় অনুসারে ফলাফল ফিল্টার করুন
ঐচ্ছিক ফিল্ড
এই ফিল্ড ব্যবহার করে আপনি ফলাফলের স্থানগুলো দর্শনার্থীদের জন্য খোলা থাকার সময় অনুসারে ফিল্টার করতে পারেন
মনে রাখবেন, Google এমন ফলাফলও দিতে পারে যা এই ফিল্টারের সঙ্গে মেলে না
সম্ভাব্য মান:
"open_now","24_hours","$day_value","$day_value;$time_value";$day_value-এর বদলে এই মানগুলোর একটি ব্যবহার করুন:"monday","tuesday","wednesday","thursday","friday","saturday","sunday";$time_value-এর বদলে এই মানগুলোর একটি ব্যবহার করুন:"00","01","02","03","04","05","06","07","08","09","10","11","12","13","14","15","16","17","18","19","20","21","22","23"উদাহরণ:
"tuesday;18"
- টাইপ: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveAdvancedResponseInfo200
- টাইপ: number | null ফরম্যাট: doublecost
টাস্কের মোট খরচ, USD
- টাইপ: integer | nullstatus
_code সাধারণ স্ট্যাটাস কোড সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন
- টাইপ: string | nullstatus
_message সাধারণ তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন
- টাইপ: array (object | null)[] | nulltasks
টাস্কের অ্যারে
- টাইপ: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveAdvancedTaskInfo
- 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
ফলাফলের অ্যারে
- checkটাইপ: string | null
_url সার্চ ইঞ্জিন ফলাফলের সরাসরি URL
আমরা সঠিক ফলাফল দিয়েছি কি না তা নিশ্চিত করতে এটি ব্যবহার করতে পারেন - datetimeটাইপ: string | null
ফলাফল পাওয়ার তারিখ ও সময়
UTC ফরম্যাটে: “yyyy-mm-dd hh-mm-ss +00:00”
উদাহরণ:2019-11-15 12:57:46 +00:00 - itemটাইপ: array (string | null)[] | null
_types SERP-এ সার্চ ফলাফলের ধরন
SERP-এ পাওয়া সার্চ ফলাফলের (items) ধরন রয়েছে।
সম্ভাব্য আইটেম ধরন:local_pack - itemsটাইপ: array (object | null)[] | null
এলিমেন্টের আইটেম
- টাইপ: object | null · Response36Afe1097B20_LocalPackSerpElementItem
- টাইপ: object · Response36Afe1097B20_LocalPackSerpElementItem
- typeডিসক্রিমিনেটরটাইপ: string | null
এলিমেন্টের ধরন
- bookingটাইপ: string | null
_url বুকিং পৃষ্ঠার URL
- cidটাইপ: string | null
Google-নির্ধারিত ক্লায়েন্ট id
- descriptionটাইপ: string | null
লিংকের বর্ণনা
- domainটাইপ: string | null
ভিডিও হোস্ট করা ওয়েবসাইটের ডোমেইন
- isটাইপ: boolean | null
_paid এলিমেন্টটি বিজ্ঞাপন কি না তা নির্দেশ করে
- pageটাইপ: integer | null
সার্চ ফলাফল পেজ নম্বর
যে SERP পেজে এলিমেন্টটি অবস্থিত তার নম্বর নির্দেশ করে - phoneটাইপ: string | null
ফোন নম্বর
- positionটাইপ: string | null
SERP-এ এলিমেন্টের বিন্যাস
নিম্নলিখিত মান নিতে পারে:left,right - rankটাইপ: integer | null
_absolute SERP-এ পরম র্যাংক
SERP-এর সব উপাদানের মধ্যে পরম অবস্থান
সবসময়0এর সমান হয়desktop-এর ক্ষেত্রে - rankটাইপ: integer | null
_group SERP-এ গ্রুপ র্যাংক
একইtypeমানের উপাদানের গ্রুপের মধ্যে অবস্থান;
ভিন্নtypeমানের উপাদানের অবস্থানrank_groupথেকে বাদ যায়;
সবসময়0এর সমান হয়desktop-এর ক্ষেত্রে - ratingটাইপ: object | null · Response36Afe1097B20_RatingInfo
উপাদানের রেটিং
রিভিউয়ের ভিত্তিতে জনপ্রিয়তার হার যা SERP-এ দেখানো হয়;
কোনোটি না থাকলেnullএর সমান- ratingটাইপ: integer | null
_max rating_type-এর সর্বোচ্চ মান
- ratingটাইপ: string | null
_type রেটিংয়ের ধরন এখানে আপনি নিম্নলিখিত উপাদান পাবেন: Max5, Percents, CustomMax
- valueটাইপ: number | null ফরম্যাট: double
রেটিংয়ের মান
- votesটাইপ: integer | null ফরম্যাট: int64
_count ফিডব্যাকের পরিমাণ
- rectangleটাইপ: object | null · Response36Afe1097B20_AiModeRectangleInfo
আয়তক্ষেত্র প্যারামিটার
SERP-এ ফলাফলের স্নিপেটের কার্টেসিয়ান স্থানাঙ্ক ও পিক্সেল মাত্রা রয়েছেnull-এর সমান যদি POST রিকোয়েস্টেcalculate_rectanglestrue-তে সেট না থাকে- heightটাইপ: number | null ফরম্যাট: double
এলিমেন্টের উচ্চতা পিক্সেলে
- widthটাইপ: number | null ফরম্যাট: double
এলিমেন্টের প্রস্থ পিক্সেলে
- xটাইপ: number | null ফরম্যাট: double
x-অক্ষ স্থানাঙ্ক ফলাফল স্নিপেটের উপরের বাম কোণের x-অক্ষ স্থানাঙ্ক, যেখানে স্ক্রিনের উপরের বাম কোণটি মূলবিন্দু
- yটাইপ: number | null ফরম্যাট: double
y-অক্ষ স্থানাঙ্ক ফলাফল স্নিপেটের উপরের বাম কোণের y-অক্ষ স্থানাঙ্ক, যেখানে স্ক্রিনের উপরের বাম কোণটি মূলবিন্দু
- titleটাইপ: string | null
সারির শিরোনাম
- urlটাইপ: string | null
তৃতীয় পক্ষের রিভিউ সোর্সের URL
- xpathটাইপ: string | null
এলিমেন্টের XPath
- itemsটাইপ: integer | null ফরম্যাট: int64
_count itemsঅ্যারেতে ফেরত দেওয়া ফলাফলের সংখ্যা - keywordটাইপ: string | null
POST অ্যারেতে পাওয়া কিওয়ার্ড
কিওয়ার্ড ডিকোড করা %## সহ ফেরত আসে ('+' অক্ষর একটি স্পেসে ডিকোড হয়) - languageটাইপ: string | null
_code POST অ্যারেতে ভাষা কোড
- locationটাইপ: integer | null
_code POST অ্যারেতে অবস্থান কোড
- refinementটাইপ: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips সার্চ রিফাইনমেন্ট চিপ
- itemsটাইপ: array (object | null)[] | null
উপাদানের আইটেম
- domainটাইপ: string | null
SERP-এ ডোমেইন
- optionsটাইপ: array (object | null)[] | null
আরও সার্চ পরিমার্জনার বিকল্প
- domainটাইপ: string | null
SERP-এ ডোমেইন
- titleটাইপ: string | null
এলিমেন্টের শিরোনাম
- typeটাইপ: string | null
এলিমেন্টের ধরন
- urlটাইপ: string | null
রিফাইনমেন্ট প্যারামিটারসহ সার্চ URL
- titleটাইপ: string | null
এলিমেন্টের শিরোনাম
- typeটাইপ: string | null
এলিমেন্টের ধরন
- urlটাইপ: string | null
রিফাইনমেন্ট প্যারামিটারসহ সার্চ URL
- typeটাইপ: string | null
এলিমেন্টের ধরন
- xpathটাইপ: string | null
এলিমেন্টের XPath
- seটাইপ: string | null
_domain POST অ্যারেতে সার্চ ইঞ্জিন ডোমেইন
- seটাইপ: integer | null ফরম্যাট: int64
_results _count SERP-এ ফলাফলের মোট সংখ্যা
- spellটাইপ: object | null · Response36Afe1097B20_SpellInfo
সার্চ ইঞ্জিনের অটোকরেকশন
সার্চ ইঞ্জিন যদি সংশোধিত কোনো কীওয়ার্ডের জন্য ফলাফল দেয়, তবে আমরা সার্চ ইঞ্জিন যে কীওয়ার্ড সংশোধন করেছে এবং অটোকরেকশনের ধরন উল্লেখ করব- keywordটাইপ: string | null
সার্চ ইঞ্জিন অটোকরেকশনের ফলে পাওয়া কিওয়ার্ড সংশোধিত কিওয়ার্ডের জন্য ফলাফল দেওয়া হবে
- typeটাইপ: string | null
অটোকরেকশনের ধরন সম্ভাব্য মান: did_you_mean, showing_results_for, no_results_found_for, including_results_for নোট: Yahoo ও Yandex শুধু নিচের অটোকরেকশন ধরন সমর্থন করে: including_results_for
- 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/local_finder/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "local nail services",
"min_rating": 4.5,
"time_filter": "monday"
}
]'
{
"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,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"refinement_chips": {
"type": null,
"xpath": null,
"items": [
"[Max Depth Exceeded]"
]
},
"item_types": [
null
],
"se_results_count": null,
"items_count": null,
"items": [
{
"type": "[Max Depth Exceeded]",
"page": "[Max Depth Exceeded]",
"position": "[Max Depth Exceeded]",
"xpath": "[Max Depth Exceeded]",
"rectangle": "[Max Depth Exceeded]",
"rank_group": "[Max Depth Exceeded]",
"rank_absolute": "[Max Depth Exceeded]",
"title": "[Max Depth Exceeded]",
"description": "[Max Depth Exceeded]",
"domain": "[Max Depth Exceeded]",
"phone": "[Max Depth Exceeded]",
"booking_url": "[Max Depth Exceeded]",
"url": "[Max Depth Exceeded]",
"is_paid": "[Max Depth Exceeded]",
"rating": "[Max Depth Exceeded]",
"cid": "[Max Depth Exceeded]"
}
]
}
]
}
]
}