DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Canlı Google Hotel Info gelişmiş
Bir otelin Google kaydı: odalar, olanaklar, fiyatlar ve Google'ın gösterdiği rezervasyon seçenekleri. 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. Ham biçim post_dataforseo_business_google_hotel_info_live_html, kuyruklu biçim post_dataforseo_business_google_hotel_info_submit. Oteli önce bulmak için post_dataforseo_business_google_hotel_searches_live kullanın.
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ılan olarak iki yetişkin kullanılır
örnek:1 - 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;
değer bugünün tarihinden önce olamaz
tarih biçimi:"yyyy-mm-dd"
örnek:"2019-01-15" - 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;
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
tarih biçimi:"yyyy-mm-dd"
örnek:"2019-01-15" - childrenTür: array string[] | null
çocuk sayısı ve yaşı
isteğe bağlı alan
bu alanı belirtmezseniz aramaya hiçbir çocuk dahil edilmez;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" - hotelTür: string
_identifier benzersiz otel tanımlayıcısı
zorunlu alan
Google aramasında bir otel varlığının benzersiz tanımlayıcısı;
değeri Advanced Google SERP API (yanıtınhotelsöğesinde yer alır) veya Business Data API'nin Hotel Searches uç noktası üzerinden istek yaparak elde edebilirsiniz
örnek:ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE - 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 - loadTür: boolean | null
_prices _by _dates otel konaklama fiyatlarını tarihlere göre yükle
isteğe bağlı alan
bu parametreyitruedeğeriyle belirtirseniz yanıt, tarihlere göre bölünmüş otel konaklama fiyatlarını içerenprices_by_datesdizisini içerir
bu parametreyi kullanırsanız istek başına temel fiyatın iki katı tahsil edilir - 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 - pricesTür: string | null
_date _range günlük fiyat verilerini almak için önceden tanımlanmış dönem
isteğe bağlı alan
bu parametreyi kullanmak içinload_prices_by_datesdeğerinitrueolarak belirtmeniz gerekirprices_start_datebelirtilmezse başlangıç tarihicheck_intarihine ayarlanır
olası değerler:month,three_months,six_months,year
varsayılan değer:month - pricesTür: string | null
_end _date fiyatları tarihlere göre yüklemek için bitiş tarihi
isteğe bağlı alan
bu parametreyi kullanmak içinload_prices_by_datesdeğerinitrueolarak belirtmeniz gerekir
bu parametre belirtilmezse ay için tarihe göre fiyatlar alırsınız
tarih biçimi:yyyy-mm-dd
örnek:2025-05-21 - pricesTür: string | null
_start _date fiyatları tarihlere göre yüklemek için başlangıç tarihi
isteğe bağlı alan
bu parametreyi kullanmak içinload_prices_by_datesdeğerinitrueolarak belirtmeniz gerekir
bu parametre belirtilmezse başlangıç tarihicheck_intarihine ayarlanır
tarih biçimi:yyyy-mm-dd
örnek:2025-05-20 - 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_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo200
- 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_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo
- 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
- aboutTür: object | null · Response36Afe1097B20_HotelAboutInfo
otel hakkında bilgiler
- amenitiesTür: array (object | null)[] | null
otel olanakları
otel olanaklarına ilişkin bilgiler- categoryTür: string | null
olanağın standart kategorisi
- categoryTür: string | null
_label kategorinin etiketi
- itemsTür: array (object | null)[] | null
belirli olanaklar ve ayrıntılar
- amenityTür: string | null
standart olanak adı
- amenityTür: string | null
_label görünen olanak adı
- hintTür: string | null
olanak hakkında standart ayrıntılar
- hintTür: string | null
_label olanak hakkında görünen ayrıntılar
- isTür: boolean | null
_available amenityolanağının otelde mevcut olup olmadığını belirtir
- checkTür: object | null · Response36Afe1097B20_TimeInfo
_in _time otel giriş saati
otel listesinde belirtilen giriş saati- hourTür: integer | null
24 saat biçimindeki saat
- minuteTür: integer | null
dakika
- checkTür: object | null · Response36Afe1097B20_TimeInfo
_out _time otel çıkış saati
otel listesinde belirtilen çıkış saati- hourTür: integer | null
24 saat biçimindeki saat
- minuteTür: integer | null
dakika
- descriptionTür: string | null
otelin açıklaması
sonuçların toplandığı otel varlığının açıklaması - domainTür: string | null
otel alan adı
otelin web sitesinin alan adı - fullTür: string | null
_address otelin tam adresi
standart biçimde belirtilen otel adresi - popularTür: array (object | null)[] | null
_amenities otel olanakları
„popüler” olarak işaretlenen otel olanaklarına ilişkin bilgiler- amenityTür: string | null
standart olanak adı
- amenityTür: string | null
_label görünen olanak adı
- hintTür: string | null
olanak hakkında standart ayrıntılar
- hintTür: string | null
_label olanak hakkında görünen ayrıntılar
- isTür: boolean | null
_available amenityolanağının otelde mevcut olup olmadığını belirtir
- subTür: array (string | null)[] | null
_descriptions otelin ek açıklaması
açıklamaya ek olarak sağlanan otel ayrıntıları - urlTür: string | null
otel url'si
listede belirtilen otelin web sitesinin URL'si
- addressTür: string | null
otel adresi
otelin fiziksel adresi - 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 - hotelTür: string | null
_identifier POST dizisinde alınan tanımlayıcı
bu alan, görev ayarlanırken belirtilenhotel_identifierparametresini içerir;
örnek:CgoI-KWyzenM_MV3EAE - languageTür: string | null
_code POST dizisindeki dil kodu
- locationTür: object | null · Response36Afe1097B20_HotelLocationInfo
otelin konumu hakkında bilgiler
otelin bulunduğu konum hakkında bilgiler- latitudeTür: number | null
otel enlemi
otelin konumunun enlem koordinatları
örnek:39.4806397 - locationTür: array (object | null)[] | null
_chain konum zincirinin öğeleri
konum zincirindeki her öğenin ek parametreleri- cardTür: string | null
_id kart tanımlayıcısı
- cidTür: string | null
- featureTür: string | null
_id - titleTür: string | null
konum zincirindeki öğenin başlığı
- longitudeTür: number | null
otel boylamı
otelin konumunun boylam koordinatları
örnek:-106.0512973 - mapsTür: string | null
_url otelin Google Haritalar'daki konumunun url'si
- neighborhoodTür: string | null
otelin bulunduğu mahallenin adı
- neighborhoodTür: string | null
_description otelin bulunduğu mahallenin açıklaması
- overallTür: number | null
_score otel konumunun genel puanı
otelin konumunun 1 ile 5 arasındaki genel puanını belirtir;
otelin yakındaki yapılacak aktivitelere ve restoranlara, ulaşıma ve havalimanlarına yakınlığına ilişkin verilere dayanarak hesaplanır;
kriterlerin genel puanda eşit ağırlığa sahip olmadığını unutmayın - scoreTür: object | null
_by _categories otel konumunun kategori puanları
otelin konumunun yakındaki yapılacak aktivitelere, restoranlara, ulaşıma ve havalimanlarına yakınlığını gösteren kategorilere bağlı puanları;- propertyTür: number | null Biçim: double
Name
- locationTür: integer | null
_code POST dizisindeki konum kodu
- overviewTür: array (string | null)[] | null
_images otel genel görünümünde gösterilen görseller
otel genel görünümünde gösterilen görsellere ait URL'leri içeren dizi - phoneTür: string | null
otel telefon numarası
otelin iletişim telefon numarası - pricesTür: object | null · Response36Afe1097B20_HotelPriceInfo
otel varlığının fiyat ayrıntıları
otelin fiyatları hakkında bilgiler içerir- 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
otele ait kritere göre yorumlar
otel varlığına ilişkin yorumlar hakkında bilgiler- 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ı; otel özetinde yorum puanlarından sonra gösterilir - starsTür: string | null
_description otel sınıf puanı
1-5 yıldız aralığındaki sınıf puanı; otel özetinde yorum puanlarından sonra gösterilir - titleTür: string | null
otel adı
sonuçların toplandığı otel varlığının adı
- 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_info/live/advanced \
--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",
"hotel_identifier": "CgoI-KWyzenM_MV3EAE"
}
]'
{
"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]"
]
}
}
]
}
]
}