v0.2.0-beta

OpenAPI 3.1.0

Google Hotel Searches sonuçlarını id ile alma

Felo API Support

MIT

Sunucu

https://openapi.felo.ai

İstemci Kitaplıkları

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO İşlemler

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

Google Hotel Searches sonuçlarını id ile alma

Kuyruktaki bir Google Hotels aramasını id ile alır. 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. 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. ⚠️ Yanıt boyutu gönderim sırasında ayarlanan depth veya limit ile sabitlenmiştir ve burada daraltılamaz; çok büyükse sayfalamak yerine daha küçük yeniden gönderin.

Fiyatlandırma referansı

Ölçümlendirme: bildirilen yanıt maliyeti.
Referans istek maliyeti tahmini: USD 0.012.
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.

Yol Parametreleri

id
Tür: string
gerekli

görev tanımlayıcısı
sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı
görevin sonuçlarını istediğiniz zaman talep etmek için 30 gün boyunca kullanabilirsiniz

Yanıtlar

200
Tür: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetResponseInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

status_code
Tür: integer | null

genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

tasks
Tür: array (object | null)[] | null

görev dizisi

Tür: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetTaskInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

data
Tür: object | null

POST isteğinde belirttiğiniz parametrelerin aynısını içerir

propertyName
Tür: object | null
id
Tür: string | null

görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı

path
Tür: array (string | null)[] | null

URL yolu

result
Tür: array (object | null)[] | null

sonuç dizisi

check_url
Tür: string | null

arama motoru sonuçlarına doğrudan URL
doğru sonuçlar sunduğumuzdan emin olmak için kullanabilirsiniz

datetime
Tü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

items
Tür: array (object | null)[] | null

öğe dizisi
not: bu alan her zaman null değerini alır; entegrasyonu kolaylaştırmak ve Hotel Info uç noktasıyla birlikte çalışabilirliği sağlamak için kullanın

hotel_identifier
Tür: string | null

Google aramasında otel varlığının benzersiz tanımlayıcısı
örnek:
CgoI-KWyzenM_MV3EAE

is_paid
Tür: boolean | null

ücretli otel kaydını belirtir
true ise ilgili hotel_search_item ücretli bir reklamdır
false ise ilgili hotel_search_item organik bir otel kaydıdır

location
Tür: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo

otelin konumunun GPS koordinatları

latitude
Tür: number | null

otelin Google Haritalar'daki enlem koordinatı
örnek:
"latitude": 51.584091

longitude
Tür: number | null

otelin Google Haritalar'daki boylam koordinatı
örnek:
"longitude": -0.31365919999999997

overview_images
Tür: array (string | null)[] | null

otel için öne çıkan görseller

prices
Tür: object | null · Response36Afe1097B20_HotelPriceInfo

otel fiyatı

check_in
Tür: string | null

giriş tarihi ve saati
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:
2019-11-15 12:57:46 +00:00

check_out
Tür: string | null

çıkış tarihi ve saati
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:
2019-11-15 12:57:46 +00:00

currency
Tür: string | null

fiyat para birimi
POST dizisinde belirtilmediği sürece varsayılan olarak USD uygulanır

discount_text
Tür: string | null

uygulanan indirime ilişkin metin

items
Tür: array (object | null)[] | null

karşılaşılan öğe türleri
items dizisinde karşılaşılan arama motoru sonuç türleri;
olası öğe türleri: hotel_search_item

currency
Tür: string | null

fiyat para birimi
POST dizisinde belirtilmediği sürece varsayılan olarak USD uygulanır

domain
Tür: string | null

üçüncü taraf alan adı fiyat bilgilerini içeren üçüncü taraf web sitesi sayfasının alan adı

free_cancellation_until
Tür: string | null

ü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

is_paid
Tür: boolean | null

ücretli otel kaydını belirtir
true ise ilgili hotel_search_item ücretli bir reklamdır
false ise ilgili hotel_search_item organik bir otel kaydıdır

offers
Tür: array (object | null)[] | null

öne çıkan fiyat teklifleri

currency
Tür: string | null

fiyat para birimi
POST dizisinde belirtilmediği sürece varsayılan olarak USD uygulanır

free_cancellation_until
Tür: string | null

ü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

max_visitors
Tür: integer | null

maksimum ziyaretçi sayısı fiyat teklifinin geçerli olduğu maksimum ziyaretçi sayısı

offer_images
Tür: array (string | null)[] | null

fiyat teklifi görselleri fiyat teklifinde yer alan görsellerin URL'leri

price
Tür: number | null

gecelik fiyat

title
Tür: string | null

otelin adı

type
Tür: string | null

öğe türü

url
Tür: string | null

fiyat teklifinin url'si fiyat teklifinin göründüğü web sitesi sayfasının URL'si

official_site
Tür: boolean | null
price
Tür: number | null

gecelik fiyat

title
Tür: string | null

otelin adı

type
Tür: string | null

öğe türü

url
Tür: string | null

üçüncü taraf sayfa url'si fiyat bilgilerini içeren üçüncü taraf web sitesi sayfasının URL'si

price
Tür: number | null

gecelik fiyat

price_without_discount
Tür: number | null Biçim: int64

indirim uygulanmamış tam gecelik fiyat

prices_by_dates
Tür: array (object | null)[] | null
check_in_date
Tür: string | null
check_out_date
Tür: string | null
currency
Tür: string | null

fiyat para birimi
POST dizisinde belirtilmediği sürece varsayılan olarak USD uygulanır

price
Tür: number | null

gecelik fiyat

visitors
Tür: integer | null

bu fiyat için otel ziyaretçisi sayısı

reviews
Tür: object | null · Response36Afe1097B20_HotelReviewInfo

otel yorumları ve puan bilgileri

mentions
Tür: array (object | null)[] | null

otelden bahsedilme
kriterlere göre otel yorumlarına ilişkin bilgiler

negative_count
Tür: integer | null Biçim: int64

ölçüte göre olumsuz yorum sayısı

positive_count
Tür: integer | null Biçim: int64

ölçüte göre olumlu yorum sayısı

positive_score
Tür: number | null

ölçüte göre olumlu puan

title
Tür: string | null

değerlendirilen ölçütün başlığı

total_count
Tür: integer | null Biçim: int64

ölçüte göre tüm yorumların sayısı

visible_by_default
Tür: boolean | null

öğe varsayılan olarak görünür
yorum öğesinin varsayılan olarak görünür olup olmadığını belirtir

other_sites_reviews
Tür: array (object | null)[] | null

üçüncü taraf sitelerdeki yorumlar
üçüncü taraf sitelerden gelen yorumlar

rating
Tür: object | null · Response36Afe1097B20_RatingInfo

yorumdaki puanlama
üçüncü taraf bir sitedeki yorumda yer alan puanlama hakkında bilgiler

rating_max
Tür: integer | null

rating_type için maksimum değer

rating_type
Tür: string | null

puanlama türü burada şu öğeleri bulabilirsiniz: Max5, Percents, CustomMax

value
Tür: number | null Biçim: double

puanlamanın değeri

votes_count
Tür: integer | null Biçim: int64

geri bildirim miktarı

review_text
Tür: string | null

yorum metni
yorumun metni

title
Tür: string | null

yorum başlığı
yorumun ilk olarak göründüğü üçüncü taraf sitesinin adını içerir

url
Tür: string | null

yorum URL'si
yorumun ilk olarak göründüğü üçüncü taraf sitesinin URL'si

rating_distribution
Tür: object | null

oylara göre puan dağılımı
1 ile 5 aralığındaki puanlara göre oy dağılımı

propertyName
Tür: integer | null Biçim: Int64
value
Tür: number | null

müşteri oylarına dayalı genel otel puanı

votes_count
Tür: integer | null Biçim: int64

müşteri oyu sayısı
otel puanının hesaplanmasına dahil edilen müşteri oyu sayısı

stars
Tür: integer | null

otel sınıf puanı
1-5 yıldız aralığındaki sınıf puanı

title
Tür: string | null

otelin adı

type
Tür: string | null

öğe türü

items_count
Tür: integer | null Biçim: int64

öğe türleri
items dizisindeki öğe sayısı

keyword
Tür: string | null

POST dizisinde alınan anahtar sözcük
anahtar sözcük, kod çözülmüş %## ile döndürülür ('+' karakterinin kodu boşluk olarak çözülür);
doğru arama sonuçları elde etmek için konum adı anahtar sözcüğe otomatik olarak eklenir

language_code
Tür: string | null

POST dizisindeki dil kodu

location_code
Tür: integer | null

POST dizisindeki konum kodu

result_count
Tür: integer | null Biçim: int64

result dizisindeki öğe sayısı

status_code
Tür: integer | null

görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

time
Tür: string | null

yürütme süresi, saniye

tasks_count
Tür: integer | null Biçim: int64

tasks dizisindeki görev sayısı

tasks_error
Tür: integer | null Biçim: int64

tasks dizisinde hata ile dönen görev sayısı

time
Tür: string | null

toplam yürütme süresi, saniye

version
Tür: string | null

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

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'

Şemayı göster

{
  "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]"
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

Google Hotel Searches sonuçlarını id ile alma

Kimlik doğrulamaRequired

DataForSEO

Google Hotel Searches sonuçlarını id ile alma

Fiyatlandırma referansı