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

Tugas Pencarian Hotel Google Langsung

Felo API Support
MIT
Server:https://openapi.felo.ai
Pustaka Klien
Shell Curl

DataForSEO

​

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

DataForSEO Operasi

Tugas Pencarian Hotel Google Langsung

​

Menelusuri Google Hotels untuk properti yang cocok dengan kueri, beserta tanggal dan hunian. Dibungkus dalam envelope DataForSEO: data ada di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Ini cara menemukan hotel yang id-nya dibutuhkan endpoint info; post_dataforseo_business_google_hotel_info_live adalah tampilan detailnya.

Referensi harga

  • Pengukuran: biaya respons yang dilaporkan.
  • Perkiraan referensi per permintaan: USD 0,2428.
  • Pengali referensi pelanggan: 1,0. Jangan menerapkannya lagi pada jumlah tagihan pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukan kredit Felo. Biaya akhir mengikuti catatan penagihan Felo.

Isi
application/json
  • Tipe: array (object | null)[]
    • adults
      Tipe: integer | null

      jumlah orang dewasa
      field opsional
      jika Anda tidak menentukan field ini, nilai default 2 akan diterapkan;
      catatan bahwa Anda dapat menentukan hingga 6 orang termasuk orang dewasa dan anak-anak
      contoh:
      1

    • amenities
      Tipe: array string[] | null

      fasilitas hotel
      field opsional
      Anda dapat menggunakan field ini untuk menentukan berbagai fasilitas hotel
      contoh:
      [
      "free_parking",
      "pets_allowed"
      ]

      nilai yang mungkin:
      "air_conditioning",<br>"all_inclusive_available",<br>"bar",<br>"free_breakfast",<br>"fitness_center",<br>"kid_friendly",<br>"free_parking",<br>"pets_allowed",<br>"pool",<br>"restaurant",<br>"room_service",<br>"spa",<br>"free_wifi",<br>"parking",<br>"indoor_pool",<br>"outdoor_pool",<br>"wheelchair_accessible",<br>"beach_access"

    • check_in
      Tipe: string | null

      tanggal check-in
      field opsional
      jika Anda tidak menentukan field ini, tanggal besok akan digunakan secara default;
      format tanggal: "yyyy-mm-dd"
      contoh:
      "2019-01-15"
      Catatan: nilai tidak boleh mendahului tanggal hari ini

    • check_out
      Tipe: string | null

      tanggal check-out
      field opsional
      jika Anda tidak menentukan field ini, sistem kami akan menerapkan tanggal dua hari dari sekarang secara default;
      format tanggal: "yyyy-mm-dd"
      contoh:
      "2019-01-15"
      Catatan: nilai tidak boleh kurang dari atau sama dengan check_in;
      rentang antara nilai check_in dan check_out tidak boleh melebihi 30 hari

    • children
      Tipe: array string[] | null

      jumlah dan usia anak
      field opsional
      jika Anda tidak menentukan field ini, tidak ada anak yang disertakan dalam pencarian;
      usia anak dapat dari 0 hingga 17;
      catatan bahwa Anda dapat menentukan hingga 6 orang termasuk orang dewasa dan anak-anak
      tentukan nilai berikut jika Anda ingin menyertakan satu anak berusia 14 tahun:
      [14]
      tentukan nilai berikut jika Anda ingin menyertakan satu anak berusia 13 tahun dan satu anak berusia 8 tahun:
      [13,8]

    • currency
      Tipe: string | null

      mata uang
      field opsional
      contoh:
      "USD"

    • depth
      Tipe: integer | null

      kedalaman parsing
      field opsional
      jumlah hasil di Google Hotels
      nilai default: 18 hasil organik
      nilai maksimum: 140
      Catatan: akun Anda akan ditagih per setiap 18 hasil organik terlepas dari daftar berbayar dalam respons;
      oleh karena itu, menetapkan kedalaman di atas 18 dapat mengakibatkan biaya tambahan jika Google Hotels mengembalikan lebih dari 18 hasil;
      jika kedalaman yang ditentukan lebih tinggi daripada jumlah hasil dalam respons, selisihnya akan dikembalikan secara otomatis ke saldo akun Anda

    • free_cancellation
      Tipe: boolean | null

      hotel dengan pembatalan gratis
      field opsional
      setel field ini ke true jika Anda ingin mendapatkan daftar hotel dengan pembatalan reservasi gratis
      nilai default: false

    • is_vacation_rentals
      Tipe: boolean | null

      pencarian sewa liburan
      field opsional
      setel field ini ke true jika Anda ingin mendapatkan daftar sewa liburan alih-alih hotel
      nilai default: false

    • keyword
      Tipe: string | null

      kata kunci
      field opsional
      kata kunci yang Anda tentukan digunakan untuk mencari daftar hotel;
      jika Anda tidak menggunakan field ini, kami akan mengembalikan daftar hotel yang ditemukan di lokasi yang ditentukan;
      Anda dapat menentukan hingga 700 karakter di field keyword
      semua %## akan didekode (karakter ‘+’ juga akan didekode menjadi karakter spasi)
      jika Anda perlu menggunakan karakter “%” untuk keyword, tentukan sebagai “%25”;
      Catatan: untuk mendapatkan hasil pencarian yang akurat, nama lokasi ditambahkan secara otomatis ke kata kunci

      pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO di artikel Pusat Bantuan ini

    • language_code
      Tipe: string

      kode bahasa mesin pencari
      field wajib jika Anda tidak menentukan language_name
      jika Anda menggunakan field ini, Anda tidak perlu menentukan language_name
      Anda dapat memperoleh daftar bahasa yang tersedia beserta language_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/business_data/google/languages
      contoh:
      en

    • language_name
      Tipe: string

      nama lengkap bahasa mesin pencari
      field wajib jika Anda tidak menentukan language_code
      jika Anda menggunakan field ini, Anda tidak perlu menentukan language_code
      Anda dapat memperoleh daftar bahasa yang tersedia dengan language_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/business_data/google/languages
      contoh:
      English

    • location_code
      Tipe: integer

      kode lokasi mesin pencari
      field wajib jika Anda tidak menentukan location_name atau location_coordinate
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_coordinate
      Anda dapat memperoleh daftar lokasi yang tersedia dengan location_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/business_data/google/locations
      contoh:
      2840

    • location_coordinate
      Tipe: string

      koordinat GPS suatu lokasi
      field wajib jika Anda tidak menentukan location_name atau location_code
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_code
      Parameter location_coordinate harus ditentukan dalam format "latitude,longitude"
      jumlah maksimum digit desimal untuk "latitude" dan "longitude": 7
      Catatan: jika koordinat digunakan untuk menetapkan lokasi, pencarian akan dilakukan di pemukiman terdekat
      contoh:
      53.476225,-2.243572

    • location_name
      Tipe: string

      nama lengkap lokasi mesin pencari
      field wajib jika Anda tidak menentukan location_code atau location_coordinate
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code atau location_coordinate
      Anda dapat memperoleh daftar lokasi yang tersedia dengan location_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/business_data/google/locations
      contoh:
      London,England,United Kingdom
      Catatan: untuk mendapatkan hasil pencarian yang akurat, location_name yang Anda tentukan akan otomatis ditambahkan ke kata kunci

    • max_price
      Tipe: integer | null

      harga maksimum per malam
      field opsional
      mata uang nilai ini bergantung pada field currency
      contoh:
      600

    • min_price
      Tipe: integer | null

      harga minimum per malam
      field opsional
      mata uang nilai ini bergantung pada field currency
      contoh:
      100

    • min_rating
      Tipe: number | null

      rating minimum
      field opsional
      Anda dapat menggunakan field ini untuk menentukan rating tamu yang lebih tinggi dari nilai tertentu
      contoh:
      2.5

    • search_this_area
      Tipe: boolean | null

      tampilkan hotel dari area yang ditampilkan
      field opsional
      dapat bernilai: true, false
      nilai default: true
      jika disetel ke false, mode search_this_area akan dimatikan
      Catatan: jika mode search_this_area dimatikan, location_name tidak akan ditambahkan ke keyword selama pencarian
      pelajari lebih lanjut tentang parameter ini di Pusat Bantuan kami

    • sort_by
      Tipe: string | null

      parameter pengurutan hasil
      field opsional
      Anda dapat menggunakan field ini untuk mengurutkan hasil
      jenis pengurutan yang mungkin:
      relevance – urutkan berdasarkan paling relevan
      lowest_price – urutkan berdasarkan harga terendah
      highest_rating – urutkan berdasarkan rating tertinggi
      most_reviewed – urutkan berdasarkan paling banyak diulas
      nilai default: relevance

    • stars
      Tipe: array string[] | null

      bintang hotel
      field opsional
      setel field ini ke [5] jika Anda ingin mendapatkan daftar hotel bintang 5 saja
      contoh:
      [3,4,5]

    • tag
      Tipe: string | null

      pengenal tugas yang ditentukan pengguna
      field opsional
      batas karakter adalah 255
      Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
      Anda akan menemukan nilai tag yang ditentukan di objek data pada respons

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveResponseInfo
    • cost
      Tipe: number | null Format: double

      total biaya tugas, USD

    • status_code
      Tipe: integer | null

      kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

    • status_message
      Tipe: string | null

      pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

    • tasks
      Tipe: array (object | null)[] | null

      array tugas

      • Tipe: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveTaskInfo
        • cost
          Tipe: number | null Format: double

          total biaya tugas, USD

        • data
          Tipe: object | null

          berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

          • propertyName
            Tipe: object | null
        • id
          Tipe: string | null

          pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

        • path
          Tipe: array (string | null)[] | null

          Jalur URL

        • result
          Tipe: array (object | null)[] | null

          array hasil

          • check_url
            Tipe: string | null

            URL langsung ke hasil mesin pencari
            Anda dapat menggunakannya untuk memastikan kami memberikan hasil yang akurat

          • datetime
            Tipe: string | null

            tanggal dan waktu saat hasil diterima
            dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            misalnya:
            2019-11-15 12:57:46 +00:00

          • items
            Tipe: array (object | null)[] | null

            jenis item yang ditemukan
            jenis hasil mesin pencari yang ditemukan dalam array items;
            jenis item yang mungkin: hotel_search_item

            • hotel_identifier
              Tipe: string | null

              pengenal unik entitas hotel di pencarian Google
              contoh:
              CgoI-KWyzenM_MV3EAE

            • is_paid
              Tipe: boolean | null

              menunjukkan daftar hotel berbayar
              jika true, hotel_search_item terkait adalah iklan berbayar
              jika false, hotel_search_item terkait adalah daftar hotel organik

            • location
              Tipe: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo

              koordinat GPS lokasi hotel

              • latitude
                Tipe: number | null

                koordinat lintang hotel di google maps
                contoh:
                "latitude": 51.584091

              • longitude
                Tipe: number | null

                koordinat bujur hotel di google maps
                contoh:
                "longitude": -0.31365919999999997

            • overview_images
              Tipe: array (string | null)[] | null

              gambar unggulan untuk hotel

            • prices
              Tipe: object | null · Response36Afe1097B20_HotelPriceInfo

              harga hotel

              • check_in
                Tipe: string | null

                tanggal dan waktu check-in
                dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                contoh:
                2019-11-15 12:57:46 +00:00

              • check_out
                Tipe: string | null

                tanggal dan waktu check-out
                dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                contoh:
                2019-11-15 12:57:46 +00:00

              • currency
                Tipe: string | null

                mata uang harga
                USD diterapkan secara default, kecuali ditentukan dalam array POST

              • discount_text
                Tipe: string | null

                teks tentang diskon yang diterapkan

              • items
                Tipe: array (object | null)[] | null

                jenis item yang ditemukan
                jenis hasil mesin pencari yang ditemukan dalam array items;
                jenis item yang mungkin: hotel_search_item

                • currency
                  Tipe: string | null

                  mata uang harga
                  USD diterapkan secara default, kecuali ditentukan dalam array POST

                • domain
                  Tipe: string | null

                  domain pihak ketiga domain halaman situs web pihak ketiga dengan informasi harga

                • free_cancellation_until
                  Tipe: string | null

                  tanggal hingga pembatalan gratis tersedia dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00” sama dengan null jika pembatalan gratis tidak tersedia untuk tanggal yang dipilih

                • is_paid
                  Tipe: boolean | null

                  menunjukkan daftar hotel berbayar
                  jika true, hotel_search_item terkait adalah iklan berbayar
                  jika false, hotel_search_item terkait adalah daftar hotel organik

                • offers
                  Tipe: array (object | null)[] | null

                  penawaran harga unggulan

                  • currency
                    Tipe: string | null

                    mata uang harga
                    USD diterapkan secara default, kecuali ditentukan dalam array POST

                  • free_cancellation_until
                    Tipe: string | null

                    tanggal hingga pembatalan gratis tersedia dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00” sama dengan null jika pembatalan gratis tidak tersedia untuk tanggal yang dipilih

                  • max_visitors
                    Tipe: integer | null

                    jumlah pengunjung maksimum jumlah maksimum pengunjung yang menjadi berlakunya penawaran harga

                  • offer_images
                    Tipe: array (string | null)[] | null

                    gambar penawaran harga URL gambar yang ditampilkan dalam penawaran harga

                  • price
                    Tipe: number | null

                    harga per malam

                  • title
                    Tipe: string | null

                    judul hotel

                  • type
                    Tipe: string | null

                    jenis elemen

                  • url
                    Tipe: string | null

                    url penawaran harga URL ke halaman situs web tempat penawaran harga muncul

                • official_site
                  Tipe: boolean | null
                • price
                  Tipe: number | null

                  harga per malam

                • title
                  Tipe: string | null

                  judul hotel

                • type
                  Tipe: string | null

                  jenis elemen

                • url
                  Tipe: string | null

                  url halaman pihak ketiga URL ke halaman situs web pihak ketiga dengan informasi harga

              • price
                Tipe: number | null

                harga per malam

              • price_without_discount
                Tipe: number | null Format: int64

                harga penuh per malam tanpa diskon

              • prices_by_dates
                Tipe: array (object | null)[] | null
                • check_in_date
                  Tipe: string | null
                • check_out_date
                  Tipe: string | null
                • currency
                  Tipe: string | null

                  mata uang harga
                  USD diterapkan secara default, kecuali ditentukan dalam array POST

                • price
                  Tipe: number | null

                  harga per malam

              • visitors
                Tipe: integer | null

                jumlah pengunjung hotel untuk harga ini

            • reviews
              Tipe: object | null · Response36Afe1097B20_HotelReviewInfo

              ulasan dan informasi peringkat hotel

              • mentions
                Tipe: array (object | null)[] | null

                sebutan hotel
                informasi tentang ulasan hotel berdasarkan kriteria

                • negative_count
                  Tipe: integer | null Format: int64

                  jumlah ulasan negatif menurut kriteria

                • positive_count
                  Tipe: integer | null Format: int64

                  jumlah ulasan positif menurut kriteria

                • positive_score
                  Tipe: number | null

                  skor positif menurut kriteria

                • title
                  Tipe: string | null

                  judul kriteria yang dievaluasi

                • total_count
                  Tipe: integer | null Format: int64

                  jumlah semua ulasan menurut kriteria

                • visible_by_default
                  Tipe: boolean | null

                  elemen terlihat secara default
                  menunjukkan apakah elemen ulasan terlihat secara default

              • other_sites_reviews
                Tipe: array (object | null)[] | null

                ulasan di situs pihak ketiga
                ulasan dari situs pihak ketiga

                • rating
                  Tipe: object | null · Response36Afe1097B20_RatingInfo

                  penilaian dalam ulasan
                  informasi tentang penilaian yang tercantum dalam ulasan di situs pihak ketiga

                  • rating_max
                    Tipe: integer | null

                    nilai maksimum untuk rating_type

                  • rating_type
                    Tipe: string | null

                    jenis penilaian di sini Anda dapat menemukan elemen berikut: Max5, Percents, CustomMax

                  • value
                    Tipe: number | null Format: double

                    nilai penilaian

                  • votes_count
                    Tipe: integer | null Format: int64

                    jumlah umpan balik

                • review_text
                  Tipe: string | null

                  teks ulasan
                  teks ulasan

                • title
                  Tipe: string | null

                  judul ulasan
                  berisi nama situs pihak ketiga tempat ulasan pertama kali muncul

                • url
                  Tipe: string | null

                  url ulasan
                  URL ke situs pihak ketiga tempat ulasan pertama kali muncul

              • rating_distribution
                Tipe: object | null

                distribusi peringkat berdasarkan suara
                distribusi suara di seluruh peringkat dalam rentang 1 hingga 5

                • propertyName
                  Tipe: integer | null Format: Int64
              • value
                Tipe: number | null

                rating hotel keseluruhan berdasarkan suara pelanggan

              • votes_count
                Tipe: integer | null Format: int64

                jumlah suara pelanggan
                jumlah suara pelanggan yang disertakan dalam perhitungan rating hotel

            • stars
              Tipe: integer | null

              klasifikasi bintang hotel
              klasifikasi bintang dalam rentang 1-5 bintang

            • title
              Tipe: string | null

              judul hotel

            • type
              Tipe: string | null

              jenis elemen

          • items_count
            Tipe: integer | null Format: int64

            jenis item
            jumlah item dalam array items

          • keyword
            Tipe: string | null

            kata kunci yang diterima dalam array POST
            kata kunci dikembalikan dengan %## yang didekode (karakter plus '+' akan didekode menjadi karakter spasi)

          • language_code
            Tipe: string | null

            kode bahasa dalam array POST

          • location_code
            Tipe: integer | null

            kode lokasi dalam array POST

        • result_count
          Tipe: integer | null Format: int64

          jumlah elemen dalam array hasil

        • status_code
          Tipe: integer | null

          kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

        • status_message
          Tipe: string | null

          pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

        • time
          Tipe: string | null

          waktu eksekusi, detik

    • tasks_count
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks

    • tasks_error
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks yang dikembalikan dengan error

    • time
      Tipe: string | null

      total waktu eksekusi, detik

    • version
      Tipe: string | null

      versi API saat ini

    application/json
  • 400

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat menggunakan format penyedia

    application/json
Request Example for post/v1/beta/dataforseo/business_data/google/hotel_searches/live
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_searches/live \
  --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": [
        {
          "keyword": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "hotel_identifier": null,
              "title": null,
              "stars": null,
              "is_paid": null,
              "location": "[Max Depth Exceeded]",
              "reviews": "[Max Depth Exceeded]",
              "overview_images": [
                "[Max Depth Exceeded]"
              ],
              "prices": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Live Google Hotel Searches Tasks