v0.2.0-beta

OpenAPI 3.1.0

Tugas Carian Hotel Google Langsung

Felo API Support

MIT

Pelayan

https://openapi.felo.ai

Pustaka Klien

Shell Curl

DataForSEO

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

DataForSEO Operasi

post/v1/beta/dataforseo/business_data/google/hotel_searches/live

Tugas Carian Hotel Google Langsung

Mencari Google Hotels untuk hartanah yang sepadan dengan pertanyaan, bersama tarikh dan penghunian. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak masih memulangkan HTTP 200. Ini cara mencari hotel yang id-nya diperlukan endpoint info; post_dataforseo_business_google_hotel_info_live ialah paparan butiran.

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.

Badan

application/json

Jenis: array (object | null)[]
- adults
 Jenis: integer | null
 
 bilangan orang dewasa
 medan pilihan
 jika anda tidak menentukan medan ini, nilai lalai 2 akan digunakan;
 nota bahawa anda boleh menentukan sehingga 6 orang termasuk orang dewasa dan kanak-kanak
 contoh:
 1
- amenities
 Jenis: array string[] | null
 
 kemudahan hotel
 medan pilihan
 anda boleh menggunakan medan ini untuk menentukan pelbagai kemudahan 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
 Jenis: string | null
 
 tarikh daftar masuk
 medan pilihan
 jika anda tidak menentukan medan ini, tarikh esok akan digunakan secara lalai;
 format tarikh: "yyyy-mm-dd"
 contoh:
 "2019-01-15"
 Nota: nilai tidak boleh mendahului tarikh hari ini
- check_out
 Jenis: string | null
 
 tarikh daftar keluar
 medan pilihan
 jika anda tidak menentukan medan ini, sistem kami akan menggunakan tarikh dua hari dari sekarang secara lalai;
 format tarikh: "yyyy-mm-dd"
 contoh:
 "2019-01-15"
 Nota: nilai tidak boleh kurang daripada atau sama dengan check_in;
 julat antara nilai check_in dan check_out tidak boleh melebihi 30 hari
- children
 Jenis: array string[] | null
 
 bilangan dan umur kanak-kanak
 medan pilihan
 jika anda tidak menentukan medan ini, tiada kanak-kanak akan disertakan dalam carian;
 umur kanak-kanak boleh dari 0 hingga 17;
 nota bahawa anda boleh menentukan sehingga 6 orang termasuk orang dewasa dan kanak-kanak
 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]
- currency
 Jenis: string | null
 
 mata wang
 medan pilihan
 contoh:
 "USD"
- depth
 Jenis: integer | null
 
 kedalaman penghuraian
 medan pilihan
 bilangan hasil dalam Google Hotels
 nilai lalai: 18 hasil organik
 nilai maksimum: 140
 Nota: akaun anda akan dicaj bagi setiap 18 hasil organik tanpa mengira penyenaraian berbayar dalam respons;
 oleh itu, menetapkan kedalaman melebihi 18 boleh menyebabkan caj tambahan jika Google Hotels memulangkan lebih daripada 18 hasil;
 jika kedalaman yang ditentukan lebih tinggi daripada bilangan hasil dalam respons, perbezaannya akan dipulangkan secara automatik ke baki akaun anda
- free_cancellation
 Jenis: boolean | null
 
 hotel dengan pembatalan percuma
 medan pilihan
 tetapkan medan ini kepada true jika anda ingin mendapatkan senarai hotel dengan pembatalan tempahan percuma
 nilai lalai: false
- is_vacation_rentals
 Jenis: boolean | null
 
 carian sewa percutian
 medan pilihan
 tetapkan medan ini kepada true jika anda ingin mendapatkan senarai sewa percutian dan bukan hotel
 nilai lalai: false
- keyword
 Jenis: string | null
 
 kata kunci
 medan pilihan
 kata kunci yang anda tentukan digunakan untuk mencari senarai hotel;
 jika anda tidak menggunakan medan ini, kami akan memulangkan senarai hotel yang ditemui di lokasi yang ditentukan;
 anda boleh menentukan sehingga 700 aksara dalam medan keyword
 semua %## akan dinyahkod (aksara ‘+’ juga akan dinyahkod menjadi aksara ruang)
 jika anda perlu menggunakan aksara “%” untuk keyword, nyatakan sebagai “%25”;
 Nota: untuk mendapatkan hasil carian yang tepat, nama lokasi ditambahkan secara automatik pada kata kunci
 
 ketahui lebih lanjut tentang peraturan dan had medan keyword dan keywords dalam API DataForSEO dalam artikel Pusat Bantuan ini
- language_code
 Jenis: string
 
 kod bahasa enjin carian
 medan wajib jika anda tidak menentukan language_name
 jika anda menggunakan medan ini, anda tidak perlu menentukan language_name
 anda boleh menerima senarai bahasa yang tersedia bersama language_code masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/business_data/google/languages
 contoh:
 en
- language_name
 Jenis: string
 
 nama penuh bahasa enjin carian
 medan wajib jika anda tidak menentukan language_code
 jika anda menggunakan medan ini, anda tidak perlu menentukan language_code
 anda boleh menerima senarai bahasa yang tersedia dengan language_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/business_data/google/languages
 contoh:
 English
- location_code
 Jenis: integer
 
 kod lokasi enjin carian
 medan wajib jika anda tidak menentukan location_name atau location_coordinate
 jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_coordinate
 anda boleh menerima senarai lokasi enjin carian yang tersedia bersama location_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/business_data/google/locations
 contoh:
 2840
- location_coordinate
 Jenis: string
 
 koordinat GPS sesuatu lokasi
 medan wajib jika anda tidak menentukan location_name atau location_code
 jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_code
 Parameter location_coordinate hendaklah 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
- location_name
 Jenis: string
 
 nama penuh lokasi enjin carian
 medan wajib jika anda tidak menentukan location_code atau location_coordinate
 jika anda menggunakan medan ini, anda tidak perlu menentukan location_code atau location_coordinate
 anda boleh menerima senarai lokasi yang tersedia dengan location_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/business_data/google/locations
 contoh:
 London,England,United Kingdom
 Nota: untuk mendapatkan hasil carian yang tepat, location_name yang anda tentukan akan ditambahkan secara automatik pada kata kunci
- max_price
 Jenis: integer | null
 
 harga maksimum setiap malam
 medan pilihan
 mata wang nilai ini bergantung pada medan currency
 contoh:
 600
- min_price
 Jenis: integer | null
 
 harga minimum setiap malam
 medan pilihan
 mata wang nilai ini bergantung pada medan currency
 contoh:
 100
- min_rating
 Jenis: number | null
 
 penarafan minimum
 medan pilihan
 anda boleh menggunakan medan ini untuk menentukan penarafan tetamu yang lebih tinggi daripada nilai tertentu
 contoh:
 2.5
- search_this_area
 Jenis: boolean | null
 
 tunjukkan hotel dari kawasan yang dipaparkan
 medan pilihan
 boleh mengambil nilai: true, false
 nilai lalai: true
 jika ditetapkan kepada false, mod search_this_area akan dimatikan
 Nota: jika mod search_this_area dimatikan, location_name tidak akan ditambahkan pada keyword semasa carian
 ketahui lebih lanjut tentang parameter ini di Pusat Bantuan kami
- sort_by
 Jenis: string | null
 
 parameter susunan hasil
 medan pilihan
 anda boleh menggunakan medan ini untuk menyusun hasil
 jenis susunan yang mungkin:
 relevance – susun mengikut paling relevan
 lowest_price – susun mengikut harga terendah
 highest_rating – susun mengikut penarafan tertinggi
 most_reviewed – susun mengikut paling banyak diulas
 nilai lalai: relevance
- stars
 Jenis: array string[] | null
 
 bintang hotel
 medan pilihan
 tetapkan medan ini kepada [5] jika anda ingin mendapatkan senarai hotel 5 bintang sahaja
 contoh:
 [3,4,5]
- tag
 Jenis: 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 nilai tag yang ditentukan dalam objek data respons

Respons

200
Jenis: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveResponseInfo
cost
Jenis: number | null Format: double

jumlah kos tugas, USD

status_code
Jenis: integer | null

kod status umum; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

tasks
Jenis: array (object | null)[] | null

tatasusunan tugas

Jenis: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveTaskInfo
cost
Jenis: number | null Format: double

jumlah kos tugas, USD

data
Jenis: object | null

mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

propertyName
Jenis: object | null
id
Jenis: string | null

pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

path
Jenis: array (string | null)[] | null

Laluan URL

result
Jenis: array (object | null)[] | null

tatasusunan hasil

check_url
Jenis: string | null

URL terus ke hasil enjin carian
anda boleh menggunakannya untuk memastikan bahawa kami memberikan hasil yang tepat

datetime
Jenis: 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

items
Jenis: array (object | null)[] | null

jenis item yang ditemui
jenis hasil enjin carian yang ditemui dalam array items;
jenis item yang mungkin: hotel_search_item

hotel_identifier
Jenis: string | null

pengecam unik entiti hotel dalam carian Google
contoh:
CgoI-KWyzenM_MV3EAE

is_paid
Jenis: boolean | null

menunjukkan penyenaraian hotel berbayar
jika true, hotel_search_item berkaitan ialah iklan berbayar
jika false, hotel_search_item berkaitan ialah penyenaraian hotel organik

location
Jenis: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo

koordinat GPS lokasi hotel

latitude
Jenis: number | null

koordinat latitud hotel dalam google maps
contoh:
"latitude": 51.584091

longitude
Jenis: number | null

koordinat longitud hotel dalam google maps
contoh:
"longitude": -0.31365919999999997

overview_images
Jenis: array (string | null)[] | null

imej pilihan untuk hotel

prices
Jenis: object | null · Response36Afe1097B20_HotelPriceInfo

harga hotel

check_in
Jenis: string | null

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

check_out
Jenis: string | null

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

currency
Jenis: string | null

mata wang harga
USD digunakan secara lalai, melainkan dinyatakan dalam array POST

discount_text
Jenis: string | null

teks tentang diskaun yang digunakan

items
Jenis: array (object | null)[] | null

jenis item yang ditemui
jenis hasil enjin carian yang ditemui dalam array items;
jenis item yang mungkin: hotel_search_item

currency
Jenis: string | null

mata wang harga
USD digunakan secara lalai, melainkan dinyatakan dalam array POST

domain
Jenis: string | null

domain pihak ketiga domain halaman laman web pihak ketiga dengan maklumat harga

free_cancellation_until
Jenis: string | null

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

is_paid
Jenis: boolean | null

menunjukkan penyenaraian hotel berbayar
jika true, hotel_search_item berkaitan ialah iklan berbayar
jika false, hotel_search_item berkaitan ialah penyenaraian hotel organik

offers
Jenis: array (object | null)[] | null

tawaran harga pilihan

currency
Jenis: string | null

mata wang harga
USD digunakan secara lalai, melainkan dinyatakan dalam array POST

free_cancellation_until
Jenis: string | null

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

max_visitors
Jenis: integer | null

bilangan maksimum pelawat bilangan maksimum pelawat yang baginya tawaran harga sah

offer_images
Jenis: array (string | null)[] | null

imej tawaran harga URL imej yang dipaparkan dalam tawaran harga

price
Jenis: number | null

harga setiap malam

title
Jenis: string | null

tajuk hotel

type
Jenis: string | null

jenis elemen

url
Jenis: string | null

url tawaran harga URL ke halaman laman web tempat tawaran harga muncul

official_site
Jenis: boolean | null
price
Jenis: number | null

harga setiap malam

title
Jenis: string | null

tajuk hotel

type
Jenis: string | null

jenis elemen

url
Jenis: string | null

url halaman pihak ketiga URL ke halaman laman web pihak ketiga dengan maklumat harga

price
Jenis: number | null

harga setiap malam

price_without_discount
Jenis: number | null Format: int64

harga penuh setiap malam tanpa diskaun

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

mata wang harga
USD digunakan secara lalai, melainkan dinyatakan dalam array POST

price
Jenis: number | null

harga setiap malam

visitors
Jenis: integer | null

bilangan pelawat hotel untuk harga ini

reviews
Jenis: object | null · Response36Afe1097B20_HotelReviewInfo

ulasan dan maklumat penilaian hotel

mentions
Jenis: array (object | null)[] | null

sebutan hotel
maklumat tentang ulasan hotel mengikut kriteria

negative_count
Jenis: integer | null Format: int64

bilangan ulasan negatif mengikut kriteria

positive_count
Jenis: integer | null Format: int64

bilangan ulasan positif mengikut kriteria

positive_score
Jenis: number | null

skor positif mengikut kriteria

title
Jenis: string | null

tajuk kriteria yang dinilai

total_count
Jenis: integer | null Format: int64

bilangan semua ulasan mengikut kriteria

visible_by_default
Jenis: boolean | null

elemen kelihatan secara lalai
menunjukkan sama ada elemen ulasan kelihatan secara lalai

other_sites_reviews
Jenis: array (object | null)[] | null

ulasan di laman pihak ketiga
ulasan daripada laman pihak ketiga

rating
Jenis: object | null · Response36Afe1097B20_RatingInfo

penilaian dalam ulasan
maklumat tentang penilaian yang terkandung dalam ulasan di laman pihak ketiga

rating_max
Jenis: integer | null

nilai maksimum untuk rating_type

rating_type
Jenis: string | null

jenis penilaian di sini anda boleh menemui elemen berikut: Max5, Percents, CustomMax

value
Jenis: number | null Format: double

nilai penilaian

votes_count
Jenis: integer | null Format: int64

jumlah maklum balas

review_text
Jenis: string | null

teks ulasan
teks ulasan

title
Jenis: string | null

tajuk ulasan
mengandungi nama laman pihak ketiga tempat ulasan mula-mula muncul

url
Jenis: string | null

url ulasan
URL ke laman pihak ketiga tempat ulasan mula-mula muncul

rating_distribution
Jenis: object | null

taburan penilaian mengikut undian
taburan undian merentas penilaian dalam julat 1 hingga 5

propertyName
Jenis: integer | null Format: Int64
value
Jenis: number | null

penarafan hotel keseluruhan berdasarkan undian pelanggan

votes_count
Jenis: integer | null Format: int64

bilangan undian pelanggan
bilangan undian pelanggan yang disertakan dalam pengiraan penarafan hotel

stars
Jenis: integer | null

penarafan kelas hotel
penarafan kelas antara 1-5 bintang

title
Jenis: string | null

tajuk hotel

type
Jenis: string | null

jenis elemen

items_count
Jenis: integer | null Format: int64

jenis item
bilangan item dalam array items

keyword
Jenis: string | null

kata kunci yang diterima dalam array POST
kata kunci dipulangkan dengan %## dinyahkod (aksara tambah '+' akan dinyahkod menjadi aksara ruang)

language_code
Jenis: string | null

kod bahasa dalam array POST

location_code
Jenis: integer | null

kod lokasi dalam array POST

result_count
Jenis: integer | null Format: int64

bilangan elemen dalam array hasil

status_code
Jenis: integer | null

kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

time
Jenis: string | null

masa pelaksanaan, saat

tasks_count
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks

tasks_error
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks yang dipulangkan dengan ralat

time
Jenis: string | null

jumlah masa pelaksanaan, saat

version
Jenis: string | null

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

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"
  }
]'

Tunjukkan 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 berjaya

Tugas Carian Hotel Google Langsung

PengesahanRequired

DataForSEO

Tugas Carian Hotel Google Langsung

Rujukan harga