DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Info Hotel Google Langsung Lanjutan
Daftar Google satu hotel: kamar, fasilitas, harga, dan opsi pemesanan yang ditampilkan Google. Dibungkus dalam envelope DataForSEO: data ada di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Bentuk mentahnya adalah post_dataforseo_business_google_hotel_info_live_html, dan bentuk antreannya post_dataforseo_business_google_hotel_info_submit. Untuk menemukan hotelnya lebih dulu, gunakan post_dataforseo_business_google_hotel_searches_live.
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.
- Tipe: array (object | null)[]
- adultsTipe: integer | null
jumlah orang dewasa
field opsional
jika Anda tidak menentukan field ini, dua orang dewasa akan digunakan secara default
contoh:1 - checkTipe: string | null
_in tanggal check-in
field opsional
jika Anda tidak menentukan field ini, tanggal besok akan digunakan secara default;
nilai tidak boleh lebih awal dari tanggal hari ini
format tanggal:"yyyy-mm-dd"
contoh:"2019-01-15" - checkTipe: string | null
_out tanggal check-out
field opsional
jika Anda tidak menentukan field ini, sistem kami akan menerapkan tanggal dua hari dari sekarang secara default;
Catatan: nilai tidak boleh kurang dari atau sama dengancheck_in;
rentang antara nilaicheck_indancheck_outtidak boleh melebihi 30 hari
format tanggal:"yyyy-mm-dd"
contoh:"2019-01-15" - childrenTipe: array string[] | null
jumlah dan usia anak
field opsional
jika Anda tidak menentukan field ini, tidak ada anak yang disertakan dalam pencarian;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] - currencyTipe: string | null
mata uang
field opsional
contoh:"USD" - hotelTipe: string
_identifier - languageTipe: string
_code kode bahasa mesin pencari
field wajib jika Anda tidak menentukanlanguage_name
jika Anda menggunakan field ini, Anda tidak perlu menentukanlanguage_name
Anda dapat memperoleh daftar bahasa yang tersedia besertalanguage_codedengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/business_data/google/languages
contoh:en - languageTipe: string
_name nama lengkap bahasa mesin pencari
field wajib jika Anda tidak menentukanlanguage_code
jika Anda menggunakan field ini, Anda tidak perlu menentukanlanguage_code
Anda dapat memperoleh daftar bahasa yang tersedia denganlanguage_namedengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/business_data/google/languages
contoh:English - loadTipe: boolean | null
_prices _by _dates memuat harga menginap hotel berdasarkan tanggal
field opsional
jika Anda menentukan parameter ini dengantrue, respons akan menyertakan arrayprices_by_datesdengan harga menginap hotel yang dibagi berdasarkan tanggal
jika Anda menggunakan parameter ini, Anda akan dikenai biaya dua kali harga dasar per permintaan - locationTipe: integer
_code kode lokasi mesin pencari
field wajib jika Anda tidak menentukanlocation_nameataulocation_coordinate
jika Anda menggunakan field ini, Anda tidak perlu menentukanlocation_nameataulocation_coordinate
Anda dapat memperoleh daftar lokasi yang tersedia denganlocation_codedengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/business_data/google/locations
contoh:2840 - locationTipe: string
_coordinate koordinat GPS suatu lokasi
field wajib jika Anda tidak menentukanlocation_nameataulocation_code
jika Anda menggunakan field ini, Anda tidak perlu menentukanlocation_nameataulocation_code
Parameterlocation_coordinateharus 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 - locationTipe: string
_name nama lengkap lokasi mesin pencari
field wajib jika Anda tidak menentukanlocation_codeataulocation_coordinate
jika Anda menggunakan field ini, Anda tidak perlu menentukanlocation_codeataulocation_coordinate
Anda dapat memperoleh daftar lokasi yang tersedia denganlocation_namedengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/business_data/google/locations
contoh:London,England,United Kingdom - pricesTipe: string | null
_date _range periode yang telah ditentukan untuk mengambil data harga harian
field opsional
untuk menggunakan parameter ini, Anda harus menentukanload_prices_by_datesdengantrue
jikaprices_start_datetidak ditentukan, tanggal mulai disetel ke tanggalcheck_in
nilai yang mungkin:month,three_months,six_months,year
nilai default:month - pricesTipe: string | null
_end _date tanggal akhir untuk memuat harga berdasarkan tanggal
field opsional
untuk menggunakan parameter ini, Anda harus menentukanload_prices_by_datesdengantrue
jika parameter ini tidak ditentukan, Anda akan mendapatkan harga berdasarkan tanggal untuk bulan tersebut
format tanggal:yyyy-mm-dd
contoh:2025-05-21 - pricesTipe: string | null
_start _date tanggal mulai untuk memuat harga berdasarkan tanggal
field opsional
untuk menggunakan parameter ini, Anda harus menentukanload_prices_by_datesdengantrue
jika parameter ini tidak ditentukan, tanggal mulai disetel ke tanggalcheck_in
format tanggal:yyyy-mm-dd
contoh:2025-05-20 - tagTipe: 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 nilaitagyang ditentukan di objekdatapada respons
- Tipe: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo200
- Tipe: number | null Format: doublecost
total biaya tugas, USD
- Tipe: integer | nullstatus
_code kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini
- Tipe: string | nullstatus
_message pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini
- Tipe: array (object | null)[] | nulltasks
array tugas
- Tipe: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo
- costTipe: number | null Format: double
total biaya tugas, USD
- dataTipe: object | null
berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST
- propertyTipe: object | null
Name
- idTipe: string | null
pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID
- pathTipe: array (string | null)[] | null
Jalur URL
- resultTipe: array (object | null)[] | null
array hasil
- aboutTipe: object | null · Response36Afe1097B20_HotelAboutInfo
informasi tentang hotel
- amenitiesTipe: array (object | null)[] | null
fasilitas hotel
informasi tentang fasilitas hotel- categoryTipe: string | null
kategori fasilitas yang terstandardisasi
- categoryTipe: string | null
_label label kategori
- itemsTipe: array (object | null)[] | null
fasilitas dan detail spesifik
- amenityTipe: string | null
nama fasilitas yang terstandardisasi
- amenityTipe: string | null
_label nama fasilitas yang ditampilkan
- hintTipe: string | null
detail fasilitas yang terstandardisasi
- hintTipe: string | null
_label detail fasilitas yang ditampilkan
- isTipe: boolean | null
_available menunjukkan apakah
amenitytersedia di hotel
- checkTipe: object | null · Response36Afe1097B20_TimeInfo
_in _time waktu check-in hotel
waktu check-in yang tertera di listing hotel- hourTipe: integer | null
jam dalam format 24 jam
- minuteTipe: integer | null
menit
- checkTipe: object | null · Response36Afe1097B20_TimeInfo
_out _time waktu check-out hotel
waktu check-out yang tertera di listing hotel- hourTipe: integer | null
jam dalam format 24 jam
- minuteTipe: integer | null
menit
- descriptionTipe: string | null
deskripsi hotel
deskripsi entitas hotel yang hasilnya dikumpulkan - domainTipe: string | null
domain hotel
domain situs web hotel - fullTipe: string | null
_address alamat lengkap hotel
alamat hotel yang tertera dalam format terstandardisasi - popularTipe: array (object | null)[] | null
_amenities fasilitas hotel
informasi tentang fasilitas hotel yang diberi label "popular"- amenityTipe: string | null
nama fasilitas yang terstandardisasi
- amenityTipe: string | null
_label nama fasilitas yang ditampilkan
- hintTipe: string | null
detail fasilitas yang terstandardisasi
- hintTipe: string | null
_label detail fasilitas yang ditampilkan
- isTipe: boolean | null
_available menunjukkan apakah
amenitytersedia di hotel
- subTipe: array (string | null)[] | null
_descriptions deskripsi tambahan hotel
detail tentang hotel yang diberikan sebagai tambahan pada deskripsi - urlTipe: string | null
url hotel
URL ke situs web hotel yang tertera di listing
- addressTipe: string | null
alamat hotel
alamat fisik hotel - checkTipe: string | null
_url URL langsung ke hasil mesin pencari
Anda dapat menggunakannya untuk memastikan kami memberikan hasil yang akurat - datetimeTipe: 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 - hotelTipe: string | null
_identifier pengenal yang diterima dalam array POST
field ini akan berisi parameterhotel_identifieryang ditentukan saat menyetel tugas;
contoh:CgoI-KWyzenM_MV3EAE - languageTipe: string | null
_code kode bahasa dalam array POST
- locationTipe: object | null · Response36Afe1097B20_HotelLocationInfo
informasi tentang lokasi hotel
informasi tentang lokasi tempat hotel berada- latitudeTipe: number | null
lintang hotel
koordinat lintang lokasi hotel
contoh:39.4806397 - locationTipe: array (object | null)[] | null
_chain elemen rantai lokasi
parameter tambahan setiap elemen rantai lokasi- cardTipe: string | null
_id pengenal kartu
- cidTipe: string | null
- featureTipe: string | null
_id - titleTipe: string | null
judul elemen dalam rantai lokasi
- longitudeTipe: number | null
bujur hotel
koordinat lintang lokasi hotel
contoh:-106.0512973 - mapsTipe: string | null
_url url ke lokasi hotel di google maps
- neighborhoodTipe: string | null
nama lingkungan tempat hotel berada
- neighborhoodTipe: string | null
_description deskripsi lingkungan tempat hotel berada
- overallTipe: number | null
_score skor keseluruhan lokasi hotel
menunjukkan skor keseluruhan lokasi hotel dalam rentang 1 hingga 5;
dihitung berdasarkan data kedekatan hotel dengan tempat wisata dan restoran, transportasi, serta bandara terdekat;
perhatikan bahwa kriteria tidak diberi bobot yang sama dalam skor keseluruhan - scoreTipe: object | null
_by _categories skor kategori lokasi hotel
skor lokasi hotel yang terkait dengan kategori yang menunjukkan kedekatan dengan tempat wisata, restoran, transportasi, dan bandara terdekat;- propertyTipe: number | null Format: double
Name
- locationTipe: integer | null
_code kode lokasi dalam array POST
- overviewTipe: array (string | null)[] | null
_images gambar yang ditampilkan di ringkasan hotel
array berisi URL gambar yang ditampilkan di ringkasan hotel - phoneTipe: string | null
nomor telepon hotel
nomor telepon kontak hotel - pricesTipe: object | null · Response36Afe1097B20_HotelPriceInfo
detail harga entitas hotel
berisi informasi tentang harga hotel- checkTipe: string | null
_in 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 - checkTipe: string | null
_out 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 - currencyTipe: string | null
mata uang harga
USDditerapkan secara default, kecuali ditentukan dalam array POST - discountTipe: string | null
_text teks tentang diskon yang diterapkan
- itemsTipe: array (object | null)[] | null
jenis item yang ditemukan
jenis hasil mesin pencari yang ditemukan dalam arrayitems;
jenis item yang mungkin:hotel_search_item- currencyTipe: string | null
mata uang harga
USDditerapkan secara default, kecuali ditentukan dalam array POST - domainTipe: string | null
domain pihak ketiga domain halaman situs web pihak ketiga dengan informasi harga
- freeTipe: string | null
_cancellation _until 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
- isTipe: boolean | null
_paid menunjukkan daftar hotel berbayar
jikatrue,hotel_search_itemterkait adalah iklan berbayar
jikafalse,hotel_search_itemterkait adalah daftar hotel organik - offersTipe: array (object | null)[] | null
penawaran harga unggulan
- currencyTipe: string | null
mata uang harga
USDditerapkan secara default, kecuali ditentukan dalam array POST - freeTipe: string | null
_cancellation _until 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
- maxTipe: integer | null
_visitors jumlah pengunjung maksimum jumlah maksimum pengunjung yang menjadi berlakunya penawaran harga
- offerTipe: array (string | null)[] | null
_images gambar penawaran harga URL gambar yang ditampilkan dalam penawaran harga
- priceTipe: number | null
harga per malam
- titleTipe: string | null
judul hotel
- typeTipe: string | null
jenis elemen
- urlTipe: string | null
url penawaran harga URL ke halaman situs web tempat penawaran harga muncul
- officialTipe: boolean | null
_site - priceTipe: number | null
harga per malam
- titleTipe: string | null
judul hotel
- typeTipe: string | null
jenis elemen
- urlTipe: string | null
url halaman pihak ketiga URL ke halaman situs web pihak ketiga dengan informasi harga
- priceTipe: number | null
harga per malam
- priceTipe: number | null Format: int64
_without _discount harga penuh per malam tanpa diskon
- pricesTipe: array (object | null)[] | null
_by _dates - checkTipe: string | null
_in _date - checkTipe: string | null
_out _date - currencyTipe: string | null
mata uang harga
USDditerapkan secara default, kecuali ditentukan dalam array POST - priceTipe: number | null
harga per malam
- visitorsTipe: integer | null
jumlah pengunjung hotel untuk harga ini
- reviewsTipe: object | null · Response36Afe1097B20_HotelReviewInfo
ulasan hotel menurut kriteria
informasi tentang ulasan entitas hotel- mentionsTipe: array (object | null)[] | null
sebutan hotel
informasi tentang ulasan hotel berdasarkan kriteria- negativeTipe: integer | null Format: int64
_count jumlah ulasan negatif menurut kriteria
- positiveTipe: integer | null Format: int64
_count jumlah ulasan positif menurut kriteria
- positiveTipe: number | null
_score skor positif menurut kriteria
- titleTipe: string | null
judul kriteria yang dievaluasi
- totalTipe: integer | null Format: int64
_count jumlah semua ulasan menurut kriteria
- visibleTipe: boolean | null
_by _default elemen terlihat secara default
menunjukkan apakah elemen ulasan terlihat secara default
- otherTipe: array (object | null)[] | null
_sites _reviews ulasan di situs pihak ketiga
ulasan dari situs pihak ketiga- ratingTipe: object | null · Response36Afe1097B20_RatingInfo
penilaian dalam ulasan
informasi tentang penilaian yang tercantum dalam ulasan di situs pihak ketiga- ratingTipe: integer | null
_max nilai maksimum untuk rating_type
- ratingTipe: string | null
_type jenis penilaian di sini Anda dapat menemukan elemen berikut: Max5, Percents, CustomMax
- valueTipe: number | null Format: double
nilai penilaian
- votesTipe: integer | null Format: int64
_count jumlah umpan balik
- reviewTipe: string | null
_text teks ulasan
teks ulasan - titleTipe: string | null
judul ulasan
berisi nama situs pihak ketiga tempat ulasan pertama kali muncul - urlTipe: string | null
url ulasan
URL ke situs pihak ketiga tempat ulasan pertama kali muncul
- ratingTipe: object | null
_distribution distribusi peringkat berdasarkan suara
distribusi suara di seluruh peringkat dalam rentang 1 hingga 5- propertyTipe: integer | null Format: Int64
Name
- valueTipe: number | null
rating hotel keseluruhan berdasarkan suara pelanggan
- votesTipe: integer | null Format: int64
_count jumlah suara pelanggan
jumlah suara pelanggan yang disertakan dalam perhitungan rating hotel
- starsTipe: integer | null
klasifikasi bintang hotel
klasifikasi bintang dalam rentang 1-5 bintang dan ditampilkan setelah peringkat ulasan di ringkasan hotel - starsTipe: string | null
_description klasifikasi bintang hotel
klasifikasi bintang dalam rentang 1-5 bintang dan ditampilkan setelah peringkat ulasan di ringkasan hotel - titleTipe: string | null
judul hotel
judul entitas hotel yang hasilnya dikumpulkan
- resultTipe: integer | null Format: int64
_count jumlah elemen dalam array hasil
- statusTipe: integer | null
_code kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini
- statusTipe: string | null
_message pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini
- timeTipe: string | null
waktu eksekusi, detik
- Tipe: integer | null Format: int64tasks
_count jumlah tugas dalam array tasks
- Tipe: integer | null Format: int64tasks
_error jumlah tugas dalam array tasks yang dikembalikan dengan error
- Tipe: string | nulltime
total waktu eksekusi, detik
- Tipe: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/live/advanced \
--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": "CgoI-KWyzenM_MV3EAE"
}
]'
{
"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": [
{
"hotel_identifier": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"title": null,
"stars": null,
"stars_description": null,
"address": null,
"phone": null,
"about": {
"description": null,
"sub_descriptions": [
"[Max Depth Exceeded]"
],
"check_in_time": "[Max Depth Exceeded]",
"check_out_time": "[Max Depth Exceeded]",
"full_address": null,
"domain": null,
"url": null,
"amenities": [
"[Max Depth Exceeded]"
],
"popular_amenities": [
"[Max Depth Exceeded]"
]
},
"location": {
"neighborhood": null,
"neighborhood_description": null,
"maps_url": null,
"overall_score": null,
"score_by_categories": null,
"latitude": null,
"longitude": null,
"location_chain": [
"[Max Depth Exceeded]"
]
},
"reviews": {
"value": null,
"votes_count": null,
"mentions": [
"[Max Depth Exceeded]"
],
"rating_distribution": null,
"other_sites_reviews": [
"[Max Depth Exceeded]"
]
},
"overview_images": [
null
],
"prices": {
"price": null,
"price_without_discount": null,
"currency": null,
"discount_text": null,
"check_in": null,
"check_out": null,
"visitors": null,
"items": [
"[Max Depth Exceeded]"
],
"prices_by_dates": [
"[Max Depth Exceeded]"
]
}
}
]
}
]
}