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/task_post

Google Maps SERP টাস্ক সেট করা

Google-এ স্থানীয় কোয়েরির জন্য প্রতিটি ব্যবসার রেটিং, ঠিকানা ও place id-সহ map pack কিউ করে এবং tasks[0].id-এ একটি task id ফেরত দেয়। DataForSEO-র এনভেলপে মোড়া: ডেটা tasks[0].result-এ, ফলাফল tasks[0].status_code-এ — প্রত্যাখ্যাত রিকোয়েস্টও HTTP 200 ফেরত দেয়। লাইভ যমজটি সঙ্গে সঙ্গে উত্তর দেয় এবং একক কোয়েরির জন্য সহজ; ব্যাচ যখন এক টুল কলের ধৈর্যের চেয়ে বেশি সময় নেবে তখন কিউ করুন।

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

মিটারিং: রিপোর্ট করা রেসপন্স খরচ
রেফারেন্স রিকোয়েস্ট অনুমান: USD 0.02
রেফারেন্স গ্রাহক গুণক: 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/{{low_se_name}}/languages-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেন
  
  উদাহরণ:
  
  en
- language_name
  টাইপ: string
  
  সার্চ ইঞ্জিন ভাষার পূর্ণ নাম
  
  language_code নির্দিষ্ট না করলে আবশ্যক ফিল্ড
  
  আপনি এই ফিল্ড ব্যবহার করলে language_code নির্দিষ্ট করার প্রয়োজন নেই
  
  আপনি language_name-সহ সার্চ ইঞ্জিনের উপলব্ধ ভাষার তালিকা https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেন
  
  উদাহরণ:
  
  English
- location_code
  টাইপ: integer
  
  সার্চ ইঞ্জিন অবস্থান কোড
  
  location_name বা location_coordinate নির্দিষ্ট না করলে আবশ্যক ফিল্ড
  
  আপনি এই ফিল্ড ব্যবহার করলে location_name বা location_coordinate নির্দিষ্ট করার প্রয়োজন নেই
  
  আপনি location_code-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকা https://api.dataforseo.com/v3/serp/{{low_se_name}}/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/{{low_se_name}}/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
- pingback_url
  টাইপ: string | null
  
  সম্পন্ন টাস্কের নোটিফিকেশন URL
  
  ঐচ্ছিক ফিল্ড
  
  কোনো টাস্ক সম্পন্ন হলে আপনার নির্দিষ্ট করা URL-এ পাঠানো GET রিকোয়েস্টের মাধ্যমে আমরা আপনাকে জানাব
  
  আপনি ‘$id’ স্ট্রিংকে $id ভেরিয়েবল হিসেবে এবং ‘$tag’কে urlencoded $tag ভেরিয়েবল হিসেবে ব্যবহার করতে পারেন। রিকোয়েস্ট পাঠানোর আগে আমরা প্রয়োজনীয় মান সেট করব।
  
  উদাহরণ:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  নোট: pingback_url-এর বিশেষ অক্ষর urlencoded করা হবে;
  
  অর্থাৎ, # অক্ষর %23-এ এনকোড করা হবে
  
  আমাদের Help Center-এ আরও জানুন
- postback_data
  টাইপ: string
  
  postback_url ডেটাটাইপ
  
  postback_url নির্দিষ্ট করলে আবশ্যক ফিল্ড
  
  টাস্ক সেট করতে আপনি যে ফাংশন ব্যবহার করেছেন তার সঙ্গে মেলে
  
  সম্ভাব্য মান:
  
  advanced
- postback_url
  টাইপ: string | null
  
  টাস্কের ফলাফল পাঠানোর URL
  
  ঐচ্ছিক ফিল্ড
  
  টাস্ক সম্পন্ন হলে আমরা gzip ফরম্যাটে সংকুচিত ফলাফলসহ একটি POST রিকোয়েস্ট আপনার নির্দিষ্ট করা postback_url-এ পাঠাব
  
  আপনি ‘$id’ স্ট্রিংকে $id ভেরিয়েবল হিসেবে এবং ‘$tag’কে urlencoded $tag ভেরিয়েবল হিসেবে ব্যবহার করতে পারেন। রিকোয়েস্ট পাঠানোর আগে আমরা প্রয়োজনীয় মান সেট করব।
  
  উদাহরণ:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  নোট: postback_url-এর বিশেষ অক্ষর urlencode করা হবে;
  
  যেমন, # অক্ষরটি %23 হিসেবে এনকোড হবে
  
  আমাদের Help Center-এ আরও জানুন
- priority
  টাইপ: integer | null
  
  টাস্কের অগ্রাধিকার
  
  ঐচ্ছিক ফিল্ড
  
  নিম্নলিখিত মান নিতে পারে:
  
  1 – সাধারণ সম্পাদন অগ্রাধিকার (ডিফল্টভাবে সেট)
  
  2 – উচ্চ সম্পাদন অগ্রাধিকার
  
  উচ্চ সম্পাদন অগ্রাধিকারযুক্ত টাস্কের জন্য অতিরিক্ত চার্জ নেওয়া হবে।
  খরচ Pricing পেজে হিসাব করা যায়।
- se_domain
  টাইপ: string | null
  
  সার্চ ইঞ্জিন ডোমেইন
  
  ঐচ্ছিক ফিল্ড
  
  আপনার নির্দিষ্ট অবস্থান ও ভাষা অনুযায়ী আমরা প্রাসঙ্গিক সার্চ ইঞ্জিন ডোমেইন স্বয়ংক্রিয়ভাবে বেছে নিই
  
  তবে, আপনি এই ফিল্ডে একটি কাস্টম সার্চ ইঞ্জিন ডোমেইন সেট করতে পারেন
  
  উদাহরণ:
  
  google.co.uk
- 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_SerpGoogleMapsTaskPostResponseInfo
cost
টাইপ: number | null ফরম্যাট: double

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

status_code
টাইপ: integer | null

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

status_message
টাইপ: string | null

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

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

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

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

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

data
টাইপ: object | null

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

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

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

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

URL পাথ

result
টাইপ: object | null

ফলাফলের অ্যারে
এই ক্ষেত্রে মান 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/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/maps/task_post \
  --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": null
    }
  ]
}

সফল অপারেশন

Google Maps SERP টাস্ক সেট করা

প্রমাণীকরণRequired

DataForSEO

Google Maps SERP টাস্ক সেট করা

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