v0.2.0-beta

OpenAPI 3.1.0

Dapatkan Hasil Info Hotel Google Lanjutan 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_info/task_get/advanced/{id}

Dapatkan Hasil Info Hotel Google Lanjutan mengikut id

Mendapatkan penyenaraian hotel dalam baris gilir mengikut id, yang telah dihuraikan. 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_BusinessDataGoogleHotelInfoTaskGetAdvancedResponseInfo
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_BusinessDataGoogleHotelInfoTaskGetAdvancedTaskInfo
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

about
Jenis: object | null · Response36Afe1097B20_HotelAboutInfo

maklumat tentang hotel

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

kemudahan hotel
maklumat tentang kemudahan hotel

category
Jenis: string | null

kategori kemudahan yang dipiawaikan

category_label
Jenis: string | null

label kategori

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

kemudahan dan butiran khusus

amenity
Jenis: string | null

nama kemudahan yang dipiawaikan

amenity_label
Jenis: string | null

nama kemudahan yang dipaparkan

hint
Jenis: string | null

butiran kemudahan yang dipiawaikan

hint_label
Jenis: string | null

butiran kemudahan yang dipaparkan

is_available
Jenis: boolean | null

menunjukkan sama ada amenity tersedia di hotel

check_in_time
Jenis: object | null · Response36Afe1097B20_TimeInfo

waktu daftar masuk hotel
waktu daftar masuk yang dinyatakan dalam penyenaraian hotel

hour
Jenis: integer | null

jam dalam format 24 jam

minute
Jenis: integer | null

minit

check_out_time
Jenis: object | null · Response36Afe1097B20_TimeInfo

waktu daftar keluar hotel
waktu daftar keluar yang dinyatakan dalam penyenaraian hotel

hour
Jenis: integer | null

jam dalam format 24 jam

minute
Jenis: integer | null

minit

description
Jenis: string | null

penerangan hotel
penerangan entiti hotel yang hasilnya dikumpulkan

domain
Jenis: string | null

domain hotel
domain laman web hotel

full_address
Jenis: string | null

alamat penuh hotel
alamat hotel yang dinyatakan dalam format piawai

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

kemudahan hotel
maklumat tentang kemudahan hotel yang dilabel "popular"

amenity
Jenis: string | null

nama kemudahan yang dipiawaikan

amenity_label
Jenis: string | null

nama kemudahan yang dipaparkan

hint
Jenis: string | null

butiran kemudahan yang dipiawaikan

hint_label
Jenis: string | null

butiran kemudahan yang dipaparkan

is_available
Jenis: boolean | null

menunjukkan sama ada amenity tersedia di hotel

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

penerangan tambahan hotel
butiran tentang hotel yang diberikan sebagai tambahan kepada penerangan

url
Jenis: string | null

url hotel
URL ke laman web hotel yang dinyatakan dalam penyenaraian

address
Jenis: string | null

alamat hotel
alamat fizikal hotel

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

hotel_identifier
Jenis: string | null

pengecam hotel unik
medan ini akan mengandungi parameter hotel_identifier;
contoh:
CgoI-KWyzenM_MV3EAE

language_code
Jenis: string | null

kod bahasa dalam array POST

location
Jenis: object | null · Response36Afe1097B20_HotelLocationInfo

maklumat tentang lokasi hotel
maklumat tentang lokasi tempat hotel berada

latitude
Jenis: number | null

latitud hotel
koordinat latitud lokasi hotel
contoh:
39.4806397

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

elemen rantaian lokasi
parameter tambahan setiap elemen rantaian lokasi

card_id
Jenis: string | null

pengecam kad

cid
Jenis: string | null

client id
ketahui lebih lanjut tentang pengecam dalam artikel Pusat Bantuan ini

feature_id
Jenis: string | null

pengecam ciri
ketahui lebih lanjut tentang pengecam dalam artikel Pusat Bantuan ini

title
Jenis: string | null

tajuk elemen dalam rantaian lokasi

longitude
Jenis: number | null

longitud hotel
koordinat latitud lokasi hotel
contoh:
-106.0512973

maps_url
Jenis: string | null

url ke lokasi hotel dalam google maps

neighborhood
Jenis: string | null

nama kawasan kejiranan tempat hotel terletak

neighborhood_description
Jenis: string | null

penerangan kawasan kejiranan tempat hotel terletak

overall_score
Jenis: number | null

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

score_by_categories
Jenis: object | null

skor kategori lokasi hotel
skor lokasi hotel yang dikaitkan dengan kategori yang menunjukkan kedekatan dengan tempat menarik, restoran, pengangkutan dan lapangan terbang berhampiran;

propertyName
Jenis: number | null Format: double
location_code
Jenis: integer | null

kod lokasi dalam array POST

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

imej yang dipaparkan dalam gambaran keseluruhan hotel
array yang mengandungi URL imej yang dipaparkan dalam gambaran keseluruhan hotel

phone
Jenis: string | null

nombor telefon hotel
nombor telefon hubungan hotel

prices
Jenis: object | null · Response36Afe1097B20_HotelPriceInfo

butiran harga entiti hotel
mengandungi maklumat tentang 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 hotel mengikut kriteria
maklumat tentang ulasan entiti 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 dan dipaparkan selepas penilaian ulasan dalam ringkasan hotel

stars_description
Jenis: string | null

penarafan kelas hotel
penarafan kelas antara 1-5 bintang dan dipaparkan selepas penilaian ulasan dalam ringkasan hotel

title
Jenis: string | null

tajuk hotel
tajuk entiti hotel yang hasilnya dikumpulkan

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_info/task_get/advanced/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/task_get/advanced/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": [
        {
          "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]"
            ]
          }
        }
      ]
    }
  ]
}

Operasi berjaya

Dapatkan Hasil Info Hotel Google Lanjutan mengikut id

PengesahanRequired

DataForSEO

Dapatkan Hasil Info Hotel Google Lanjutan mengikut id

Rujukan harga