v0.2.0-beta

OpenAPI 3.1.0

Dapatkan Hasil Pencarian Hotel Google menurut id

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

get/v1/beta/dataforseo/business_data/google/hotel_searches/task_get/{id}

Dapatkan Hasil Pencarian Hotel Google menurut id

Mengambil pencarian Google Hotels yang diantrekan menurut id. Dibungkus dalam envelope DataForSEO: data ada di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Dibungkus dalam envelope DataForSEO: data ada di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. ⚠️ Ukuran respons ditetapkan oleh depth atau batas saat pengiriman dan tidak dapat dipersempit di sini; jika terlalu besar, kirim ulang dengan nilai lebih kecil daripada melakukan penomoran halaman.

Referensi harga

Pengukuran: biaya respons yang dilaporkan.
Perkiraan referensi per permintaan: USD 0,012.
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.

Parameter Jalur

id
Tipe: string
wajib

pengenal tugas
pengenal tugas unik di sistem kami dalam format UUID
Anda dapat menggunakannya dalam 30 hari untuk meminta hasil tugas kapan saja

Respons

200
Tipe: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetResponseInfo
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_BusinessDataGoogleHotelSearchesTaskGetTaskInfo
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

array item
Catatan: field ini selalu sama dengan null; gunakan untuk memudahkan integrasi dan memastikan interoperabilitas dengan endpoint Hotel Info

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);
untuk mendapatkan hasil pencarian yang akurat, nama lokasi ditambahkan ke kata kunci secara otomatis

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

get/v1/beta/dataforseo/business_data/google/hotel_searches/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_searches/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Tampilkan Skema

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

Dapatkan Hasil Pencarian Hotel Google menurut id

AutentikasiRequired

DataForSEO

Dapatkan Hasil Pencarian Hotel Google menurut id

Referensi harga