v0.2.0-beta

OpenAPI 3.1.0

Dapatkan Hasil Carian Hotel Google mengikut id

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

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

Dapatkan Hasil Carian Hotel Google mengikut id

Mendapatkan carian Google Hotels dalam baris gilir mengikut id. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak masih memulangkan HTTP 200. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak masih memulangkan HTTP 200. ⚠️ Saiz respons ditetapkan oleh depth atau had semasa penghantaran dan tidak boleh disempitkan di sini; jika terlalu besar, hantar semula dengan nilai lebih kecil dan bukan menomborkan halaman.

Rujukan harga

Pemeteran: kos respons yang dilaporkan.
Anggaran rujukan setiap permintaan: USD 0,012.
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.

Parameter Laluan

id
Jenis: string
wajib

pengecam tugas
pengecam tugas unik dalam sistem kami dalam format UUID
anda boleh menggunakannya dalam tempoh 30 hari untuk meminta hasil tugas pada bila-bila masa

Respons

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

array item
Nota: medan ini sentiasa sama dengan null; gunakan untuk memudahkan integrasi dan memastikan interoperabiliti dengan endpoint Hotel Info

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);
untuk mendapatkan hasil carian yang tepat, nama lokasi ditambahkan pada kata kunci secara automatik

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

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'

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

Dapatkan Hasil Carian Hotel Google mengikut id

PengesahanRequired

DataForSEO

Dapatkan Hasil Carian Hotel Google mengikut id

Rujukan harga