Felo API PlatformFelo API Platform
সব DataForSEO endpoint
v0.2.0-beta
OpenAPI 3.1.0

Google হোটেল সার্চ টাস্ক সেট করুন

সার্ভার:https://openapi.felo.ai
ক্লায়েন্ট লাইব্রেরি

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 বিলিং রেকর্ড অনুযায়ী হয়।

বডি
application/json
  • টাইপ: 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_in
      টাইপ: string | null

      চেক-ইন তারিখ
      ঐচ্ছিক ফিল্ড
      আপনি এই ফিল্ড নির্দিষ্ট না করলে ডিফল্টভাবে আগামীকালের তারিখ ব্যবহার করা হবে;
      তারিখের ফরম্যাট: "yyyy-mm-dd"
      উদাহরণ:
      "2019-01-15"
      নোট: মান আজকের তারিখের আগের হতে পারবে না

    • check_out
      টাইপ: string | null

      চেক-আউট তারিখ
      ঐচ্ছিক ফিল্ড
      আপনি এই ফিল্ড নির্দিষ্ট না করলে আমাদের সিস্টেম ডিফল্টভাবে আজ থেকে দুই দিন পরের তারিখ প্রয়োগ করবে;
      তারিখের ফরম্যাট: "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_cancellation
      টাইপ: boolean | null

      বিনামূল্যে বাতিলযোগ্য হোটেল
      ঐচ্ছিক ফিল্ড
      আপনি বিনামূল্যে রিজার্ভেশন বাতিলযোগ্য হোটেলের তালিকা চাইলে এই ফিল্ড true সেট করুন
      ডিফল্ট মান: false

    • is_vacation_rentals
      টাইপ: boolean | null

      ভেকেশন রেন্টাল খুঁজুন
      ঐচ্ছিক ফিল্ড
      আপনি হোটেলের বদলে ভেকেশন রেন্টালের তালিকা চাইলে এই ফিল্ড true সেট করুন
      ডিফল্ট মান: false

    • keyword
      টাইপ: string | null

      কীওয়ার্ড
      ঐচ্ছিক ফিল্ড
      আপনার নির্দিষ্ট কীওয়ার্ড হোটেলের তালিকা খুঁজতে ব্যবহার করা হয়;
      আপনি এই ফিল্ড ব্যবহার না করলে নির্দিষ্ট অবস্থানে পাওয়া হোটেলের তালিকা ফেরত দেওয়া হবে;
      আপনি keyword ফিল্ডে সর্বোচ্চ 700 অক্ষর নির্দিষ্ট করতে পারেন
      সব %## ডিকোড করা হবে (‘+’ অক্ষরও স্পেস অক্ষরে ডিকোড হবে)
      আপনার keyword-এ “%” অক্ষর ব্যবহার করতে হলে তা “%25” হিসেবে নির্দিষ্ট করুন;
      নোট: সঠিক অনুসন্ধান ফলাফল পেতে কীওয়ার্ডের সঙ্গে অবস্থানের নাম স্বয়ংক্রিয়ভাবে যুক্ত হয়

      DataForSEO APIs-এ keyword ও keywords ফিল্ডের নিয়ম ও সীমাবদ্ধতা সম্পর্কে এই Help Center নিবন্ধে আরও জানুন

    • language_code
      টাইপ: string

      সার্চ ইঞ্জিন ভাষা কোড
      language_name নির্দিষ্ট না করলে আবশ্যক ফিল্ড
      আপনি এই ফিল্ড ব্যবহার করলে language_name নির্দিষ্ট করার প্রয়োজন নেই
      আপনি language_code-সহ উপলব্ধ ভাষার তালিকা https://api.dataforseo.com/v3/business_data/google/languages-এ আলাদা রিকোয়েস্ট পাঠিয়ে পেতে পারেন
      উদাহরণ:
      en

    • language_name
      টাইপ: string

      সার্চ ইঞ্জিন ভাষার পূর্ণ নাম
      language_code নির্দিষ্ট না করলে আবশ্যক ফিল্ড
      আপনি এই ফিল্ড ব্যবহার করলে language_code নির্দিষ্ট করার প্রয়োজন নেই
      আপনি language_name-সহ উপলব্ধ ভাষার তালিকা https://api.dataforseo.com/v3/business_data/google/languages-এ আলাদা রিকোয়েস্ট পাঠিয়ে পেতে পারেন
      উদাহরণ:
      English

    • location_code
      টাইপ: integer

      সার্চ ইঞ্জিন অবস্থান কোড
      location_name বা location_coordinate নির্দিষ্ট না করলে আবশ্যক ফিল্ড
      আপনি এই ফিল্ড ব্যবহার করলে location_name বা location_coordinate নির্দিষ্ট করার প্রয়োজন নেই
      আপনি location_code-সহ উপলব্ধ অবস্থানের তালিকা https://api.dataforseo.com/v3/business_data/google/locations-এ আলাদা রিকোয়েস্ট পাঠিয়ে পেতে পারেন
      উদাহরণ:
      2840

    • location_coordinate
      টাইপ: string

      অবস্থানের GPS স্থানাঙ্ক
      location_name বা location_code নির্দিষ্ট না করলে আবশ্যক ফিল্ড
      আপনি এই ফিল্ড ব্যবহার করলে location_name বা location_code নির্দিষ্ট করার প্রয়োজন নেই
      location_coordinate প্যারামিটার "latitude,longitude" ফরম্যাটে নির্দিষ্ট করতে হবে
      "latitude" ও "longitude"-এর জন্য দশমিক অঙ্কের সর্বোচ্চ সংখ্যা: 7
      নোট: অবস্থান নির্ধারণে স্থানাঙ্ক ব্যবহার করা হলে অনুসন্ধান নিকটতম জনবসতিতে হবে;
      উদাহরণ:
      53.476225,-2.243572

    • location_name
      টাইপ: string

      সার্চ ইঞ্জিন অবস্থানের পূর্ণ নাম
      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_price
      টাইপ: integer | null

      প্রতি রাতে সর্বোচ্চ মূল্য
      ঐচ্ছিক ফিল্ড
      এই মানের মুদ্রা currency ফিল্ডের উপর নির্ভর করে
      উদাহরণ:
      600

    • min_price
      টাইপ: integer | null

      প্রতি রাতে সর্বনিম্ন মূল্য
      ঐচ্ছিক ফিল্ড
      এই মানের মুদ্রা currency ফিল্ডের উপর নির্ভর করে
      উদাহরণ:
      100

    • min_rating
      টাইপ: number | null

      সর্বনিম্ন রেটিং
      ঐচ্ছিক ফিল্ড
      এই ফিল্ড দিয়ে একটি নির্দিষ্ট মানের চেয়ে বেশি গেস্ট রেটিং নির্দিষ্ট করতে পারেন
      উদাহরণ:
      2.5

    • pingback_url
      টাইপ: string | null

      সম্পন্ন টাস্কের নোটিফিকেশন URL
      ঐচ্ছিক ফিল্ড
      টাস্ক সম্পন্ন হলে আমরা আপনার নির্দিষ্ট URL-এ GET রিকোয়েস্ট পাঠিয়ে জানাব
      আপনি ‘$id’ স্ট্রিংকে $id ভ্যারিয়েবল এবং ‘$tag’ কে URL-এনকোডেড $tag ভ্যারিয়েবল হিসেবে ব্যবহার করতে পারেন। রিকোয়েস্ট পাঠানোর আগে আমরা প্রয়োজনীয় মান সেট করব।
      উদাহরণ:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      নোট: pingback_url-এ বিশেষ অক্ষর URL-এনকোড করা হবে;
      অর্থাৎ, # অক্ষরটি %23-এ এনকোড হবে

      আমাদের Help Center-এ আরও জানুন

    • postback_url
      টাইপ: string | null

      টাস্কের ফলাফল পাঠানোর URL
      ঐচ্ছিক ফিল্ড
      টাস্ক সম্পন্ন হলে আমরা তার ফলাফল gzip ফরম্যাটে কম্প্রেস করে আপনার নির্দিষ্ট postback_url-এ POST রিকোয়েস্ট পাঠাব
      আপনি ‘$id’ স্ট্রিংকে $id ভ্যারিয়েবল এবং ‘$tag’ কে URL-এনকোডেড $tag ভ্যারিয়েবল হিসেবে ব্যবহার করতে পারেন। রিকোয়েস্ট পাঠানোর আগে আমরা প্রয়োজনীয় মান সেট করব।
      উদাহরণ:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      নোট: postback_url-এ বিশেষ অক্ষর URL-এনকোড করা হবে;
      অর্থাৎ, # অক্ষরটি %23-এ এনকোড হবে

      আমাদের Help Center-এ আরও জানুন

    • priority
      টাইপ: integer | null

      টাস্ক প্রায়োরিটি
      ঐচ্ছিক ফিল্ড
      নিম্নলিখিত মান নিতে পারে:
      1 – সাধারণ এক্সিকিউশন প্রায়োরিটি (ডিফল্টভাবে সেট)
      2 – উচ্চ এক্সিকিউশন প্রায়োরিটি। উচ্চ এক্সিকিউশন প্রায়োরিটির টাস্কের জন্য অতিরিক্ত চার্জ নেওয়া হবে।
      খরচ Pricing পেজে গণনা করা যায়।

    • search_this_area
      টাইপ: boolean | null

      প্রদর্শিত এলাকা থেকে হোটেল দেখান
      ঐচ্ছিক ফিল্ড
      মান নিতে পারে: true, false
      ডিফল্ট মান: true
      false সেট করলে search_this_area মোড বন্ধ হবে
      নোট: search_this_area মোড বন্ধ থাকলে অনুসন্ধানের সময় location_name keyword-এর সঙ্গে যুক্ত হবে না
      এই প্যারামিটার সম্পর্কে আমাদের Help Center-এ আরও জানুন

    • sort_by
      টাইপ: string | null

      ফলাফল সাজানোর প্যারামিটার
      ঐচ্ছিক ফিল্ড
      এই ফিল্ড দিয়ে ফলাফল সাজাতে পারেন
      সম্ভাব্য সাজানোর ধরন:
      relevance – সবচেয়ে প্রাসঙ্গিক অনুসারে সাজান
      lowest_price – সর্বনিম্ন মূল্য অনুসারে সাজান
      highest_rating – সর্বোচ্চ রেটিং অনুসারে সাজান
      most_reviewed – সর্বাধিক পর্যালোচিত অনুসারে সাজান
      ডিফল্ট মান: relevance

    • stars
      টাইপ: array string[] | null

      হোটেল স্টার
      ঐচ্ছিক ফিল্ড
      আপনি শুধু 5-স্টার হোটেলের তালিকা চাইলে এই ফিল্ড [5] সেট করুন
      উদাহরণ:
      [3,4,5]

    • tag
      টাইপ: string | null

      ব্যবহারকারী-নির্ধারিত টাস্ক আইডেন্টিফায়ার
      ঐচ্ছিক ফিল্ড
      অক্ষরসীমা 255
      এই প্যারামিটার দিয়ে টাস্ক শনাক্ত করে ফলাফলের সঙ্গে মিলিয়ে নিতে পারেন
      নির্দিষ্ট tag মান response-এর data অবজেক্টে পাবেন

রেসপন্স
  • 200
    টাইপ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostResponseInfo
    • cost
      টাইপ: number | null ফরম্যাট: double

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

    • status_code
      টাইপ: integer | null

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

    • status_message
      টাইপ: string | null

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

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

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

      • টাইপ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostTaskInfo
        • 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
Request Example for post/v1/beta/dataforseo/business_data/google/hotel_searches/task_post
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
    }
  ]
}
Setting Google Hotel Searches Tasks