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

Mengatur Tugas Pencarian Hotel Google

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

Mengatur Tugas Pencarian Hotel Google

​

Mengantrekan pencarian Google Hotels, mengembalikan id tugas. Dibungkus dalam envelope DataForSEO: data ada di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Ambil dengan get_dataforseo_business_google_hotel_searches_fetch.

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",
      "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
      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

    • pingback_url
      Tipe: string | null

      URL notifikasi tugas yang selesai
      field opsional
      saat tugas selesai, kami akan memberi tahu Anda melalui permintaan GET yang dikirim ke URL yang Anda tentukan
      Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan.
      contoh:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Catatan: karakter khusus dalam pingback_url akan di-urlencode;
      yaitu, karakter # akan dienkode menjadi %23

      pelajari selengkapnya di Pusat Bantuan kami

    • postback_url
      Tipe: string | null

      URL untuk mengirim hasil tugas
      field opsional
      setelah tugas selesai, kami akan mengirim permintaan POST dengan hasilnya yang dikompresi dalam format gzip ke postback_url yang Anda tentukan
      Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan.
      contoh:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      Catatan: karakter khusus dalam postback_url akan di-urlencode;
      yaitu, karakter # akan dienkode menjadi %23

      pelajari selengkapnya di Pusat Bantuan kami

    • priority
      Tipe: integer | null

      prioritas tugas
      field opsional
      dapat mengambil nilai berikut:
      1 – prioritas eksekusi normal (ditetapkan secara default)
      2 – prioritas eksekusi tinggi Anda akan dikenai biaya tambahan untuk tugas dengan prioritas eksekusi tinggi.
      Biaya dapat dihitung di halaman Harga.

    • 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_BusinessDataGoogleHotelSearchesTaskPostResponseInfo
    • 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_BusinessDataGoogleHotelSearchesTaskPostTaskInfo
        • 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: object | null

          array hasil
          dalam kasus ini, nilainya akan menjadi null

        • 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/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
    }
  ]
}

Operasi berhasil

Setting Google Hotel Searches Tasks