v0.2.0-beta

OpenAPI 3.1.0

Google Hotel Searches görevlerini oluşturma

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

post/v1/beta/dataforseo/business_data/google/hotel_searches/task_post

Google Hotel Searches görevlerini oluşturma

Bir Google Hotels aramasını kuyruğa alır ve bir görev id değeri 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. get_dataforseo_business_google_hotel_searches_fetch ile alı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.

Gövde

application/json

Tür: array (object | null)[]
- adults
  Tür: integer | null
  
  yetişkin sayısı
  isteğe bağlı alan
  bu alanı belirtmezseniz varsayılan 2 değeri uygulanır;
  not: yetişkinler ve çocuklar dahil olmak üzere en fazla 6 kişi belirtebilirsiniz
  örnek:
  1
- amenities
  Tü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", "all_inclusive_available", "bar", "free_breakfast", "fitness_center", "kid_friendly", "free_parking", "pets_allowed", "pool", "restaurant", "room_service", "spa", "free_wifi", "parking", "indoor_pool", "outdoor_pool", "wheelchair_accessible", "beach_access"
- check_in
  Tür: string | null
  
  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
- check_out
  Tür: string | null
  
  çı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ğer check_in değerine eşit veya ondan küçük olamaz;
  check_in ve check_out değerleri arasındaki aralık 30 günü aşamaz
- children
  Tü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şı 0 ile 17 arası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]
- currency
  Tür: string | null
  
  para birimi
  isteğe bağlı alan
  örnek:
  "USD"
- depth
  Tür: integer | null
  
  ayrıştırma derinliği
  isteğe bağlı alan
  Google Hotels içindeki sonuç sayısı
  varsayılan değer: 18 organik 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 nedenle 18 ü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
- free_cancellation
  Tür: boolean | null
  
  ücretsiz iptal sunan oteller
  isteğe bağlı alan
  rezervasyonları ücretsiz iptal edilebilen otellerin listesini almak istiyorsanız bu alanı true olarak ayarlayın
  varsayılan değer: false
- is_vacation_rentals
  Tür: boolean | null
  
  tatil kiralamalarında arama
  isteğe bağlı alan
  oteller yerine tatil kiralamalarının listesini almak istiyorsanız bu alanı true olarak ayarlayın
  varsayılan değer: false
- keyword
  Tü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;
  keyword alanında en fazla 700 karakter belirtebilirsiniz
  tüm %## dizileri çözümlenir (“+” karakteri boşluk karakterine çözümlenir)
  keyword için “%” karakterini kullanmanız gerekiyorsa “%25” olarak belirtin;
  Not: doğru arama sonuçları elde etmek için konum adı anahtar kelimeye otomatik olarak eklenir
  
  DataForSEO API'lerindeki keyword ve keywords alanlarının kuralları ve sınırlamaları hakkında daha fazla bilgiyi bu yardım merkezi makalesinde bulabilirsiniz
- language_code
  Tür: string
  
  arama motoru dil kodu
  language_name belirtmezseniz zorunlu alan
  bu alanı kullanırsanız language_name belirtmeniz gerekmez
  mevcut dillerin listesini language_code değerleriyle birlikte https://api.dataforseo.com/v3/business_data/google/languages adresine ayrı bir istek yaparak alabilirsiniz
  örnek:
  en
- language_name
  Tür: string
  
  arama motoru dilinin tam adı
  language_code belirtmezseniz zorunlu alan
  bu alanı kullanırsanız language_code belirtmeniz gerekmez
  mevcut dillerin listesini language_name değerleriyle birlikte https://api.dataforseo.com/v3/business_data/google/languages adresine ayrı bir istek yaparak alabilirsiniz
  örnek:
  English
- location_code
  Tür: integer
  
  arama motoru konum kodu
  location_name veya location_coordinate belirtmezseniz zorunlu alan
  bu alanı kullanırsanız location_name veya location_coordinate belirtmeniz gerekmez
  mevcut konumların listesini location_code değerleriyle birlikte https://api.dataforseo.com/v3/business_data/google/locations adresine ayrı bir istek yaparak alabilirsiniz
  örnek:
  2840
- location_coordinate
  Tür: string
  
  bir konumun GPS koordinatları
  location_name veya location_code belirtmezseniz zorunlu alan
  bu alanı kullanırsanız location_name veya location_code belirtmeniz gerekmez
  location_coordinate parametresi "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
- location_name
  Tür: string
  
  arama motoru konumunun tam adı
  location_code veya location_coordinate belirtmezseniz zorunlu alan
  bu alanı kullanırsanız location_code veya location_coordinate belirtmeniz gerekmez
  mevcut konumların listesini location_name değerleriyle birlikte https://api.dataforseo.com/v3/business_data/google/locations adresine ayrı bir istek yaparak alabilirsiniz
  örnek:
  London,England,United Kingdom
  Not: doğru arama sonuçları elde etmek için belirttiğiniz location_name anahtar kelimeye otomatik olarak eklenir
- max_price
  Tür: integer | null
  
  gecelik maksimum fiyat
  isteğe bağlı alan
  bu değerin para birimi currency alanına bağlıdır
  örnek:
  600
- min_price
  Tür: integer | null
  
  gecelik minimum fiyat
  isteğe bağlı alan
  bu değerin para birimi currency alanına bağlıdır
  örnek:
  100
- min_rating
  Tür: number | null
  
  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
- pingback_url
  Tür: string | null
  
  tamamlanan görevin bildirim URL'si
  isteğe bağlı alan
  görev tamamlandığında belirttiğiniz URL'ye gönderilen GET isteğiyle sizi bilgilendireceğiz
  ‘$id’ dizesini $id değişkeni, ‘$tag’ dizesini ise URL kodlu $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız
  örnek:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Not: pingback_url içindeki özel karakterler URL kodlanır;
  yani, # karakteri %23 olarak kodlanır
  
  daha fazla bilgi için Yardım Merkezimize bakın
- postback_url
  Tür: string | null
  
  görev sonuçlarını göndermek için URL
  isteğe bağlı alan
  görev tamamlandığında sonuçlarını gzip biçiminde sıkıştırarak belirttiğiniz postback_url adresine POST isteğiyle göndereceğiz
  ‘$id’ dizesini $id değişkeni, ‘$tag’ dizesini ise URL kodlu $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.
  örnek:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Not: postback_url içindeki özel karakterler URL kodlanır;
  yani, # karakteri %23 olarak kodlanır
  
  daha fazla bilgi için Yardım Merkezimize bakın
- priority
  Tür: integer | null
  
  görev önceliği
  isteğe bağlı alan
  şu değerleri alabilir:
  1 – normal yürütme önceliği (varsayılan olarak ayarlanır)
  2 – yüksek yürütme önceliği. Yüksek yürütme önceliğine sahip görevler için ek ücret alınır.
  Maliyet Fiyatlandırma sayfasında hesaplanabilir.
- search_this_area
  Tür: boolean | null
  
  görüntülenen alandaki otelleri göster
  isteğe bağlı alan
  şu değerleri alabilir: true, false
  varsayılan değer: true
  false olarak ayarlanırsa search_this_area modu kapatılır
  Not: search_this_area modu kapalıysa arama sırasında location_name keyword değerine eklenmez
  bu parametre hakkında daha fazla bilgiyi yardım merkezimizde bulabilirsiniz
- sort_by
  Tür: string | null
  
  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ırala
  lowest_price – en düşük fiyata göre sırala
  highest_rating – en yüksek puana göre sırala
  most_reviewed – en çok yorumlanana göre sırala
  varsayılan değer: relevance
- stars
  Tü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]
- tag
  Tü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
  belirtilen tag değerini yanıtın data nesnesinde bulacaksınız

Yanıtlar

200
Tür: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostResponseInfo
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_BusinessDataGoogleHotelSearchesTaskPostTaskInfo
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: object | null

sonuç dizisi
bu durumda değer null olur

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

post/v1/beta/dataforseo/business_data/google/hotel_searches/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_searches/task_post \
  --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"
  }
]'

Ş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": null
    }
  ]
}

Başarılı işlem

Google Hotel Searches görevlerini oluşturma

Kimlik doğrulamaRequired

DataForSEO

Google Hotel Searches görevlerini oluşturma

Fiyatlandırma referansı