v0.2.0-beta

OpenAPI 3.1.0

Tworzenie zadań wyszukiwania Google Hotels

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

Shell Curl

DataForSEO

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

DataForSEO Operacje

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

Tworzenie zadań wyszukiwania Google Hotels

Dodaje do kolejki wyszukiwanie Google Hotels i zwraca id zadania. Odpowiedź jest opakowana w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Wynik pobierzesz przez get_dataforseo_business_google_hotel_searches_fetch.

Informacje o cenach

Rozliczanie: zgłoszony koszt odpowiedzi.
Referencyjny szacunek kosztu żądania: USD 0.2428.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne — nie oferta dla konta, nie gwarantowana cena ani limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść

application/json

Typ: array (object | null)[]
- adults
  Typ: integer | null
  
  liczba dorosłych
  pole opcjonalne
  jeśli nie podasz tego pola, zostanie zastosowana wartość domyślna 2;
  uwaga: możesz podać maksymalnie 6 osób, łącznie z dorosłymi i dziećmi
  przykład:
  1
- amenities
  Typ: array string[] | null
  
  udogodnienia hotelu
  pole opcjonalne
  za pomocą tego pola możesz określić różne udogodnienia hotelu
  przykład:
  [ "free_parking", "pets_allowed" ]
  możliwe wartości:
  "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
  Typ: string | null
  
  data zameldowania
  pole opcjonalne
  jeśli nie podasz tego pola, domyślnie użyta zostanie data jutrzejsza;
  format daty: "yyyy-mm-dd"
  przykład:
  "2019-01-15"
  Uwaga: wartość nie może poprzedzać dzisiejszej daty
- check_out
  Typ: string | null
  
  data wymeldowania
  pole opcjonalne
  jeśli nie podasz tego pola, nasz system domyślnie zastosuje datę dwa dni od dziś;
  format daty: "yyyy-mm-dd"
  przykład:
  "2019-01-15"
  Uwaga: wartość nie może być mniejsza lub równa check_in;
  zakres między wartościami check_in i check_out nie może przekraczać 30 dni
- children
  Typ: array string[] | null
  
  liczba i wiek dzieci
  pole opcjonalne
  jeśli nie podasz tego pola, w wyszukiwaniu nie zostaną uwzględnione żadne dzieci;
  wiek dziecka może wynosić od 0 do 17;
  uwaga: możesz podać maksymalnie 6 osób, łącznie z dorosłymi i dziećmi
  ustaw poniższą wartość, aby uwzględnić jedno 14-letnie dziecko:
  [14]
  ustaw poniższą wartość, aby uwzględnić jedno 13-letnie dziecko i jedno 8-letnie dziecko:
  [13,8]
- currency
  Typ: string | null
  
  waluta
  pole opcjonalne
  przykład:
  "USD"
- depth
  Typ: integer | null
  
  głębokość parsowania
  pole opcjonalne
  liczba wyników w Google Hotels
  wartość domyślna: 18 wyników organicznych
  wartość maksymalna: 140
  Uwaga: Twoje konto zostanie rozliczone za każde 18 wyników organicznych niezależnie od płatnych pozycji w odpowiedzi;
  zatem ustawienie głębokości powyżej 18 może skutkować dodatkowymi opłatami, jeśli Google Hotels zwróci więcej niż 18 wyników;
  jeśli podana głębokość jest większa niż liczba wyników w odpowiedzi, różnica zostanie automatycznie zwrócona na saldo Twojego konta
- free_cancellation
  Typ: boolean | null
  
  hotele z bezpłatnym anulowaniem
  pole opcjonalne
  ustaw to pole na true, jeśli chcesz otrzymać listę hoteli z bezpłatnym anulowaniem rezerwacji
  wartość domyślna: false
- is_vacation_rentals
  Typ: boolean | null
  
  wyszukiwanie noclegów wakacyjnych
  pole opcjonalne
  ustaw to pole na true, jeśli chcesz otrzymać listę noclegów wakacyjnych zamiast hoteli
  wartość domyślna: false
- keyword
  Typ: string | null
  
  słowo kluczowe
  pole opcjonalne
  podane słowo kluczowe służy do wyszukania listy hoteli;
  jeśli nie użyjesz tego pola, zwrócimy listę hoteli znalezionych w podanej lokalizacji;
  w polu keyword możesz podać do 700 znaków
  wszystkie ciągi %## zostaną zdekodowane (znak „+” zostanie zdekodowany jako spacja)
  jeśli potrzebujesz użyć znaku „%” w keyword, podaj go jako „%25”;
  Uwaga: aby uzyskać dokładne wyniki wyszukiwania, nazwa lokalizacji jest automatycznie dołączana do słowa kluczowego
  
  więcej o zasadach i ograniczeniach pól keyword i keywords w interfejsach DataForSEO znajdziesz w tym artykule Centrum pomocy
- language_code
  Typ: string
  
  kod języka wyszukiwarki
  pole wymagane, jeśli nie podasz language_name
  jeśli użyjesz tego pola, nie musisz podawać language_name
  listę dostępnych języków wraz z ich language_code możesz uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/business_data/google/languages
  przykład:
  en
- language_name
  Typ: string
  
  pełna nazwa języka wyszukiwarki
  pole wymagane, jeśli nie podasz language_code
  jeśli użyjesz tego pola, nie musisz podawać language_code
  listę dostępnych języków z language_name możesz uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/business_data/google/languages
  przykład:
  English
- location_code
  Typ: integer
  
  kod lokalizacji wyszukiwarki
  pole wymagane, jeśli nie podasz location_name lub location_coordinate
  jeśli użyjesz tego pola, nie musisz podawać location_name lub location_coordinate
  listę dostępnych lokalizacji z location_code możesz uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/business_data/google/locations
  przykład:
  2840
- location_coordinate
  Typ: string
  
  współrzędne GPS lokalizacji
  pole wymagane, jeśli nie podasz location_name lub location_code
  jeśli użyjesz tego pola, nie musisz podawać location_name lub location_code
  parametr location_coordinate należy podać w formacie "latitude,longitude"
  maksymalna liczba cyfr po przecinku dla "latitude" i "longitude": 7
  Uwaga: jeśli współrzędne służą do ustawienia lokalizacji, wyszukiwanie odbędzie się w najbliższej miejscowości;
  przykład:
  53.476225,-2.243572
- location_name
  Typ: string
  
  pełna nazwa lokalizacji wyszukiwarki
  pole wymagane, jeśli nie podasz location_code lub location_coordinate
  jeśli użyjesz tego pola, nie musisz podawać location_code lub location_coordinate
  listę dostępnych lokalizacji z location_name możesz uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/business_data/google/locations
  przykład:
  London,England,United Kingdom
  Uwaga: aby uzyskać dokładne wyniki wyszukiwania, podana location_name zostanie automatycznie dołączona do słowa kluczowego
- max_price
  Typ: integer | null
  
  maksymalna cena za noc
  pole opcjonalne
  waluta tej wartości zależy od pola currency
  przykład:
  600
- min_price
  Typ: integer | null
  
  minimalna cena za noc
  pole opcjonalne
  waluta tej wartości zależy od pola currency
  przykład:
  100
- min_rating
  Typ: number | null
  
  minimalna ocena
  pole opcjonalne
  za pomocą tego pola możesz określić ocenę gości wyższą niż pewna wartość
  przykład:
  2.5
- pingback_url
  Typ: string | null
  
  adres URL powiadomienia o zakończonym zadaniu
  pole opcjonalne
  po zakończeniu zadania powiadomimy Cię żądaniem GET wysłanym na podany adres URL
  możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości
  przykład:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Uwaga: znaki specjalne w pingback_url zostaną zakodowane w adresie URL;
  m.in. znak # zostanie zakodowany jako %23
  
  więcej informacji znajdziesz w Centrum pomocy
- postback_url
  Typ: string | null
  
  adres URL do wysyłania wyników zadania
  pole opcjonalne
  po zakończeniu zadania wyślemy żądanie POST z wynikami skompresowanymi w formacie gzip na podany postback_url
  możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości.
  przykład:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Uwaga: znaki specjalne w postback_url zostaną zakodowane w adresie URL;
  m.in. znak # zostanie zakodowany jako %23
  
  więcej informacji znajdziesz w Centrum pomocy
- priority
  Typ: integer | null
  
  priorytet zadania
  pole opcjonalne
  może przyjmować następujące wartości:
  1 – normalny priorytet wykonania (ustawiany domyślnie)
  2 – wysoki priorytet wykonania. Za zadania o wysokim priorytecie wykonania zostanie naliczona dodatkowa opłata.
  Koszt można obliczyć na stronie Cennik.
- search_this_area
  Typ: boolean | null
  
  pokaż hotele z wyświetlanego obszaru
  pole opcjonalne
  może przyjmować wartości: true, false
  wartość domyślna: true
  po ustawieniu na false tryb search_this_area zostanie wyłączony
  Uwaga: jeśli tryb search_this_area jest wyłączony, location_name nie będzie dołączana do keyword podczas wyszukiwania
  więcej o tym parametrze w naszym Centrum pomocy
- sort_by
  Typ: string | null
  
  parametry sortowania wyników
  pole opcjonalne
  za pomocą tego pola możesz sortować wyniki
  możliwe typy sortowania:
  relevance – sortowanie według największej trafności
  lowest_price – sortowanie według najniższej ceny
  highest_rating – sortowanie według najwyższej oceny
  most_reviewed – sortowanie według największej liczby opinii
  wartość domyślna: relevance
- stars
  Typ: array string[] | null
  
  liczba gwiazdek hotelu
  pole opcjonalne
  ustaw to pole na [5], jeśli chcesz otrzymać wyłącznie listę hoteli 5-gwiazdkowych
  przykład:
  [3,4,5]
- tag
  Typ: string | null
  
  identyfikator zadania zdefiniowany przez użytkownika
  pole opcjonalne
  limit znaków: 255
  ten parametr służy do identyfikacji zadania i dopasowania go do wyniku
  podaną wartość tag znajdziesz w obiekcie data odpowiedzi

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostResponseInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

status_code
Typ: integer | null

ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

tasks
Typ: array (object | null)[] | null

tablica zadań

Typ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostTaskInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

data
Typ: object | null

zawiera te same parametry, które podano w żądaniu POST

propertyName
Typ: object | null
id
Typ: string | null

identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID

path
Typ: array (string | null)[] | null

ścieżka URL

result
Typ: object | null

tablica wyników
w tym przypadku wartością będzie null

result_count
Typ: integer | null Format: int64

liczba elementów w tablicy result

status_code
Typ: integer | null

kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

time
Typ: string | null

czas wykonania, sekundy

tasks_count
Typ: integer | null Format: int64

liczba zadań w tablicy tasks

tasks_error
Typ: integer | null Format: int64

liczba zadań w tablicy tasks zwróconych z błędem

time
Typ: string | null

łączny czas wykonania, sekundy

version
Typ: string | null

bieżąca wersja interfejsu API
application/json
400

Nie można przetworzyć żądania. Sprawdź parametry żądania.
401

Wymagany jest prawidłowy klucz API Felo.
402

Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
403

Konto nie ma uprawnień do wykonania tej operacji.
429

Osiągnięto limit żądań lub wydatków.
502

Usługa nie mogła ukończyć żądania.
503

API lub usługa rozliczeniowa jest tymczasowo niedostępna.
504

Upłynął limit czasu usługi podczas przetwarzania żądania.
default

Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

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

Pokaż schemat

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

Operacja zakończona powodzeniem

Tworzenie zadań wyszukiwania Google Hotels

UwierzytelnianieRequired

DataForSEO

Tworzenie zadań wyszukiwania Google Hotels

Informacje o cenach