লাইভ Google Maps SERP

Felo API Support

MIT

সার্ভার

https://openapi.felo.ai

ক্লায়েন্ট লাইব্রেরি

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO অপারেশন

post/v1/beta/dataforseo/serp/google/maps/live/advanced

লাইভ Google Maps SERP

Google-এ স্থানীয় কোয়েরির জন্য map pack সিঙ্ক্রোনাসভাবে ফেরত দেয়, যাতে প্রতিটি ব্যবসার রেটিং, ঠিকানা ও place id থাকে। 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.002
রেফারেন্স গ্রাহক গুণক: 1.0। নিষ্পত্তিকৃত গ্রাহক অঙ্কে এটি আবার প্রয়োগ করবেন না।

এটি কেবল রেফারেন্স মেটাডেটা; অ্যাকাউন্টের কোটেশন, নিশ্চিত মূল্য বা ব্যয়সীমা নয়। রিসোর্স ক্রেডিট Felo ক্রেডিট নয়। চূড়ান্ত চার্জ Felo-এর বিলিং রেকর্ড অনুযায়ী হয়।

বডি

application/json

টাইপ: array (object | null)[]
- depth
  টাইপ: integer | null
  
  পার্সিং গভীরতা
  
  ঐচ্ছিক ফিল্ড
  
  SERP-এ ফলাফলের সংখ্যা
  
  ডিফল্ট মান: 100
  
  সর্বোচ্চ মান: 700
  
  সর্বোচ্চ 100টি ফলাফল থাকা প্রতিটি SERP-এর জন্য আপনার অ্যাকাউন্ট থেকে বিল নেওয়া হবে;
  100-এর বেশি গভীরতা সেট করলে অতিরিক্ত চার্জ হতে পারে যদি সার্চ ইঞ্জিন 100টির বেশি ফলাফল ফেরত দেয়;
  
  খরচ Pricing পেজে হিসাব করা যায়।
- device
  টাইপ: string | null
  
  ডিভাইসের ধরন
  
  ঐচ্ছিক ফিল্ড
  
  নির্দিষ্ট ডিভাইস ধরনের জন্য ফলাফল ফেরত দেয়
  
  এই মানগুলো নিতে পারে:desktop, mobile
  
  ডিফল্ট মান: desktop
  
  নোট: mobile ডিভাইসের জন্য প্রতিটি SERP-এ কেবল 20টি ফলাফল ফেরত দেওয়া হয়
- keyword
  টাইপ: string
  
  কীওয়ার্ড
  
  আবশ্যক ফিল্ড
  
  keyword ফিল্ডে সর্বোচ্চ 700 অক্ষর নির্দিষ্ট করা যায়
  
  সব %## ডিকোড করা হবে (সঙ্গে ‘+’ অক্ষরটি স্পেস অক্ষরে ডিকোড হবে)
  
  আপনার keyword-এ “%” অক্ষর ব্যবহার করতে চাইলে তা “%25” হিসেবে নির্দিষ্ট করুন;
  
  আপনার keyword-এ “+” অক্ষর ব্যবহার করতে চাইলে তা “%2B” হিসেবে নির্দিষ্ট করুন;
  
  DataForSEO API-তে keyword ও keywords ফিল্ডের নিয়ম ও সীমাবদ্ধতা সম্পর্কে এই Help Center নিবন্ধে আরও জানুন
- language_code
  টাইপ: string
  
  সার্চ ইঞ্জিন ভাষা কোড
  
  language_name নির্দিষ্ট না করলে আবশ্যক ফিল্ড
  
  আপনি এই ফিল্ড ব্যবহার করলে language_name নির্দিষ্ট করার প্রয়োজন নেই
  
  আপনি language_code -সহ সার্চ ইঞ্জিনের উপলব্ধ ভাষার তালিকা https://api.dataforseo.com/v3/serp/google/languages-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেন
  
  উদাহরণ:
  
  en
- language_name
  টাইপ: string
  
  সার্চ ইঞ্জিন ভাষার পূর্ণ নাম
  
  language_code নির্দিষ্ট না করলে আবশ্যক ফিল্ড
  
  আপনি এই ফিল্ড ব্যবহার করলে language_code নির্দিষ্ট করার প্রয়োজন নেই
  
  আপনি language_name-সহ সার্চ ইঞ্জিনের উপলব্ধ ভাষার তালিকা https://api.dataforseo.com/v3/serp/google/languages-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেন
  
  উদাহরণ:
  
  English
- location_code
  টাইপ: integer
  
  সার্চ ইঞ্জিন অবস্থান কোড
  
  আবশ্যক ফিল্ড যদি আপনি location_name বা location_coordinate নির্দিষ্ট না করেন
  
  আপনি এই ফিল্ড ব্যবহার করলে location_name বা location_coordinate নির্দিষ্ট করার প্রয়োজন নেই
  
  আপনি location_code-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকা https://api.dataforseo.com/v3/serp/google/locations-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেন
  
  উদাহরণ:
  
  2840
- location_coordinate
  টাইপ: string
  
  অবস্থানের GPS স্থানাঙ্ক
  
  location_name বা location_code নির্দিষ্ট না করলে আবশ্যক ফিল্ড
  
  আপনি এই ফিল্ড ব্যবহার করলে location_name বা location_code নির্দিষ্ট করার প্রয়োজন নেই
  
  location_coordinate প্যারামিটার "latitude,longitude,zoom" ফরম্যাটে নির্দিষ্ট করতে হবে
  
  "zoom" নির্দিষ্ট না থাকলে ডিফল্ট মান হিসেবে 17z প্রয়োগ হবে
  
  "latitude" ও "longitude"-এর জন্য সর্বোচ্চ দশমিক অঙ্ক: 7
  
  "zoom"-এর সর্বনিম্ন মান: 3z
  
  "zoom"-এর সর্বোচ্চ মান: 21z
  
  উদাহরণ:
  
  52.6178549,-155.352142,20z
- location_name
  টাইপ: string
  
  সার্চ ইঞ্জিন অবস্থানের পূর্ণ নাম
  
  আবশ্যক ফিল্ড যদি আপনি location_code বা location_coordinate নির্দিষ্ট না করেন
  
  আপনি এই ফিল্ড ব্যবহার করলে location_code বা location_coordinate নির্দিষ্ট করার প্রয়োজন নেই
  
  আপনি location_name-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকা https://api.dataforseo.com/v3/serp/google/locations-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেন
  
  উদাহরণ:
  
  London,England,United Kingdom
- max_crawl_pages
  টাইপ: integer | null
  
  পেজ ক্রল সীমা
  
  ঐচ্ছিক ফিল্ড
  
  ক্রল করা সার্চ ফলাফল পেজের সংখ্যা
  
  সর্বোচ্চ মান: 100
  
  নোট: max_crawl_pages ও depth প্যারামিটার একে অপরের পরিপূরক;
  
  আমাদের Help Center-এ আরও জানুন
- os
  টাইপ: string | null
  
  ডিভাইস অপারেটিং সিস্টেম
  
  ঐচ্ছিক ফিল্ড
  
  device ফিল্ডে desktop নির্দিষ্ট করলে নিচের মধ্যে থেকে বেছে নিন: windows, macos
  
  ডিফল্ট মান: windows
  
  device ফিল্ডে mobile নির্দিষ্ট করলে নিচের মধ্যে থেকে বেছে নিন: android, ios
  
  ডিফল্ট মান: android
- se_domain
  টাইপ: string | null
  
  সার্চ ইঞ্জিন ডোমেইন
  
  ঐচ্ছিক ফিল্ড
  
  আপনার নির্দিষ্ট অবস্থান ও ভাষা অনুযায়ী আমরা প্রাসঙ্গিক সার্চ ইঞ্জিন ডোমেইন স্বয়ংক্রিয়ভাবে বেছে নিই
  
  তবে, আপনি এই ফিল্ডে একটি কাস্টম সার্চ ইঞ্জিন ডোমেইন সেট করতে পারেন
  
  উদাহরণ:
  
  google.co.uk, google.com.au, google.de, ইত্যাদি
- search_places
  টাইপ: boolean | null
  
  স্থান অনুসন্ধান মোড
  
  ঐচ্ছিক ফিল্ড
  
  স্থান অনুসন্ধান মোড কোনো নির্দিষ্ট স্থানের (যেমন নিউ ইয়র্কের Apple Store) Google Maps ফলাফল পেতে দেয়
  
  তবে আমাদের ডেটা মাইনিং অ্যালগরিদমের বৈশিষ্ট্যের কারণে এই মোড কিছু লোকাল-ইনটেন্ট কুয়েরিতে বাধা দিতে পারে - এবং রিকোয়েস্টে নির্দিষ্ট করা স্থানের চেয়ে ভিন্ন স্থানের ফলাফল দেখাতে পারে;
  
  এই বাধা রোধ করতে এবং লোকাল ইনটেন্টযুক্ত কীওয়ার্ডের সঠিক ফলাফল পেতে আপনি এই প্যারামিটারটি false সেট করতে পারেন;
  
  ডিফল্ট মান: true
  
  নোট: search_places মোড বন্ধ থাকলে এবং অনুসন্ধান এলাকায় কোনো ফলাফল না পাওয়া গেলে results অ্যারে খালি থাকবে
- search_this_area
  টাইপ: boolean | null
  
  প্রদর্শিত এলাকার ফলাফল দেখান
  
  ঐচ্ছিক ফিল্ড
  
  এই মানগুলো নিতে পারে:true, false
  
  ডিফল্ট মান: true
  
  false সেট করা হলে search_this_area মোড বন্ধ হয়ে যাবে
  
  নোট: search_this_area মোড বন্ধ থাকলে Google Maps লিস্টিং-এ প্রদর্শিত এলাকার বাইরের ফলাফল থাকতে পারে
- tag
  টাইপ: string | null
  
  ব্যবহারকারী-নির্ধারিত টাস্ক আইডেন্টিফায়ার
  
  ঐচ্ছিক ফিল্ড
  
  অক্ষরের সীমা 255
  
  আপনি এই প্যারামিটার দিয়ে টাস্ক শনাক্ত করে তা ফলাফলের সঙ্গে মেলাতে পারেন
  
  আপনি নির্দিষ্ট tag মান response-এর data অবজেক্টে পাবেন
- url
  টাইপ: string | null
  
  সার্চ কোয়েরির সরাসরি URL
  
  ঐচ্ছিক ফিল্ড
  
  আপনি একটি সরাসরি URL নির্দিষ্ট করতে পারেন এবং আমরা সেটি প্রয়োজনীয় ফিল্ডে ভাগ করে নেব। মনে রাখবেন, এই পদ্ধতি আমাদের API-এর জন্য প্রক্রিয়া করা সবচেয়ে কঠিন এবং URL-এ সঠিক ভাষা ও অবস্থান নির্দিষ্ট করাও প্রয়োজন। বেশিরভাগ ক্ষেত্রে আমরা এই পদ্ধতি ব্যবহার করার পরামর্শ দিই না।
  
  উদাহরণ:
  
  https://google.com/maps/search/pizza/@37.09024,-95.712891,4z
  
  নোট: নিম্নলিখিত সার্চ ইঞ্জিন প্যারামিটার সমর্থিত নয় এবং URL-এ নির্দিষ্ট করলে স্বয়ংক্রিয়ভাবে আনসেট হয়ে যাবে: allinanchor:, allintext:, allintitle:, allinurl:, cache:, define:, definition:, filetype:, id:, inanchor:, info:, intext:, intitle:, inurl:, link:, site:.

রেসপন্স

200
টাইপ: object | null · Response36Afe1097B20_SerpGoogleMapsLiveAdvancedResponseInfo
cost
টাইপ: number | null ফরম্যাট: double

টাস্কের মোট খরচ, USD

status_code
টাইপ: integer | null

সাধারণ স্ট্যাটাস কোড সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন

status_message
টাইপ: string | null

সাধারণ তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন

tasks
টাইপ: array (object | null)[] | null

টাস্কের অ্যারে

টাইপ: object | null · Response36Afe1097B20_SerpGoogleMapsLiveAdvancedTaskInfo
cost
টাইপ: number | null ফরম্যাট: double

টাস্কের মোট খরচ, USD

data
টাইপ: object | null

এতে POST রিকোয়েস্টে আপনি যে প্যারামিটারগুলো নির্দিষ্ট করেছিলেন সেগুলোই থাকে

propertyName
টাইপ: object | null
id
টাইপ: string | null

টাস্ক আইডেন্টিফায়ার আমাদের সিস্টেমে অনন্য টাস্ক আইডেন্টিফায়ার, UUID ফরম্যাটে

path
টাইপ: array (string | null)[] | null

URL পাথ

result
টাইপ: array (object | null)[] | null

ফলাফলের অ্যারে

check_url
টাইপ: string | null

সার্চ ইঞ্জিন ফলাফলের সরাসরি URL
আমরা সঠিক ফলাফল দিয়েছি কি না তা নিশ্চিত করতে এটি ব্যবহার করতে পারেন
নোট: অবস্থান-নির্দিষ্ট ফলাফল যাচাই করতে দেওয়া চেক url-এ যান, উপরে-নিচে স্ক্রল করুন, তারপর "Search this area" বাটনে ক্লিক করুন

datetime
টাইপ: string | null

ফলাফল পাওয়ার তারিখ ও সময়
UTC ফরম্যাটে: “yyyy-mm-dd hh-mm-ss +00:00”
উদাহরণ:
2019-11-15 12:57:46 +00:00

item_types
টাইপ: array (string | null)[] | null

SERP-এ সার্চ ফলাফলের ধরন
SERP-এ পাওয়া সার্চ ফলাফলের (items) ধরন রয়েছে।
সম্ভাব্য আইটেম ধরন:
maps_search, maps_paid_item

items
টাইপ: array (object | null)[] | null

এলিমেন্টের আইটেম

domain
টাইপ: string | null

SERP-এ ডোমেইন

rank_absolute
টাইপ: integer | null

SERP-এ পরম র‍্যাংক
SERP-এর সব এলিমেন্টের মধ্যে পরম অবস্থান

rank_group
টাইপ: integer | null

SERP-এ গ্রুপ র‍্যাংক
একই type মানের এলিমেন্টের গ্রুপের মধ্যে অবস্থান
ভিন্ন type মানের এলিমেন্টের অবস্থান rank_group থেকে বাদ দেওয়া হয়

rating
টাইপ: object | null · Response36Afe1097B20_RatingInfo

এলিমেন্টের রেটিং
রিভিউয়ের ভিত্তিতে জনপ্রিয়তার হার, যা SERP-এ দেখানো হয়

rating_max
টাইপ: integer | null

rating_type-এর সর্বোচ্চ মান

rating_type
টাইপ: string | null

রেটিংয়ের ধরন এখানে আপনি নিম্নলিখিত উপাদান পাবেন: Max5, Percents, CustomMax

value
টাইপ: number | null ফরম্যাট: double

রেটিংয়ের মান

votes_count
টাইপ: integer | null ফরম্যাট: int64

ফিডব্যাকের পরিমাণ

rating_distribution
টাইপ: object | null

ব্যবসায়িক সত্তার রেটিংয়ের বণ্টন
অবজেক্টটি ব্যবহারকারীদের রিভিউ অনুযায়ী 1-স্টার থেকে 5-স্টার রেটিংয়ের সংখ্যা দেখায়

propertyName
টাইপ: integer | null ফরম্যাট: Int64
title
টাইপ: string | null

এলিমেন্টের শিরোনাম

type
টাইপ: string | null

এলিমেন্টের ধরন

url
টাইপ: string | null

রিফাইনমেন্ট প্যারামিটারসহ সার্চ URL

items_count
টাইপ: integer | null ফরম্যাট: int64

items অ্যারেতে ফেরত দেওয়া ফলাফলের সংখ্যা

keyword
টাইপ: string | null

POST অ্যারেতে পাওয়া কিওয়ার্ড
কিওয়ার্ড ডিকোড করা %## সহ ফেরত আসে ('+' অক্ষর একটি স্পেসে ডিকোড হয়)

language_code
টাইপ: string | null

POST অ্যারেতে ভাষা কোড

location_code
টাইপ: integer | null

POST অ্যারেতে অবস্থান কোড

refinement_chips
টাইপ: object | null · Response36Afe1097B20_RefinementChipsInfo

সার্চ রিফাইনমেন্ট চিপ

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_domain
টাইপ: string | null

POST অ্যারেতে সার্চ ইঞ্জিন ডোমেইন

se_results_count
টাইপ: integer | null ফরম্যাট: int64

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_count
টাইপ: integer | null ফরম্যাট: int64

result অ্যারেতে এলিমেন্টের সংখ্যা

status_code
টাইপ: integer | null

টাস্কের স্ট্যাটাস কোড DataForSEO কর্তৃক তৈরি, যা নিম্নলিখিত পরিসরে হতে পারে: 10000-60000 সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন

status_message
টাইপ: string | null

টাস্কের তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন

time
টাইপ: string | null

সম্পাদনের সময়, সেকেন্ড

tasks_count
টাইপ: integer | null ফরম্যাট: int64

tasks অ্যারেতে টাস্কের সংখ্যা

tasks_error
টাইপ: integer | null ফরম্যাট: int64

ত্রুটিসহ ফেরত দেওয়া tasks অ্যারেতে টাস্কের সংখ্যা

time
টাইপ: string | null

মোট সম্পাদন সময়, সেকেন্ড

version
টাইপ: string | null

API-এর বর্তমান সংস্করণ
application/json
400

রিকোয়েস্ট প্রক্রিয়া করা যায়নি। রিকোয়েস্ট প্যারামিটার যাচাই করুন।
401

একটি বৈধ Felo API key আবশ্যক।
402

বিলিং শর্ত পূরণ না হওয়ায় রিকোয়েস্ট এগোতে পারছে না।
403

অ্যাকাউন্টটিকে এই অপারেশন করার অনুমতি নেই।
429

রিকোয়েস্ট বা ব্যয়ের সীমায় পৌঁছে গেছে।
502

পরিষেবা রিকোয়েস্টটি সম্পন্ন করতে পারেনি।
503

API বা বিলিং পরিষেবা সাময়িকভাবে অনুপলভ্য।
504

রিকোয়েস্ট প্রক্রিয়াকরণের সময় পরিষেবার সময় শেষ হয়ে গেছে।
default

ত্রুটি রেসপন্স; আপস্ট্রিম passthrough রেসপন্স প্রোভাইডারের ফর্ম্যাট ব্যবহার করতে পারে।

application/json

post/v1/beta/dataforseo/serp/google/maps/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/maps/live/advanced \
  --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,
          "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": null,
              "rank_group": null,
              "rank_absolute": null,
              "domain": null,
              "title": null,
              "url": null,
              "rating": "[Max Depth Exceeded]",
              "rating_distribution": null
            }
          ]
        }
      ]
    }
  ]
}

সফল অপারেশন

লাইভ Google Maps SERP

প্রমাণীকরণRequired

DataForSEO

লাইভ Google Maps SERP

মূল্য রেফারেন্স