v0.2.0-beta

OpenAPI 3.1.0

Google Hotels: taak indienen

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

Shell Curl

DataForSEO

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

DataForSEO Operaties

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

Google Hotels: taak indienen

Zet een Google Hotels-zoekopdracht in de wachtrij en retourneert een taak-id. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. Ophalen met get_dataforseo_business_google_hotel_searches_fetch.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.2428.
Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body

application/json

Type: array (object | null)[]
- adults
  Type: integer | null
  
  aantal volwassenen
  optioneel veld
  als u dit veld niet opgeeft, wordt de standaardwaarde 2 toegepast;
  let op dat u maximaal 6 personen kunt opgeven, inclusief volwassenen en kinderen
  voorbeeld:
  1
- amenities
  Type: array string[] | null
  
  hotelvoorzieningen
  optioneel veld
  u kunt dit veld gebruiken om verschillende hotelvoorzieningen op te geven
  voorbeeld:
  [ "free_parking", "pets_allowed" ]
  mogelijke waarden:
  "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
  Type: string | null
  
  incheckdatum
  optioneel veld
  als u dit veld niet opgeeft, wordt standaard de datum van morgen gebruikt;
  datumnotatie: "yyyy-mm-dd"
  voorbeeld:
  "2019-01-15"
  Let op: de waarde mag niet vóór de datum van vandaag liggen
- check_out
  Type: string | null
  
  uitcheckdatum
  optioneel veld
  als u dit veld niet opgeeft, past ons systeem standaard de datum van over twee dagen toe;
  datumnotatie: "yyyy-mm-dd"
  voorbeeld:
  "2019-01-15"
  Let op: de waarde mag niet kleiner dan of gelijk aan check_in zijn;
  het bereik tussen de waarden check_in en check_out mag niet meer dan 30 dagen bedragen
- children
  Type: array string[] | null
  
  aantal en leeftijd van kinderen
  optioneel veld
  als u dit veld niet opgeeft, worden er geen kinderen in de zoekopdracht opgenomen;
  de leeftijd van het kind kan van 0 tot 17 zijn;
  let op dat u maximaal 6 personen kunt opgeven, inclusief volwassenen en kinderen
  stel de volgende waarde in om één kind van 14 jaar op te nemen:
  [14]
  stel de volgende waarde in om één kind van 13 jaar en één kind van 8 jaar op te nemen:
  [13,8]
- currency
  Type: string | null
  
  valuta
  optioneel veld
  voorbeeld:
  "USD"
- depth
  Type: integer | null
  
  parsediepte
  optioneel veld
  aantal resultaten in Google Hotels
  standaardwaarde: 18 organische resultaten
  maximale waarde: 140
  Let op: uw account wordt gefactureerd per 18 organische resultaten, ongeacht betaalde vermeldingen in de respons;
  een diepte boven 18 kan daarom extra kosten opleveren als Google Hotels meer dan 18 resultaten retourneert;
  als de opgegeven diepte hoger is dan het aantal resultaten in de respons, wordt het verschil automatisch aan uw accountsaldo terugbetaald
- free_cancellation
  Type: boolean | null
  
  hotels met gratis annulering
  optioneel veld
  stel dit veld in op true als u de lijst met hotels met gratis annulering van reserveringen wilt ontvangen
  standaardwaarde: false
- is_vacation_rentals
  Type: boolean | null
  
  zoeken naar vakantiewoningen
  optioneel veld
  stel dit veld in op true als u de lijst met vakantiewoningen in plaats van hotels wilt ontvangen
  standaardwaarde: false
- keyword
  Type: string | null
  
  keyword
  optioneel veld
  het opgegeven keyword wordt gebruikt om naar de hotellijst te zoeken;
  als u dit veld niet gebruikt, retourneren we de hotellijst die op een opgegeven locatie is gevonden;
  u kunt maximaal 700 tekens in het veld keyword opgeven
  alle %## worden gedecodeerd (het teken ‘+’ wordt daarbij gedecodeerd naar een spatie)
  als u het teken “%” in uw keyword wilt gebruiken, geeft u het op als “%25”;
  Let op: om nauwkeurige zoekresultaten te verkrijgen, wordt de locatienaam automatisch aan het keyword toegevoegd
  
  meer over de regels en beperkingen van de velden keyword en keywords in DataForSEO-API's vindt u in dit Help Center-artikel
- language_code
  Type: string
  
  taalcode van de zoekmachine
  verplicht veld als u language_name niet opgeeft
  als u dit veld gebruikt, hoeft u language_name niet op te geven
  de lijst met beschikbare talen van de zoekmachine en hun language_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/business_data/google/languages
  voorbeeld:
  en
- language_name
  Type: string
  
  volledige naam van de taal van de zoekmachine
  verplicht veld als u language_code niet opgeeft
  als u dit veld gebruikt, hoeft u language_code niet op te geven
  de lijst met beschikbare talen van de zoekmachine en hun language_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/business_data/google/languages
  voorbeeld:
  English
- location_code
  Type: integer
  
  locatiecode van de zoekmachine
  verplicht veld als u location_name of location_coordinate niet opgeeft
  als u dit veld gebruikt, hoeft u location_name of location_coordinate niet op te geven
  de lijst met beschikbare locaties met location_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/business_data/google/locations
  voorbeeld:
  2840
- location_coordinate
  Type: string
  
  GPS-coördinaten van een locatie
  verplicht veld als u location_name of location_code niet opgeeft
  als u dit veld gebruikt, hoeft u location_name of location_code niet op te geven
  de parameter location_coordinate moet in het formaat "latitude,longitude" worden opgegeven
  het maximale aantal decimalen voor "latitude" en "longitude": 7
  Let op: als de coördinaten worden gebruikt om een locatie in te stellen, vindt de zoekopdracht plaats in de dichtstbijzijnde nederzetting;
  voorbeeld:
  53.476225,-2.243572
- location_name
  Type: string
  
  volledige naam van de locatie van de zoekmachine
  verplicht veld als u location_code of location_coordinate niet opgeeft
  als u dit veld gebruikt, hoeft u location_code of location_coordinate niet op te geven
  de lijst met beschikbare locaties van de zoekmachine en hun location_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/business_data/google/locations
  voorbeeld:
  London,England,United Kingdom
  Let op: om nauwkeurige zoekresultaten te verkrijgen, wordt de location_name die u opgeeft automatisch aan het keyword toegevoegd
- max_price
  Type: integer | null
  
  maximumprijs per nacht
  optioneel veld
  de valuta van deze waarde is afhankelijk van het veld currency
  voorbeeld:
  600
- min_price
  Type: integer | null
  
  minimumprijs per nacht
  optioneel veld
  de valuta van deze waarde is afhankelijk van het veld currency
  voorbeeld:
  100
- min_rating
  Type: number | null
  
  minimale beoordeling
  optioneel veld
  u kunt dit veld gebruiken om een gastbeoordeling hoger dan een bepaalde waarde op te geven
  voorbeeld:
  2.5
- pingback_url
  Type: string | null
  
  meldings-URL van een voltooide taak
  optioneel veld
  wanneer een taak is voltooid, melden wij u dit via een GET-verzoek naar de URL die u hebt opgegeven
  u kunt de tekenreeks ‘$id’ als $id-variabele en ‘$tag’ als URL-gecodeerde $tag-variabele gebruiken. Wij stellen de benodigde waarden in voordat we het verzoek versturen.
  voorbeeld:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Let op: speciale tekens in pingback_url worden URL-gecodeerd;
  d.w.z. het teken # wordt gecodeerd als %23
  
  meer informatie vindt u in ons Help Center
- postback_url
  Type: string | null
  
  URL voor het verzenden van taakresultaten
  optioneel veld
  zodra de taak is voltooid, sturen wij een POST-verzoek met de resultaten, gecomprimeerd in de indeling gzip, naar de door u opgegeven postback_url
  u kunt de tekenreeks ‘$id’ gebruiken als $id-variabele en ‘$tag’ als url-gecodeerde $tag-variabele. Wij stellen de benodigde waarden in voordat het verzoek wordt verzonden.
  voorbeeld:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Let op: speciale tekens in postback_url worden url-gecodeerd;
  zo wordt het teken # gecodeerd als %23
  
  meer informatie vindt u in ons Help Center
- priority
  Type: integer | null
  
  taakprioriteit
  optioneel veld
  kan de volgende waarden hebben:
  1 – normale uitvoeringsprioriteit (standaard ingesteld)
  2 – hoge uitvoeringsprioriteit. Voor taken met hoge uitvoeringsprioriteit worden extra kosten in rekening gebracht.
  de kosten kunnen worden berekend op de pagina Pricing.
- search_this_area
  Type: boolean | null
  
  hotels uit het weergegeven gebied tonen
  optioneel veld
  kan de waarden true, false hebben
  standaardwaarde: true
  als dit op false is ingesteld, wordt de modus search_this_area uitgeschakeld
  Let op: als de modus search_this_area is uitgeschakeld, wordt location_name tijdens het zoeken niet aan het keyword toegevoegd
  meer informatie over deze parameter vindt u op ons Help Center
- sort_by
  Type: string | null
  
  sorteerparameters voor resultaten
  optioneel veld
  u kunt dit veld gebruiken om de resultaten te sorteren
  mogelijke sorteertypen:
  relevance – sorteren op meest relevant
  lowest_price – sorteren op de laagste prijs
  highest_rating – sorteren op de hoogste beoordeling
  most_reviewed – sorteren op de meeste beoordelingen
  standaardwaarde: relevance
- stars
  Type: array string[] | null
  
  hotelsterren
  optioneel veld
  stel dit veld in op [5] als u alleen de lijst met 5-sterrenhotels wilt ontvangen
  voorbeeld:
  [3,4,5]
- tag
  Type: string | null
  
  door gebruiker gedefinieerde taak-ID
  optioneel veld
  de tekenslimiet is 255
  je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
  de opgegeven waarde tag vind je in het data-object van de respons

Responsen

200
Type: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostResponseInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

status_code
Type: integer | null

algemene statuscode de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier

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

array van taken

Type: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostTaskInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

data
Type: object | null

Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven

propertyName
Type: object | null
id
Type: string | null

taak-id eenduidige taak-id in ons systeem in UUID-indeling

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

URL-pad

result
Type: object | null

array van resultaten
in dit geval is de waarde null

result_count
Type: integer | null Formaat: int64

Aantal elementen in de result-array

status_code
Type: integer | null

statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier

time
Type: string | null

Uitvoeringstijd in seconden

tasks_count
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array

tasks_error
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array dat met een fout is geretourneerd

time
Type: string | null

totale uitvoeringstijd, seconden

version
Type: string | null

De huidige versie van de API
application/json
400

Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
401

Een geldige Felo-API-sleutel is vereist.
402

Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
403

Het account mag deze bewerking niet uitvoeren.
429

Een verzoek- of bestedingslimiet is bereikt.
502

De dienst kon het verzoek niet voltooien.
503

De API of factureringsdienst is tijdelijk niet beschikbaar.
504

Er is een time-out opgetreden bij het verwerken van het verzoek.
default

Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

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

Schema tonen

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

Geslaagde bewerking

Google Hotels: taak indienen

AuthenticatieRequired

DataForSEO

Google Hotels: taak indienen

Prijsreferentie