DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google হোটেল তথ্য টাস্ক সেট করুন
হোটেল লিস্টিং লুকআপ কিউ করে, একটি টাস্ক id ফেরত দেয়। DataForSEO-এর এনভেলপে মোড়ানো: ডেটা tasks[0].result-এ, ফলাফল tasks[0].status_code-এ - প্রত্যাখ্যাত রিকোয়েস্টও HTTP 200 ফেরত দেয়। পার্স করা রূপে get_dataforseo_business_google_hotel_info_fetch দিয়ে বা কাঁচা রূপে get_dataforseo_business_google_hotel_info_fetch_html দিয়ে পুনরুদ্ধার করুন।
মূল্য রেফারেন্স
- মিটারিং: রিপোর্ট করা রেসপন্স খরচ
- রেফারেন্স রিকোয়েস্ট অনুমান: USD 0.2428
- রেফারেন্স গ্রাহক গুণক: 1.0। ইতিমধ্যে নিষ্পত্তি হওয়া গ্রাহক অর্থের উপর এটি আবার প্রয়োগ করবেন না
শুধুমাত্র রেফারেন্স মেটাডেটা, কোনো অ্যাকাউন্ট কোটেশন, নিশ্চিত মূল্য বা ব্যয়সীমা নয়। রিসোর্স ক্রেডিট Felo ক্রেডিট নয়। চূড়ান্ত চার্জ Felo বিলিং রেকর্ড অনুযায়ী হয়।
- টাইপ: array (object | null)[]
- adultsটাইপ: integer | null
প্রাপ্তবয়স্কের সংখ্যা
ঐচ্ছিক ফিল্ড
আপনি এই ফিল্ড নির্দিষ্ট না করলে ডিফল্টভাবে দুইজন প্রাপ্তবয়স্ক ব্যবহার করা হবে
উদাহরণ:1 - checkটাইপ: string | null
_in চেক-ইন তারিখ
ঐচ্ছিক ফিল্ড
আপনি এই ফিল্ড নির্দিষ্ট না করলে ডিফল্টভাবে আগামীকালের তারিখ ব্যবহার করা হবে;
মান আজকের তারিখের আগের হতে পারবে না
তারিখের ফরম্যাট:"yyyy-mm-dd"
উদাহরণ:"2019-01-15" - checkটাইপ: string | null
_out চেক-আউট তারিখ
ঐচ্ছিক ফিল্ড
আপনি এই ফিল্ড নির্দিষ্ট না করলে আমাদের সিস্টেম ডিফল্টভাবে আজ থেকে দুই দিন পরের তারিখ প্রয়োগ করবে;
নোট: মানcheck_in-এর সমান বা তার কম হতে পারবে না;check_inওcheck_outমানের মধ্যে ব্যবধান 30 দিনের বেশি হতে পারবে না
তারিখের ফরম্যাট:"yyyy-mm-dd"
উদাহরণ:"2019-01-15" - childrenটাইপ: array string[] | null
শিশুর সংখ্যা ও বয়স
ঐচ্ছিক ফিল্ড
আপনি এই ফিল্ড নির্দিষ্ট না করলে অনুসন্ধানে কোনো শিশু অন্তর্ভুক্ত হবে না;একজন 14 বছর বয়সী শিশু অন্তর্ভুক্ত করতে নিম্নলিখিত মান সেট করুন:
[14]
একজন 13 বছর বয়সী ও একজন 8 বছর বয়সী শিশু অন্তর্ভুক্ত করতে নিম্নলিখিত মান সেট করুন:[13,8] - currencyটাইপ: string | null
মুদ্রা
ঐচ্ছিক ফিল্ড
উদাহরণ:"USD" - hotelটাইপ: string
_identifier হোটেলের অনন্য আইডেন্টিফায়ার
keywordনির্দিষ্ট না করলে আবশ্যক ফিল্ড
আপনি এই ফিল্ড ব্যবহার করলেkeywordনির্দিষ্ট করার প্রয়োজন নেই
Google অনুসন্ধানে হোটেল সত্তার অনন্য আইডেন্টিফায়ার;
আপনি অ্যাডভান্সড Google SERP API-তে (response-এরhotels_packএলিমেন্টে অন্তর্ভুক্ত) বা Business Data API-এর Hotel Searches endpoint-এ রিকোয়েস্ট পাঠিয়ে মানটি পেতে পারেন
উদাহরণ:ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE - keywordটাইপ: string
কীওয়ার্ড
hotel_identifierনির্দিষ্ট না করলে আবশ্যক ফিল্ড
আপনি এই ফিল্ড ব্যবহার করলেhotel_identifierনির্দিষ্ট করার প্রয়োজন নেই
আপনার নির্দিষ্ট কীওয়ার্ড হোটেল সত্তার নাম নির্দেশ করা উচিত
আপনিkeywordফিল্ডে সর্বোচ্চ 700 অক্ষর নির্দিষ্ট করতে পারেন
সব %## ডিকোড করা হবে (‘+’ অক্ষরও স্পেস অক্ষরে ডিকোড হবে)
আপনারkeyword-এ “%” অক্ষর ব্যবহার করতে হলে তা “%25” হিসেবে নির্দিষ্ট করুন - 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 - loadটাইপ: boolean | null
_prices _by _dates তারিখ অনুসারে হোটেল অবস্থানের মূল্য লোড করুন
ঐচ্ছিক ফিল্ড
আপনি এই প্যারামিটারtrue-সহ নির্দিষ্ট করলে response-এprices_by_datesঅ্যারে থাকবে যাতে তারিখ অনুসারে বিভক্ত হোটেল অবস্থানের মূল্য থাকবে
আপনি এই প্যারামিটার ব্যবহার করলে প্রতি রিকোয়েস্টে বেস মূল্যের দ্বিগুণ চার্জ নেওয়া হবে - 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 - 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
_data postback_url ডেটাটাইপ
postback_urlনির্দিষ্ট করলে আবশ্যক ফিল্ড
আপনার সার্ভারে যে ডেটাটাইপ পাঠানো হবে তার সঙ্গে মেলে
সম্ভাব্য মান:advanced,html - 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হিসেবে এনকোড হবে - pricesটাইপ: string | null
_date _range দৈনিক মূল্য ডেটা আনতে পূর্বনির্ধারিত সময়কাল
ঐচ্ছিক ফিল্ড
এই প্যারামিটার ব্যবহার করতে হলে আপনাকেload_prices_by_datestrue-সহ নির্দিষ্ট করতে হবেprices_start_dateনির্দিষ্ট না থাকলে শুরুর তারিখcheck_inতারিখে সেট হয়
সম্ভাব্য মান:month,three_months,six_months,year
ডিফল্ট মান:month - pricesটাইপ: string | null
_end _date তারিখ অনুসারে মূল্য লোড করার শেষ তারিখ
ঐচ্ছিক ফিল্ড
এই প্যারামিটার ব্যবহার করতে হলে আপনাকেload_prices_by_datestrue-সহ নির্দিষ্ট করতে হবে
এই প্যারামিটার নির্দিষ্ট না করলে আপনি মাসের জন্য তারিখ অনুসারে মূল্য পাবেন
তারিখের ফরম্যাট:yyyy-mm-dd
উদাহরণ:2025-05-21 - pricesটাইপ: string | null
_start _date তারিখ অনুসারে মূল্য লোড করার শুরুর তারিখ
ঐচ্ছিক ফিল্ড
এই প্যারামিটার ব্যবহার করতে হলে আপনাকেload_prices_by_datestrue-সহ নির্দিষ্ট করতে হবে
এই প্যারামিটার নির্দিষ্ট না করলে শুরুর তারিখcheck_inতারিখে সেট হয়
তারিখের ফরম্যাট:yyyy-mm-dd
উদাহরণ:2025-05-20 - priorityটাইপ: integer | null
- tagটাইপ: string | null
ব্যবহারকারী-নির্ধারিত টাস্ক আইডেন্টিফায়ার
ঐচ্ছিক ফিল্ড
অক্ষরসীমা 255;
এই প্যারামিটার দিয়ে টাস্ক শনাক্ত করে ফলাফলের সঙ্গে মিলিয়ে নিতে পারেন;
নির্দিষ্টtagমান response-এরdataঅবজেক্টে পাবেন
- টাইপ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskPostResponseInfo200
- টাইপ: number | null ফরম্যাট: doublecost
টাস্কের মোট খরচ, USD
- টাইপ: integer | nullstatus
_code সাধারণ স্ট্যাটাস কোড সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন
- টাইপ: string | nullstatus
_message সাধারণ তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন
- টাইপ: array (object | null)[] | nulltasks
টাস্কের অ্যারে
- টাইপ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskPostTaskInfo
- 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_info/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",
"hotel_identifier": "ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE",
"tag": "some_string_123",
"postback_url": "https://your-server.com/postbackscript.php",
"postback_data": "advanced"
}
]'
{
"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
}
]
}