DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Info Hotel Google Langsung Lanjutan
Penyenaraian Google satu hotel: bilik, kemudahan, harga dan pilihan tempahan yang dipaparkan Google. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak masih memulangkan HTTP 200. Bentuk mentahnya ialah post_dataforseo_business_google_hotel_info_live_html, dan bentuk baris gilirnya post_dataforseo_business_google_hotel_info_submit. Untuk mencari hotel itu dahulu gunakan post_dataforseo_business_google_hotel_searches_live.
Rujukan harga
- Pemeteran: kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0,2428.
- Pengganda rujukan pelanggan: 1,0. Jangan gunakannya semula pada amaun pelanggan yang telah diselesaikan.
Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.
- Jenis: array (object | null)[]
- adultsJenis: integer | null
bilangan orang dewasa
medan pilihan
jika anda tidak menentukan medan ini, dua orang dewasa akan digunakan secara lalai
contoh:1 - checkJenis: string | null
_in tarikh daftar masuk
medan pilihan
jika anda tidak menentukan medan ini, tarikh esok akan digunakan secara lalai;
nilai tidak boleh lebih awal daripada tarikh hari ini
format tarikh:"yyyy-mm-dd"
contoh:"2019-01-15" - checkJenis: string | null
_out tarikh daftar keluar
medan pilihan
jika anda tidak menentukan medan ini, sistem kami akan menggunakan tarikh dua hari dari sekarang secara lalai;
Nota: nilai tidak boleh kurang daripada atau sama dengancheck_in;
julat antara nilaicheck_indancheck_outtidak boleh melebihi 30 hari
format tarikh:"yyyy-mm-dd"
contoh:"2019-01-15" - childrenJenis: array string[] | null
bilangan dan umur kanak-kanak
medan pilihan
jika anda tidak menentukan medan ini, tiada kanak-kanak akan disertakan dalam carian;tetapkan nilai berikut jika anda ingin menyertakan seorang kanak-kanak berumur 14 tahun:
[14]
tetapkan nilai berikut jika anda ingin menyertakan seorang kanak-kanak berumur 13 tahun dan seorang kanak-kanak berumur 8 tahun:[13,8] - currencyJenis: string | null
mata wang
medan pilihan
contoh:"USD" - hotelJenis: string
_identifier - languageJenis: string
_code kod bahasa enjin carian
medan wajib jika anda tidak menentukanlanguage_name
jika anda menggunakan medan ini, anda tidak perlu menentukanlanguage_name
anda boleh menerima senarai bahasa yang tersedia bersamalanguage_codemasing-masing dengan membuat permintaan berasingan kehttps://api.dataforseo.com/v3/business_data/google/languages
contoh:en - languageJenis: string
_name nama penuh bahasa enjin carian
medan wajib jika anda tidak menentukanlanguage_code
jika anda menggunakan medan ini, anda tidak perlu menentukanlanguage_code
anda boleh menerima senarai bahasa yang tersedia denganlanguage_namedengan membuat permintaan berasingan kehttps://api.dataforseo.com/v3/business_data/google/languages
contoh:English - loadJenis: boolean | null
_prices _by _dates muatkan harga penginapan hotel mengikut tarikh
medan pilihan
jika anda menentukan parameter ini dengantrue, respons akan menyertakan arrayprices_by_datesdengan harga penginapan hotel yang dibahagikan mengikut tarikh
jika anda menggunakan parameter ini, anda akan dicaj dua kali harga asas bagi setiap permintaan - locationJenis: integer
_code kod lokasi enjin carian
medan wajib jika anda tidak menentukanlocation_nameataulocation_coordinate
jika anda menggunakan medan ini, anda tidak perlu menentukanlocation_nameataulocation_coordinate
anda boleh menerima senarai lokasi enjin carian yang tersedia bersamalocation_codedengan membuat permintaan berasingan kehttps://api.dataforseo.com/v3/business_data/google/locations
contoh:2840 - locationJenis: string
_coordinate koordinat GPS sesuatu lokasi
medan wajib jika anda tidak menentukanlocation_nameataulocation_code
jika anda menggunakan medan ini, anda tidak perlu menentukanlocation_nameataulocation_code
Parameterlocation_coordinatehendaklah ditentukan dalam format "latitude, longitude"
bilangan maksimum digit perpuluhan untuk "latitude" dan "longitude": 7
Nota: jika koordinat digunakan untuk menetapkan lokasi, carian akan berlaku di penempatan terdekat;
contoh:53.476225,-2.243572 - locationJenis: string
_name nama penuh lokasi enjin carian
medan wajib jika anda tidak menentukanlocation_codeataulocation_coordinate
jika anda menggunakan medan ini, anda tidak perlu menentukanlocation_codeataulocation_coordinate
anda boleh menerima senarai lokasi yang tersedia denganlocation_namedengan membuat permintaan berasingan kehttps://api.dataforseo.com/v3/business_data/google/locations
contoh:London,England,United Kingdom - pricesJenis: string | null
_date _range tempoh pratetap untuk mendapatkan data harga harian
medan pilihan
untuk menggunakan parameter ini, anda mesti menentukanload_prices_by_datesdengantrue
jikaprices_start_datetidak ditentukan, tarikh mula ditetapkan kepada tarikhcheck_in
nilai yang mungkin:month,three_months,six_months,year
nilai lalai:month - pricesJenis: string | null
_end _date tarikh tamat untuk memuatkan harga mengikut tarikh
medan pilihan
untuk menggunakan parameter ini, anda mesti menentukanload_prices_by_datesdengantrue
jika parameter ini tidak ditentukan, anda akan mendapat harga mengikut tarikh untuk bulan tersebut
format tarikh:yyyy-mm-dd
contoh:2025-05-21 - pricesJenis: string | null
_start _date tarikh mula untuk memuatkan harga mengikut tarikh
medan pilihan
untuk menggunakan parameter ini, anda mesti menentukanload_prices_by_datesdengantrue
jika parameter ini tidak ditentukan, tarikh mula ditetapkan kepada tarikhcheck_in
format tarikh:yyyy-mm-dd
contoh:2025-05-20 - tagJenis: string | null
pengecam tugas yang ditentukan pengguna
medan pilihan
had aksara ialah 255
anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil
anda akan menemui nilaitagyang ditentukan dalam objekdatarespons
- Jenis: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo200
- Jenis: number | null Format: doublecost
jumlah kos tugas, USD
- Jenis: integer | nullstatus
_code kod status umum; anda boleh menemui senarai penuh kod respons di sini
- Jenis: string | nullstatus
_message mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini
- Jenis: array (object | null)[] | nulltasks
tatasusunan tugas
- Jenis: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo
- costJenis: number | null Format: double
jumlah kos tugas, USD
- dataJenis: object | null
mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST
- propertyJenis: object | null
Name
- idJenis: string | null
pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID
- pathJenis: array (string | null)[] | null
Laluan URL
- resultJenis: array (object | null)[] | null
tatasusunan hasil
- aboutJenis: object | null · Response36Afe1097B20_HotelAboutInfo
maklumat tentang hotel
- amenitiesJenis: array (object | null)[] | null
kemudahan hotel
maklumat tentang kemudahan hotel- categoryJenis: string | null
kategori kemudahan yang dipiawaikan
- categoryJenis: string | null
_label label kategori
- itemsJenis: array (object | null)[] | null
kemudahan dan butiran khusus
- amenityJenis: string | null
nama kemudahan yang dipiawaikan
- amenityJenis: string | null
_label nama kemudahan yang dipaparkan
- hintJenis: string | null
butiran kemudahan yang dipiawaikan
- hintJenis: string | null
_label butiran kemudahan yang dipaparkan
- isJenis: boolean | null
_available menunjukkan sama ada
amenitytersedia di hotel
- checkJenis: object | null · Response36Afe1097B20_TimeInfo
_in _time waktu daftar masuk hotel
waktu daftar masuk yang dinyatakan dalam penyenaraian hotel- hourJenis: integer | null
jam dalam format 24 jam
- minuteJenis: integer | null
minit
- checkJenis: object | null · Response36Afe1097B20_TimeInfo
_out _time waktu daftar keluar hotel
waktu daftar keluar yang dinyatakan dalam penyenaraian hotel- hourJenis: integer | null
jam dalam format 24 jam
- minuteJenis: integer | null
minit
- descriptionJenis: string | null
penerangan hotel
penerangan entiti hotel yang hasilnya dikumpulkan - domainJenis: string | null
domain hotel
domain laman web hotel - fullJenis: string | null
_address alamat penuh hotel
alamat hotel yang dinyatakan dalam format piawai - popularJenis: array (object | null)[] | null
_amenities kemudahan hotel
maklumat tentang kemudahan hotel yang dilabel "popular"- amenityJenis: string | null
nama kemudahan yang dipiawaikan
- amenityJenis: string | null
_label nama kemudahan yang dipaparkan
- hintJenis: string | null
butiran kemudahan yang dipiawaikan
- hintJenis: string | null
_label butiran kemudahan yang dipaparkan
- isJenis: boolean | null
_available menunjukkan sama ada
amenitytersedia di hotel
- subJenis: array (string | null)[] | null
_descriptions penerangan tambahan hotel
butiran tentang hotel yang diberikan sebagai tambahan kepada penerangan - urlJenis: string | null
url hotel
URL ke laman web hotel yang dinyatakan dalam penyenaraian
- addressJenis: string | null
alamat hotel
alamat fizikal hotel - checkJenis: string | null
_url URL terus ke hasil enjin carian
anda boleh menggunakannya untuk memastikan bahawa kami memberikan hasil yang tepat - datetimeJenis: string | null
tarikh dan masa hasil diterima
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:2019-11-15 12:57:46 +00:00 - hotelJenis: string | null
_identifier pengecam yang diterima dalam array POST
medan ini akan mengandungi parameterhotel_identifieryang ditentukan semasa menetapkan tugas;
contoh:CgoI-KWyzenM_MV3EAE - languageJenis: string | null
_code kod bahasa dalam array POST
- locationJenis: object | null · Response36Afe1097B20_HotelLocationInfo
maklumat tentang lokasi hotel
maklumat tentang lokasi tempat hotel berada- latitudeJenis: number | null
latitud hotel
koordinat latitud lokasi hotel
contoh:39.4806397 - locationJenis: array (object | null)[] | null
_chain elemen rantaian lokasi
parameter tambahan setiap elemen rantaian lokasi- cardJenis: string | null
_id pengecam kad
- cidJenis: string | null
- featureJenis: string | null
_id - titleJenis: string | null
tajuk elemen dalam rantaian lokasi
- longitudeJenis: number | null
longitud hotel
koordinat latitud lokasi hotel
contoh:-106.0512973 - mapsJenis: string | null
_url url ke lokasi hotel dalam google maps
- neighborhoodJenis: string | null
nama kawasan kejiranan tempat hotel terletak
- neighborhoodJenis: string | null
_description penerangan kawasan kejiranan tempat hotel terletak
- overallJenis: number | null
_score skor keseluruhan lokasi hotel
menunjukkan skor keseluruhan lokasi hotel dalam julat 1 hingga 5;
dikira berdasarkan data kedekatan hotel dengan tempat menarik dan restoran, pengangkutan serta lapangan terbang berhampiran;
ambil perhatian bahawa kriteria tidak diberi pemberat yang sama dalam skor keseluruhan - scoreJenis: object | null
_by _categories skor kategori lokasi hotel
skor lokasi hotel yang dikaitkan dengan kategori yang menunjukkan kedekatan dengan tempat menarik, restoran, pengangkutan dan lapangan terbang berhampiran;- propertyJenis: number | null Format: double
Name
- locationJenis: integer | null
_code kod lokasi dalam array POST
- overviewJenis: array (string | null)[] | null
_images imej yang dipaparkan dalam gambaran keseluruhan hotel
array yang mengandungi URL imej yang dipaparkan dalam gambaran keseluruhan hotel - phoneJenis: string | null
nombor telefon hotel
nombor telefon hubungan hotel - pricesJenis: object | null · Response36Afe1097B20_HotelPriceInfo
butiran harga entiti hotel
mengandungi maklumat tentang harga hotel- checkJenis: string | null
_in tarikh dan masa daftar masuk
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:2019-11-15 12:57:46 +00:00 - checkJenis: string | null
_out tarikh dan masa daftar keluar
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:2019-11-15 12:57:46 +00:00 - currencyJenis: string | null
mata wang harga
USDdigunakan secara lalai, melainkan dinyatakan dalam array POST - discountJenis: string | null
_text teks tentang diskaun yang digunakan
- itemsJenis: array (object | null)[] | null
jenis item yang ditemui
jenis hasil enjin carian yang ditemui dalam arrayitems;
jenis item yang mungkin:hotel_search_item- currencyJenis: string | null
mata wang harga
USDdigunakan secara lalai, melainkan dinyatakan dalam array POST - domainJenis: string | null
domain pihak ketiga domain halaman laman web pihak ketiga dengan maklumat harga
- freeJenis: string | null
_cancellation _until tarikh sehingga pembatalan percuma tersedia dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00” sama dengan null jika pembatalan percuma tidak tersedia untuk tarikh yang dipilih
- isJenis: boolean | null
_paid menunjukkan penyenaraian hotel berbayar
jikatrue,hotel_search_itemberkaitan ialah iklan berbayar
jikafalse,hotel_search_itemberkaitan ialah penyenaraian hotel organik - offersJenis: array (object | null)[] | null
tawaran harga pilihan
- currencyJenis: string | null
mata wang harga
USDdigunakan secara lalai, melainkan dinyatakan dalam array POST - freeJenis: string | null
_cancellation _until tarikh sehingga pembatalan percuma tersedia dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00” sama dengan null jika pembatalan percuma tidak tersedia untuk tarikh yang dipilih
- maxJenis: integer | null
_visitors bilangan maksimum pelawat bilangan maksimum pelawat yang baginya tawaran harga sah
- offerJenis: array (string | null)[] | null
_images imej tawaran harga URL imej yang dipaparkan dalam tawaran harga
- priceJenis: number | null
harga setiap malam
- titleJenis: string | null
tajuk hotel
- typeJenis: string | null
jenis elemen
- urlJenis: string | null
url tawaran harga URL ke halaman laman web tempat tawaran harga muncul
- officialJenis: boolean | null
_site - priceJenis: number | null
harga setiap malam
- titleJenis: string | null
tajuk hotel
- typeJenis: string | null
jenis elemen
- urlJenis: string | null
url halaman pihak ketiga URL ke halaman laman web pihak ketiga dengan maklumat harga
- priceJenis: number | null
harga setiap malam
- priceJenis: number | null Format: int64
_without _discount harga penuh setiap malam tanpa diskaun
- pricesJenis: array (object | null)[] | null
_by _dates - checkJenis: string | null
_in _date - checkJenis: string | null
_out _date - currencyJenis: string | null
mata wang harga
USDdigunakan secara lalai, melainkan dinyatakan dalam array POST - priceJenis: number | null
harga setiap malam
- visitorsJenis: integer | null
bilangan pelawat hotel untuk harga ini
- reviewsJenis: object | null · Response36Afe1097B20_HotelReviewInfo
ulasan hotel mengikut kriteria
maklumat tentang ulasan entiti hotel- mentionsJenis: array (object | null)[] | null
sebutan hotel
maklumat tentang ulasan hotel mengikut kriteria- negativeJenis: integer | null Format: int64
_count bilangan ulasan negatif mengikut kriteria
- positiveJenis: integer | null Format: int64
_count bilangan ulasan positif mengikut kriteria
- positiveJenis: number | null
_score skor positif mengikut kriteria
- titleJenis: string | null
tajuk kriteria yang dinilai
- totalJenis: integer | null Format: int64
_count bilangan semua ulasan mengikut kriteria
- visibleJenis: boolean | null
_by _default elemen kelihatan secara lalai
menunjukkan sama ada elemen ulasan kelihatan secara lalai
- otherJenis: array (object | null)[] | null
_sites _reviews ulasan di laman pihak ketiga
ulasan daripada laman pihak ketiga- ratingJenis: object | null · Response36Afe1097B20_RatingInfo
penilaian dalam ulasan
maklumat tentang penilaian yang terkandung dalam ulasan di laman pihak ketiga- ratingJenis: integer | null
_max nilai maksimum untuk rating_type
- ratingJenis: string | null
_type jenis penilaian di sini anda boleh menemui elemen berikut: Max5, Percents, CustomMax
- valueJenis: number | null Format: double
nilai penilaian
- votesJenis: integer | null Format: int64
_count jumlah maklum balas
- reviewJenis: string | null
_text teks ulasan
teks ulasan - titleJenis: string | null
tajuk ulasan
mengandungi nama laman pihak ketiga tempat ulasan mula-mula muncul - urlJenis: string | null
url ulasan
URL ke laman pihak ketiga tempat ulasan mula-mula muncul
- ratingJenis: object | null
_distribution taburan penilaian mengikut undian
taburan undian merentas penilaian dalam julat 1 hingga 5- propertyJenis: integer | null Format: Int64
Name
- valueJenis: number | null
penarafan hotel keseluruhan berdasarkan undian pelanggan
- votesJenis: integer | null Format: int64
_count bilangan undian pelanggan
bilangan undian pelanggan yang disertakan dalam pengiraan penarafan hotel
- starsJenis: integer | null
penarafan kelas hotel
penarafan kelas antara 1-5 bintang dan dipaparkan selepas penilaian ulasan dalam ringkasan hotel - starsJenis: string | null
_description penarafan kelas hotel
penarafan kelas antara 1-5 bintang dan dipaparkan selepas penilaian ulasan dalam ringkasan hotel - titleJenis: string | null
tajuk hotel
tajuk entiti hotel yang hasilnya dikumpulkan
- resultJenis: integer | null Format: int64
_count bilangan elemen dalam array hasil
- statusJenis: integer | null
_code kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini
- statusJenis: string | null
_message mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini
- timeJenis: string | null
masa pelaksanaan, saat
- Jenis: integer | null Format: int64tasks
_count bilangan tugas dalam array tasks
- Jenis: integer | null Format: int64tasks
_error bilangan tugas dalam array tasks yang dipulangkan dengan ralat
- Jenis: string | nulltime
jumlah masa pelaksanaan, saat
- Jenis: string | nullversion
versi semasa API
application/json - 400
Permintaan tidak dapat diproses. Semak parameter permintaan.
- 401
Kunci API Felo yang sah diperlukan.
- 402
Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
- 403
Akaun tidak dibenarkan melakukan operasi ini.
- 429
Had permintaan atau had perbelanjaan telah dicapai.
- 502
Perkhidmatan tidak dapat menyelesaikan permintaan.
- 503
API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
- 504
Perkhidmatan tamat masa semasa memproses permintaan.
- default
Respons ralat; respons passthrough huluan mungkin 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]"
]
}
}
]
}
]
}