Canlı Google Hotel Searches görevleri
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Canlı Google Hotel Searches görevleri
Sorguyla eşleşen tesisler için Google Hotels'te tarih ve doluluk bilgisiyle arama yapar. Yanıt DataForSEO zarfı içinde gelir: veriler tasks[0].result, sonuç tasks[0].status_code içindedir; reddedilen bir istek yine de HTTP 200 döndürür. Bilgi uç noktalarının ihtiyaç duyduğu id değerine sahip oteli bulmanın yolu budur; post_dataforseo_business_google_hotel_info_live ayrıntı görünümüdür.
Fiyatlandırma referansı
- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek maliyeti tahmini: USD 0.2428.
- Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.
Yalnızca referans üst verisidir — hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.
- Tür: array (object | null)[]
- adultsTür: integer | null
yetişkin sayısı
isteğe bağlı alan
bu alanı belirtmezseniz varsayılan2değeri uygulanır;
not: yetişkinler ve çocuklar dahil olmak üzere en fazla 6 kişi belirtebilirsiniz
örnek:1 - amenitiesTür: array string[] | null
otel olanakları
isteğe bağlı alan
farklı otel olanaklarını belirtmek için bu alanı kullanabilirsiniz
örnek:[
"free_parking",
"pets_allowed"
]
olası değerler:"air_conditioning",<br>"all_inclusive_available",<br>"bar",<br>"free_breakfast",<br>"fitness_center",<br>"kid_friendly",<br>"free_parking",<br>"pets_allowed",<br>"pool",<br>"restaurant",<br>"room_service",<br>"spa",<br>"free_wifi",<br>"parking",<br>"indoor_pool",<br>"outdoor_pool",<br>"wheelchair_accessible",<br>"beach_access" - checkTür: string | null
_in giriş tarihi
isteğe bağlı alan
bu alanı belirtmezseniz varsayılan olarak yarının tarihi kullanılır;
tarih biçimi:"yyyy-mm-dd"
örnek:"2019-01-15"
Not: değer bugünün tarihinden önce olamaz - checkTür: string | null
_out çıkış tarihi
isteğe bağlı alan
bu alanı belirtmezseniz sistemimiz varsayılan olarak iki gün sonraki tarihi uygular;
tarih biçimi:"yyyy-mm-dd"
örnek:"2019-01-15"
Not: değercheck_indeğerine eşit veya ondan küçük olamaz;check_invecheck_outdeğerleri arasındaki aralık 30 günü aşamaz - childrenTür: array string[] | null
çocuk sayısı ve yaşı
isteğe bağlı alan
bu alanı belirtmezseniz aramaya hiçbir çocuk dahil edilmez;
çocuk yaşı0ile17arasında olabilir;
not: yetişkinler ve çocuklar dahil olmak üzere en fazla 6 kişi belirtebilirsiniz
bir adet 14 yaşında çocuk eklemek için aşağıdaki değeri ayarlayın:[14]
bir adet 13 yaşında ve bir adet 8 yaşında çocuk eklemek için aşağıdaki değeri ayarlayın:[13,8] - currencyTür: string | null
para birimi
isteğe bağlı alan
örnek:"USD" - depthTür: integer | null
ayrıştırma derinliği
isteğe bağlı alan
Google Hotels içindeki sonuç sayısı
varsayılan değer:18organik sonuç
maksimum değer:140
Not: yanıttaki ücretli listelemelerden bağımsız olarak hesabınızdan her 18 organik sonuç için ücret alınır;
bu nedenle18üzerinde bir derinlik ayarlamak, Google Hotels 18'den fazla sonuç döndürürse ek ücretlere yol açabilir;
belirtilen derinlik yanıttaki sonuç sayısından yüksekse fark otomatik olarak hesap bakiyenize iade edilir - freeTür: boolean | null
_cancellation ücretsiz iptal sunan oteller
isteğe bağlı alan
rezervasyonları ücretsiz iptal edilebilen otellerin listesini almak istiyorsanız bu alanıtrueolarak ayarlayın
varsayılan değer:false - isTür: boolean | null
_vacation _rentals tatil kiralamalarında arama
isteğe bağlı alan
oteller yerine tatil kiralamalarının listesini almak istiyorsanız bu alanıtrueolarak ayarlayın
varsayılan değer:false - keywordTür: string | null
anahtar kelime
isteğe bağlı alan
belirttiğiniz anahtar kelime otel listesini aramak için kullanılır;
bu alanı kullanmazsanız belirtilen konumda bulunan otellerin listesini döndürürüz;keywordalanında en fazla 700 karakter belirtebilirsiniz
tüm %## dizileri çözümlenir (“+” karakteri boşluk karakterine çözümlenir)keywordiçin “%” karakterini kullanmanız gerekiyorsa “%25” olarak belirtin;
Not: doğru arama sonuçları elde etmek için konum adı anahtar kelimeye otomatik olarak eklenirDataForSEO API'lerindeki
keywordvekeywordsalanlarının kuralları ve sınırlamaları hakkında daha fazla bilgiyi bu yardım merkezi makalesinde bulabilirsiniz - languageTür: string
_code arama motoru dil kodu
language_namebelirtmezseniz zorunlu alan
bu alanı kullanırsanızlanguage_namebelirtmeniz gerekmez
mevcut dillerin listesinilanguage_codedeğerleriyle birliktehttps://api.dataforseo.com/v3/business_data/google/languagesadresine ayrı bir istek yaparak alabilirsiniz
örnek:en - languageTür: string
_name arama motoru dilinin tam adı
language_codebelirtmezseniz zorunlu alan
bu alanı kullanırsanızlanguage_codebelirtmeniz gerekmez
mevcut dillerin listesinilanguage_namedeğerleriyle birliktehttps://api.dataforseo.com/v3/business_data/google/languagesadresine ayrı bir istek yaparak alabilirsiniz
örnek:English - locationTür: integer
_code arama motoru konum kodu
location_nameveyalocation_coordinatebelirtmezseniz zorunlu alan
bu alanı kullanırsanızlocation_nameveyalocation_coordinatebelirtmeniz gerekmez
mevcut konumların listesinilocation_codedeğerleriyle birliktehttps://api.dataforseo.com/v3/business_data/google/locationsadresine ayrı bir istek yaparak alabilirsiniz
örnek:2840 - locationTür: string
_coordinate bir konumun GPS koordinatları
location_nameveyalocation_codebelirtmezseniz zorunlu alan
bu alanı kullanırsanızlocation_nameveyalocation_codebelirtmeniz gerekmezlocation_coordinateparametresi "latitude,longitude" biçiminde belirtilmelidir
"latitude" ve "longitude" için maksimum ondalık basamak sayısı: 7
Not: koordinatlar bir konumu ayarlamak için kullanılırsa arama en yakın yerleşim yerinde gerçekleşir
örnek:53.476225,-2.243572 - locationTür: string
_name arama motoru konumunun tam adı
location_codeveyalocation_coordinatebelirtmezseniz zorunlu alan
bu alanı kullanırsanızlocation_codeveyalocation_coordinatebelirtmeniz gerekmez
mevcut konumların listesinilocation_namedeğerleriyle birliktehttps://api.dataforseo.com/v3/business_data/google/locationsadresine ayrı bir istek yaparak alabilirsiniz
örnek:London,England,United Kingdom
Not: doğru arama sonuçları elde etmek için belirttiğinizlocation_nameanahtar kelimeye otomatik olarak eklenir - maxTür: integer | null
_price gecelik maksimum fiyat
isteğe bağlı alan
bu değerin para birimicurrencyalanına bağlıdır
örnek:600 - minTür: integer | null
_price gecelik minimum fiyat
isteğe bağlı alan
bu değerin para birimicurrencyalanına bağlıdır
örnek:100 - minTür: number | null
_rating minimum puan
isteğe bağlı alan
misafir puanının belirli bir değerden yüksek olmasını belirtmek için bu alanı kullanabilirsiniz
örnek:2.5 - searchTür: boolean | null
_this _area görüntülenen alandaki otelleri göster
isteğe bağlı alan
şu değerleri alabilir:true,false
varsayılan değer:truefalseolarak ayarlanırsasearch_this_areamodu kapatılır
Not:search_this_areamodu kapalıysa arama sırasındalocation_namekeyworddeğerine eklenmez
bu parametre hakkında daha fazla bilgiyi yardım merkezimizde bulabilirsiniz - sortTür: string | null
_by sonuç sıralama parametreleri
isteğe bağlı alan
sonuçları sıralamak için bu alanı kullanabilirsiniz
olası sıralama türleri:relevance– en alakalıya göre sıralalowest_price– en düşük fiyata göre sıralahighest_rating– en yüksek puana göre sıralamost_reviewed– en çok yorumlanana göre sırala
varsayılan değer:relevance - starsTür: array string[] | null
otel yıldızları
isteğe bağlı alan
yalnızca 5 yıldızlı otellerin listesini almak istiyorsanız bu alanı[5]olarak ayarlayın
örnek:[3,4,5] - tagTür: string | null
kullanıcı tanımlı görev tanımlayıcısı
isteğe bağlı alan
karakter sınırı 255
bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz
belirtilentagdeğerini yanıtındatanesnesinde bulacaksınız
- Tür: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveResponseInfo200
- Tür: number | null Biçim: doublecost
toplam görev maliyeti, USD
- Tür: integer | nullstatus
_code genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz
- Tür: string | nullstatus
_message genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- Tür: array (object | null)[] | nulltasks
görev dizisi
- Tür: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveTaskInfo
- costTür: number | null Biçim: double
toplam görev maliyeti, USD
- dataTür: object | null
POST isteğinde belirttiğiniz parametrelerin aynısını içerir
- propertyTür: object | null
Name
- idTür: string | null
görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı
- pathTür: array (string | null)[] | null
URL yolu
- resultTür: array (object | null)[] | null
sonuç dizisi
- checkTür: string | null
_url arama motoru sonuçlarına doğrudan URL
doğru sonuçlar sunduğumuzdan emin olmak için kullanabilirsiniz - datetimeTür: string | null
sonucun alındığı tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2019-11-15 12:57:46 +00:00 - itemsTür: array (object | null)[] | null
karşılaşılan öğe türleri
itemsdizisinde karşılaşılan arama motoru sonuç türleri;
olası öğe türleri:hotel_search_item- hotelTür: string | null
_identifier Google aramasında otel varlığının benzersiz tanımlayıcısı
örnek:CgoI-KWyzenM_MV3EAE - isTür: boolean | null
_paid ücretli otel kaydını belirtir
trueise ilgilihotel_search_itemücretli bir reklamdırfalseise ilgilihotel_search_itemorganik bir otel kaydıdır - locationTür: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo
otelin konumunun GPS koordinatları
- latitudeTür: number | null
otelin Google Haritalar'daki enlem koordinatı
örnek:"latitude": 51.584091 - longitudeTür: number | null
otelin Google Haritalar'daki boylam koordinatı
örnek:"longitude": -0.31365919999999997
- overviewTür: array (string | null)[] | null
_images otel için öne çıkan görseller
- pricesTür: object | null · Response36Afe1097B20_HotelPriceInfo
otel fiyatı
- checkTür: string | null
_in giriş tarihi ve saati
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2019-11-15 12:57:46 +00:00 - checkTür: string | null
_out çıkış tarihi ve saati
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2019-11-15 12:57:46 +00:00 - currencyTür: string | null
fiyat para birimi
POST dizisinde belirtilmediği sürece varsayılan olarakUSDuygulanır - discountTür: string | null
_text uygulanan indirime ilişkin metin
- itemsTür: array (object | null)[] | null
karşılaşılan öğe türleri
itemsdizisinde karşılaşılan arama motoru sonuç türleri;
olası öğe türleri:hotel_search_item- currencyTür: string | null
fiyat para birimi
POST dizisinde belirtilmediği sürece varsayılan olarakUSDuygulanır - domainTür: string | null
üçüncü taraf alan adı fiyat bilgilerini içeren üçüncü taraf web sitesi sayfasının alan adı
- freeTür: string | null
_cancellation _until ücretsiz iptalin sunulduğu tarihe kadar UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00” seçilen tarihler için ücretsiz iptal sunulmuyorsa null değerine eşittir
- isTür: boolean | null
_paid ücretli otel kaydını belirtir
trueise ilgilihotel_search_itemücretli bir reklamdırfalseise ilgilihotel_search_itemorganik bir otel kaydıdır - offersTür: array (object | null)[] | null
öne çıkan fiyat teklifleri
- currencyTür: string | null
fiyat para birimi
POST dizisinde belirtilmediği sürece varsayılan olarakUSDuygulanır - freeTür: string | null
_cancellation _until ücretsiz iptalin sunulduğu tarihe kadar UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00” seçilen tarihler için ücretsiz iptal sunulmuyorsa null değerine eşittir
- maxTür: integer | null
_visitors maksimum ziyaretçi sayısı fiyat teklifinin geçerli olduğu maksimum ziyaretçi sayısı
- offerTür: array (string | null)[] | null
_images fiyat teklifi görselleri fiyat teklifinde yer alan görsellerin URL'leri
- priceTür: number | null
gecelik fiyat
- titleTür: string | null
otelin adı
- typeTür: string | null
öğe türü
- urlTür: string | null
fiyat teklifinin url'si fiyat teklifinin göründüğü web sitesi sayfasının URL'si
- officialTür: boolean | null
_site - priceTür: number | null
gecelik fiyat
- titleTür: string | null
otelin adı
- typeTür: string | null
öğe türü
- urlTür: string | null
üçüncü taraf sayfa url'si fiyat bilgilerini içeren üçüncü taraf web sitesi sayfasının URL'si
- priceTür: number | null
gecelik fiyat
- priceTür: number | null Biçim: int64
_without _discount indirim uygulanmamış tam gecelik fiyat
- pricesTür: array (object | null)[] | null
_by _dates - checkTür: string | null
_in _date - checkTür: string | null
_out _date - currencyTür: string | null
fiyat para birimi
POST dizisinde belirtilmediği sürece varsayılan olarakUSDuygulanır - priceTür: number | null
gecelik fiyat
- visitorsTür: integer | null
bu fiyat için otel ziyaretçisi sayısı
- reviewsTür: object | null · Response36Afe1097B20_HotelReviewInfo
otel yorumları ve puan bilgileri
- mentionsTür: array (object | null)[] | null
otelden bahsedilme
kriterlere göre otel yorumlarına ilişkin bilgiler- negativeTür: integer | null Biçim: int64
_count ölçüte göre olumsuz yorum sayısı
- positiveTür: integer | null Biçim: int64
_count ölçüte göre olumlu yorum sayısı
- positiveTür: number | null
_score ölçüte göre olumlu puan
- titleTür: string | null
değerlendirilen ölçütün başlığı
- totalTür: integer | null Biçim: int64
_count ölçüte göre tüm yorumların sayısı
- visibleTür: boolean | null
_by _default öğe varsayılan olarak görünür
yorum öğesinin varsayılan olarak görünür olup olmadığını belirtir
- otherTür: array (object | null)[] | null
_sites _reviews üçüncü taraf sitelerdeki yorumlar
üçüncü taraf sitelerden gelen yorumlar- ratingTür: object | null · Response36Afe1097B20_RatingInfo
yorumdaki puanlama
üçüncü taraf bir sitedeki yorumda yer alan puanlama hakkında bilgiler- ratingTür: integer | null
_max rating_type için maksimum değer
- ratingTür: string | null
_type puanlama türü burada şu öğeleri bulabilirsiniz: Max5, Percents, CustomMax
- valueTür: number | null Biçim: double
puanlamanın değeri
- votesTür: integer | null Biçim: int64
_count geri bildirim miktarı
- reviewTür: string | null
_text yorum metni
yorumun metni - titleTür: string | null
yorum başlığı
yorumun ilk olarak göründüğü üçüncü taraf sitesinin adını içerir - urlTür: string | null
yorum URL'si
yorumun ilk olarak göründüğü üçüncü taraf sitesinin URL'si
- ratingTür: object | null
_distribution oylara göre puan dağılımı
1 ile 5 aralığındaki puanlara göre oy dağılımı- propertyTür: integer | null Biçim: Int64
Name
- valueTür: number | null
müşteri oylarına dayalı genel otel puanı
- votesTür: integer | null Biçim: int64
_count müşteri oyu sayısı
otel puanının hesaplanmasına dahil edilen müşteri oyu sayısı
- starsTür: integer | null
otel sınıf puanı
1-5 yıldız aralığındaki sınıf puanı - titleTür: string | null
otelin adı
- typeTür: string | null
öğe türü
- itemsTür: integer | null Biçim: int64
_count öğe türleri
itemsdizisindeki öğe sayısı - keywordTür: string | null
POST dizisinde alınan anahtar kelime
anahtar kelime, çözümlenmiş %## ile döndürülür ('+' artı karakteri boşluk karakterine çözümlenir) - languageTür: string | null
_code POST dizisindeki dil kodu
- locationTür: integer | null
_code POST dizisindeki konum kodu
- resultTür: integer | null Biçim: int64
_count result dizisindeki öğe sayısı
- statusTür: integer | null
_code görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz
- statusTür: string | null
_message görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- timeTür: string | null
yürütme süresi, saniye
- Tür: integer | null Biçim: int64tasks
_count tasks dizisindeki görev sayısı
- Tür: integer | null Biçim: int64tasks
_error tasks dizisinde hata ile dönen görev sayısı
- Tür: string | nulltime
toplam yürütme süresi, saniye
- Tür: string | nullversion
API'nin geçerli sürümü
application/json - 400
İstek işlenemedi. İstek parametrelerini kontrol edin.
- 401
Geçerli bir Felo API anahtarı gerekir.
- 402
Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.
- 403
Hesabın bu işlemi gerçekleştirme izni yok.
- 429
İstek veya harcama sınırına ulaşıldı.
- 502
Hizmet isteği tamamlayamadı.
- 503
API veya faturalandırma hizmeti geçici olarak kullanılamıyor.
- 504
İstek işlenirken hizmet zaman aşımına uğradı.
- default
Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir
application/json
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"
}
]'
{
"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]"
}
]
}
]
}
]
}