DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google হোটেল সার্চ টাস্ক সেট করুন
Google Hotels সার্চ কিউ করে, একটি টাস্ক id ফেরত দেয়। DataForSEO-এর এনভেলপে মোড়ানো: ডেটা tasks[0].result-এ, ফলাফল tasks[0].status_code-এ - প্রত্যাখ্যাত রিকোয়েস্টও HTTP 200 ফেরত দেয়। get_dataforseo_business_google_hotel_searches_fetch দিয়ে পুনরুদ্ধার করুন।
মূল্য রেফারেন্স
- মিটারিং: রিপোর্ট করা রেসপন্স খরচ
- রেফারেন্স রিকোয়েস্ট অনুমান: USD 0.2428
- রেফারেন্স গ্রাহক গুণক: 1.0। ইতিমধ্যে নিষ্পত্তি হওয়া গ্রাহক অর্থের উপর এটি আবার প্রয়োগ করবেন না
শুধুমাত্র রেফারেন্স মেটাডেটা, কোনো অ্যাকাউন্ট কোটেশন, নিশ্চিত মূল্য বা ব্যয়সীমা নয়। রিসোর্স ক্রেডিট Felo ক্রেডিট নয়। চূড়ান্ত চার্জ Felo বিলিং রেকর্ড অনুযায়ী হয়।
- টাইপ: array (object | null)[]
- adultsটাইপ: integer | null
প্রাপ্তবয়স্কের সংখ্যা
ঐচ্ছিক ফিল্ড
আপনি এই ফিল্ড নির্দিষ্ট না করলে ডিফল্ট মান2প্রয়োগ করা হবে;
নোট যে আপনি প্রাপ্তবয়স্ক ও শিশুসহ সর্বোচ্চ 6 জন নির্দিষ্ট করতে পারেন
উদাহরণ:1 - amenitiesটাইপ: array string[] | null
হোটেলের সুবিধা
ঐচ্ছিক ফিল্ড
এই ফিল্ড দিয়ে বিভিন্ন হোটেল সুবিধা নির্দিষ্ট করতে পারেন
উদাহরণ:[
"free_parking",
"pets_allowed"
]
সম্ভাব্য মান:"air_conditioning",
"all_inclusive_available",
"bar",
"free_breakfast",
"fitness_center",
"kid_friendly",
"free_parking",
"pets_allowed",
"pool",
"restaurant",
"room_service",
"spa",
"free_wifi",
"parking",
"indoor_pool",
"outdoor_pool",
"wheelchair_accessible",
"beach_access" - checkটাইপ: string | null
_in চেক-ইন তারিখ
ঐচ্ছিক ফিল্ড
আপনি এই ফিল্ড নির্দিষ্ট না করলে ডিফল্টভাবে আগামীকালের তারিখ ব্যবহার করা হবে;
তারিখের ফরম্যাট:"yyyy-mm-dd"
উদাহরণ:"2019-01-15"
নোট: মান আজকের তারিখের আগের হতে পারবে না - checkটাইপ: string | null
_out চেক-আউট তারিখ
ঐচ্ছিক ফিল্ড
আপনি এই ফিল্ড নির্দিষ্ট না করলে আমাদের সিস্টেম ডিফল্টভাবে আজ থেকে দুই দিন পরের তারিখ প্রয়োগ করবে;
তারিখের ফরম্যাট:"yyyy-mm-dd"
উদাহরণ:"2019-01-15"
নোট: মানcheck_in-এর সমান বা তার কম হতে পারবে না;check_inওcheck_outমানের মধ্যে ব্যবধান 30 দিনের বেশি হতে পারবে না - childrenটাইপ: array string[] | null
শিশুর সংখ্যা ও বয়স
ঐচ্ছিক ফিল্ড
আপনি এই ফিল্ড নির্দিষ্ট না করলে অনুসন্ধানে কোনো শিশু অন্তর্ভুক্ত হবে না;
শিশুর বয়স0থেকে17পর্যন্ত হতে পারে;
নোট যে আপনি প্রাপ্তবয়স্ক ও শিশুসহ সর্বোচ্চ 6 জন নির্দিষ্ট করতে পারেন
একজন 14 বছর বয়সী শিশু অন্তর্ভুক্ত করতে নিম্নলিখিত মান সেট করুন:[14]
একজন 13 বছর বয়সী ও একজন 8 বছর বয়সী শিশু অন্তর্ভুক্ত করতে নিম্নলিখিত মান সেট করুন:[13,8] - currencyটাইপ: string | null
মুদ্রা
ঐচ্ছিক ফিল্ড
উদাহরণ:"USD" - depthটাইপ: integer | null
পার্সিং গভীরতা
ঐচ্ছিক ফিল্ড
Google Hotels-এ ফলাফলের সংখ্যা
ডিফল্ট মান:18অর্গানিক ফলাফল
সর্বোচ্চ মান:140
নোট: response-এ পেইড লিস্টিং থাকুক বা না থাকুক, প্রতি 18টি অর্গানিক ফলাফলের জন্য আপনার অ্যাকাউন্ট থেকে বিল নেওয়া হবে;
তাই,18-এর বেশি গভীরতা সেট করলে অতিরিক্ত চার্জ হতে পারে যদি Google Hotels 18টির বেশি ফলাফল ফেরত দেয়;
নির্দিষ্ট গভীরতা response-এর ফলাফল সংখ্যার চেয়ে বেশি হলে পার্থক্যটি স্বয়ংক্রিয়ভাবে আপনার অ্যাকাউন্ট ব্যালেন্সে ফেরত দেওয়া হবে - freeটাইপ: boolean | null
_cancellation বিনামূল্যে বাতিলযোগ্য হোটেল
ঐচ্ছিক ফিল্ড
আপনি বিনামূল্যে রিজার্ভেশন বাতিলযোগ্য হোটেলের তালিকা চাইলে এই ফিল্ডtrueসেট করুন
ডিফল্ট মান:false - isটাইপ: boolean | null
_vacation _rentals ভেকেশন রেন্টাল খুঁজুন
ঐচ্ছিক ফিল্ড
আপনি হোটেলের বদলে ভেকেশন রেন্টালের তালিকা চাইলে এই ফিল্ডtrueসেট করুন
ডিফল্ট মান:false - keywordটাইপ: string | null
কীওয়ার্ড
ঐচ্ছিক ফিল্ড
আপনার নির্দিষ্ট কীওয়ার্ড হোটেলের তালিকা খুঁজতে ব্যবহার করা হয়;
আপনি এই ফিল্ড ব্যবহার না করলে নির্দিষ্ট অবস্থানে পাওয়া হোটেলের তালিকা ফেরত দেওয়া হবে;
আপনিkeywordফিল্ডে সর্বোচ্চ 700 অক্ষর নির্দিষ্ট করতে পারেন
সব %## ডিকোড করা হবে (‘+’ অক্ষরও স্পেস অক্ষরে ডিকোড হবে)
আপনারkeyword-এ “%” অক্ষর ব্যবহার করতে হলে তা “%25” হিসেবে নির্দিষ্ট করুন;
নোট: সঠিক অনুসন্ধান ফলাফল পেতে কীওয়ার্ডের সঙ্গে অবস্থানের নাম স্বয়ংক্রিয়ভাবে যুক্ত হয়DataForSEO APIs-এ
keywordওkeywordsফিল্ডের নিয়ম ও সীমাবদ্ধতা সম্পর্কে এই Help Center নিবন্ধে আরও জানুন - languageটাইপ: string
_code সার্চ ইঞ্জিন ভাষা কোড
language_nameনির্দিষ্ট না করলে আবশ্যক ফিল্ড
আপনি এই ফিল্ড ব্যবহার করলেlanguage_nameনির্দিষ্ট করার প্রয়োজন নেই
আপনিlanguage_code-সহ উপলব্ধ ভাষার তালিকাhttps://api.dataforseo.com/v3/business_data/google/languages-এ আলাদা রিকোয়েস্ট পাঠিয়ে পেতে পারেন
উদাহরণ:en - languageটাইপ: string
_name সার্চ ইঞ্জিন ভাষার পূর্ণ নাম
language_codeনির্দিষ্ট না করলে আবশ্যক ফিল্ড
আপনি এই ফিল্ড ব্যবহার করলেlanguage_codeনির্দিষ্ট করার প্রয়োজন নেই
আপনিlanguage_name-সহ উপলব্ধ ভাষার তালিকাhttps://api.dataforseo.com/v3/business_data/google/languages-এ আলাদা রিকোয়েস্ট পাঠিয়ে পেতে পারেন
উদাহরণ:English - locationটাইপ: integer
_code সার্চ ইঞ্জিন অবস্থান কোড
location_nameবাlocation_coordinateনির্দিষ্ট না করলে আবশ্যক ফিল্ড
আপনি এই ফিল্ড ব্যবহার করলেlocation_nameবাlocation_coordinateনির্দিষ্ট করার প্রয়োজন নেই
আপনিlocation_code-সহ উপলব্ধ অবস্থানের তালিকাhttps://api.dataforseo.com/v3/business_data/google/locations-এ আলাদা রিকোয়েস্ট পাঠিয়ে পেতে পারেন
উদাহরণ:2840 - locationটাইপ: string
_coordinate অবস্থানের GPS স্থানাঙ্ক
location_nameবাlocation_codeনির্দিষ্ট না করলে আবশ্যক ফিল্ড
আপনি এই ফিল্ড ব্যবহার করলেlocation_nameবাlocation_codeনির্দিষ্ট করার প্রয়োজন নেইlocation_coordinateপ্যারামিটার "latitude,longitude" ফরম্যাটে নির্দিষ্ট করতে হবে
"latitude" ও "longitude"-এর জন্য দশমিক অঙ্কের সর্বোচ্চ সংখ্যা: 7
নোট: অবস্থান নির্ধারণে স্থানাঙ্ক ব্যবহার করা হলে অনুসন্ধান নিকটতম জনবসতিতে হবে;
উদাহরণ:53.476225,-2.243572 - locationটাইপ: string
_name সার্চ ইঞ্জিন অবস্থানের পূর্ণ নাম
location_codeবাlocation_coordinateনির্দিষ্ট না করলে আবশ্যক ফিল্ড
আপনি এই ফিল্ড ব্যবহার করলেlocation_codeবাlocation_coordinateনির্দিষ্ট করার প্রয়োজন নেই
আপনিlocation_name-সহ উপলব্ধ অবস্থানের তালিকাhttps://api.dataforseo.com/v3/business_data/google/locations-এ আলাদা রিকোয়েস্ট পাঠিয়ে পেতে পারেন
উদাহরণ:London,England,United Kingdom
নোট: সঠিক অনুসন্ধান ফলাফল পেতে আপনার নির্দিষ্টlocation_nameস্বয়ংক্রিয়ভাবে কীওয়ার্ডের সঙ্গে যুক্ত হবে - maxটাইপ: integer | null
_price প্রতি রাতে সর্বোচ্চ মূল্য
ঐচ্ছিক ফিল্ড
এই মানের মুদ্রাcurrencyফিল্ডের উপর নির্ভর করে
উদাহরণ:600 - minটাইপ: integer | null
_price প্রতি রাতে সর্বনিম্ন মূল্য
ঐচ্ছিক ফিল্ড
এই মানের মুদ্রাcurrencyফিল্ডের উপর নির্ভর করে
উদাহরণ:100 - minটাইপ: number | null
_rating সর্বনিম্ন রেটিং
ঐচ্ছিক ফিল্ড
এই ফিল্ড দিয়ে একটি নির্দিষ্ট মানের চেয়ে বেশি গেস্ট রেটিং নির্দিষ্ট করতে পারেন
উদাহরণ:2.5 - pingbackটাইপ: string | null
_url সম্পন্ন টাস্কের নোটিফিকেশন URL
ঐচ্ছিক ফিল্ড
টাস্ক সম্পন্ন হলে আমরা আপনার নির্দিষ্ট URL-এ GET রিকোয়েস্ট পাঠিয়ে জানাব
আপনি ‘$id’ স্ট্রিংকে$idভ্যারিয়েবল এবং ‘$tag’ কে URL-এনকোডেড$tagভ্যারিয়েবল হিসেবে ব্যবহার করতে পারেন। রিকোয়েস্ট পাঠানোর আগে আমরা প্রয়োজনীয় মান সেট করব।
উদাহরণ:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
নোট:pingback_url-এ বিশেষ অক্ষর URL-এনকোড করা হবে;
অর্থাৎ,#অক্ষরটি%23-এ এনকোড হবে - postbackটাইপ: string | null
_url টাস্কের ফলাফল পাঠানোর URL
ঐচ্ছিক ফিল্ড
টাস্ক সম্পন্ন হলে আমরা তার ফলাফলgzipফরম্যাটে কম্প্রেস করে আপনার নির্দিষ্টpostback_url-এ POST রিকোয়েস্ট পাঠাব
আপনি ‘$id’ স্ট্রিংকে$idভ্যারিয়েবল এবং ‘$tag’ কে URL-এনকোডেড$tagভ্যারিয়েবল হিসেবে ব্যবহার করতে পারেন। রিকোয়েস্ট পাঠানোর আগে আমরা প্রয়োজনীয় মান সেট করব।
উদাহরণ:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
নোট:postback_url-এ বিশেষ অক্ষর URL-এনকোড করা হবে;
অর্থাৎ,#অক্ষরটি%23-এ এনকোড হবে - priorityটাইপ: integer | null
- searchটাইপ: boolean | null
_this _area - sortটাইপ: string | null
_by ফলাফল সাজানোর প্যারামিটার
ঐচ্ছিক ফিল্ড
এই ফিল্ড দিয়ে ফলাফল সাজাতে পারেন
সম্ভাব্য সাজানোর ধরন:relevance– সবচেয়ে প্রাসঙ্গিক অনুসারে সাজানlowest_price– সর্বনিম্ন মূল্য অনুসারে সাজানhighest_rating– সর্বোচ্চ রেটিং অনুসারে সাজানmost_reviewed– সর্বাধিক পর্যালোচিত অনুসারে সাজান
ডিফল্ট মান:relevance - starsটাইপ: array string[] | null
হোটেল স্টার
ঐচ্ছিক ফিল্ড
আপনি শুধু 5-স্টার হোটেলের তালিকা চাইলে এই ফিল্ড[5]সেট করুন
উদাহরণ:[3,4,5] - tagটাইপ: string | null
ব্যবহারকারী-নির্ধারিত টাস্ক আইডেন্টিফায়ার
ঐচ্ছিক ফিল্ড
অক্ষরসীমা 255
এই প্যারামিটার দিয়ে টাস্ক শনাক্ত করে ফলাফলের সঙ্গে মিলিয়ে নিতে পারেন
নির্দিষ্টtagমান response-এরdataঅবজেক্টে পাবেন
- টাইপ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostResponseInfo200
- টাইপ: number | null ফরম্যাট: doublecost
টাস্কের মোট খরচ, USD
- টাইপ: integer | nullstatus
_code সাধারণ স্ট্যাটাস কোড সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন
- টাইপ: string | nullstatus
_message সাধারণ তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন
- টাইপ: array (object | null)[] | nulltasks
টাস্কের অ্যারে
- টাইপ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostTaskInfo
- costটাইপ: number | null ফরম্যাট: double
টাস্কের মোট খরচ, USD
- dataটাইপ: object | null
এতে POST রিকোয়েস্টে আপনি যে প্যারামিটারগুলো নির্দিষ্ট করেছিলেন সেগুলোই থাকে
- propertyটাইপ: object | null
Name
- idটাইপ: string | null
টাস্ক আইডেন্টিফায়ার আমাদের সিস্টেমে অনন্য টাস্ক আইডেন্টিফায়ার, UUID ফরম্যাটে
- pathটাইপ: array (string | null)[] | null
URL পাথ
- resultটাইপ: object | null
ফলাফলের অ্যারে
এই ক্ষেত্রে মান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/business_data/google/hotel_searches/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_name": "New York,New York,United States",
"keyword": "cheap hotel",
"check_in": "2023-06-01",
"check_out": "2023-06-30",
"currency": "USD",
"adults": 2,
"children": [
"14"
],
"sort_by": "highest_rating",
"priority": 2,
"tag": "example"
}
]'
{
"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
}
]
}