v0.2.0-beta

OpenAPI 3.1.0

Menetapkan Tugas Carian Hotel Google

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/task_post

Menetapkan Tugas Carian Hotel Google

Memasukkan carian Google Hotels ke baris gilir, memulangkan id tugas. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak masih memulangkan HTTP 200. Dapatkan dengan get_dataforseo_business_google_hotel_searches_fetch.

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
- pingback_url
  Jenis: string | null
  
  URL pemberitahuan tugas yang selesai
  medan pilihan
  apabila tugas selesai, kami akan memberitahu anda melalui permintaan GET yang dihantar ke URL yang anda tentukan
  anda boleh menggunakan rentetan ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.
  contoh:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Nota: aksara khas dalam pingback_url akan di-urlencode;
  iaitu, aksara # akan dikodkan menjadi %23
  
  ketahui lebih lanjut di Pusat Bantuan kami
- postback_url
  Jenis: string | null
  
  URL untuk menghantar hasil tugas
  medan pilihan
  selepas tugas selesai, kami akan menghantar permintaan POST dengan hasilnya yang dimampatkan dalam format gzip ke postback_url yang anda tentukan
  anda boleh menggunakan rentetan ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.
  contoh:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Nota: aksara khas dalam postback_url akan di-urlencode;
  iaitu, aksara # akan dikodkan menjadi %23
  
  ketahui lebih lanjut di Pusat Bantuan kami
- priority
  Jenis: integer | null
  
  keutamaan tugas
  medan pilihan
  boleh mengambil nilai berikut:
  1 – keutamaan pelaksanaan biasa (ditetapkan secara lalai)
  2 – keutamaan pelaksanaan tinggi Anda akan dicaj tambahan untuk tugas dengan keutamaan pelaksanaan tinggi.
  Kos boleh dikira di halaman Harga.
- 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_BusinessDataGoogleHotelSearchesTaskPostResponseInfo
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_BusinessDataGoogleHotelSearchesTaskPostTaskInfo
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: object | null

tatasusunan hasil
dalam kes ini, nilainya akan menjadi null

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

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": null
    }
  ]
}

Operasi berjaya

Menetapkan Tugas Carian Hotel Google

PengesahanRequired

DataForSEO

Menetapkan Tugas Carian Hotel Google

Rujukan harga