v0.2.0-beta

OpenAPI 3.1.0

Live: Google-hotels zoeken

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/live

Live: Google-hotels zoeken

Doorzoekt Google Hotels naar accommodaties die bij een zoekopdracht passen, met datums en bezetting. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. Zo vind je het hotel waarvan de info-endpoints de id nodig hebben; post_dataforseo_business_google_hotel_info_live is de detailweergave.

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
- 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_BusinessDataGoogleHotelSearchesLiveResponseInfo
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_BusinessDataGoogleHotelSearchesLiveTaskInfo
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: array (object | null)[] | null

array van resultaten

check_url
Type: string | null

directe URL naar zoekmachineresultaten
u kunt deze gebruiken om te controleren of we nauwkeurige resultaten hebben geleverd

datetime
Type: string | null

datum en tijd waarop het resultaat is ontvangen
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

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

aangetroffen itemtypen
typen zoekmachineresultaten die in de items-array voorkomen;
mogelijke itemtypen: hotel_search_item

hotel_identifier
Type: string | null

unieke id van een hotelentiteit in Google Zoeken
voorbeeld:
CgoI-KWyzenM_MV3EAE

is_paid
Type: boolean | null

geeft aan of het gaat om een betaalde hotelvermelding
als true, is het bijbehorende hotel_search_item een betaalde advertentie
als false, is het bijbehorende hotel_search_item een organische hotelvermelding

location
Type: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo

GPS-coördinaten van de locatie van het hotel

latitude
Type: number | null

breedtegraad van het hotel in Google Maps
voorbeeld:
"latitude": 51.584091

longitude
Type: number | null

lengtegraad van het hotel in Google Maps
voorbeeld:
"longitude": -0.31365919999999997

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

uitgelichte afbeeldingen voor een hotel

prices
Type: object | null · Response36Afe1097B20_HotelPriceInfo

hotelprijs

check_in
Type: string | null

check-in datum en tijd
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

check_out
Type: string | null

check-outdatum en -tijd
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

currency
Type: string | null

prijsvaluta
USD wordt standaard toegepast, tenzij anders aangegeven in de POST-array

discount_text
Type: string | null

tekst over een toegepaste korting

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

aangetroffen itemtypen
typen zoekmachineresultaten die in de items-array voorkomen;
mogelijke itemtypen: hotel_search_item

currency
Type: string | null

prijsvaluta
USD wordt standaard toegepast, tenzij anders aangegeven in de POST-array

domain
Type: string | null

domein van een derde partij domein van de pagina van een website van een derde partij met prijsinformatie

free_cancellation_until
Type: string | null

datum tot wanneer gratis annulering mogelijk is in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00” is null als gratis annulering niet beschikbaar is voor de geselecteerde data

is_paid
Type: boolean | null

geeft aan of het gaat om een betaalde hotelvermelding
als true, is het bijbehorende hotel_search_item een betaalde advertentie
als false, is het bijbehorende hotel_search_item een organische hotelvermelding

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

uitgelichte prijsaanbiedingen

currency
Type: string | null

prijsvaluta
USD wordt standaard toegepast, tenzij anders aangegeven in de POST-array

free_cancellation_until
Type: string | null

datum tot wanneer gratis annulering mogelijk is in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00” is null als gratis annulering niet beschikbaar is voor de geselecteerde data

max_visitors
Type: integer | null

het maximale aantal bezoekers het maximale aantal bezoekers waarvoor de prijsaanbieding geldig is

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

afbeeldingen van de prijsaanbieding URL's van de afbeeldingen in de prijsaanbieding

price
Type: number | null

prijs per nacht

title
Type: string | null

titel van het hotel

type
Type: string | null

elementtype

url
Type: string | null

URL van de prijsaanbieding URL naar de pagina van de website waar de prijsaanbieding verschijnt

official_site
Type: boolean | null
price
Type: number | null

prijs per nacht

title
Type: string | null

titel van het hotel

type
Type: string | null

elementtype

url
Type: string | null

URL van de pagina van een derde partij URL naar de pagina van een website van een derde partij met prijsinformatie

price
Type: number | null

prijs per nacht

price_without_discount
Type: number | null Formaat: int64

volledige prijs per nacht zonder toegepaste korting

prices_by_dates
Type: array (object | null)[] | null
check_in_date
Type: string | null
check_out_date
Type: string | null
currency
Type: string | null

prijsvaluta
USD wordt standaard toegepast, tenzij anders aangegeven in de POST-array

price
Type: number | null

prijs per nacht

visitors
Type: integer | null

aantal hotelbezoekers voor deze prijs

reviews
Type: object | null · Response36Afe1097B20_HotelReviewInfo

hotelbeoordelingen en beoordelingsinformatie

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

vermeldingen van het hotel
informatie over hotelreviews per criterium

negative_count
Type: integer | null Formaat: int64

aantal negatieve reviews per criterium

positive_count
Type: integer | null Formaat: int64

aantal positieve reviews per criterium

positive_score
Type: number | null

positieve score per criterium

title
Type: string | null

titel van het beoordeelde criterium

total_count
Type: integer | null Formaat: int64

aantal van alle reviews per criterium

visible_by_default
Type: boolean | null

element is standaard zichtbaar
geeft aan of het reviewelement standaard zichtbaar is

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

reviews op websites van derden
reviews van websites van derden

rating
Type: object | null · Response36Afe1097B20_RatingInfo

beoordeling in de review
informatie over de beoordeling die in de review op een site van derden is opgenomen

rating_max
Type: integer | null

de maximale waarde voor een rating_type

rating_type
Type: string | null

het type beoordeling hier vindt u de volgende elementen: Max5, Percents, CustomMax

value
Type: number | null Formaat: double

de waarde van de beoordeling

votes_count
Type: integer | null Formaat: int64

het aantal feedbacks

review_text
Type: string | null

reviewtekst
tekst van de review

title
Type: string | null

titel van de review
bevat de naam van de site van derden waar de review oorspronkelijk verscheen

url
Type: string | null

URL van de review
URL van de site van derden waar de review oorspronkelijk verscheen

rating_distribution
Type: object | null

beoordelingsverdeling per stem
de verdeling van stemmen over de beoordeling in het bereik van 1 tot 5

propertyName
Type: integer | null Formaat: Int64
value
Type: number | null

totale hotelbeoordeling op basis van klantstemmen

votes_count
Type: integer | null Formaat: int64

aantal klantstemmen
het aantal klantstemmen dat meetelt in de berekening van de hotelbeoordeling

stars
Type: integer | null

sterrenclassificatie van het hotel
classificatie van 1 tot 5 sterren

title
Type: string | null

titel van het hotel

type
Type: string | null

elementtype

items_count
Type: integer | null Formaat: int64

itemtypen
het aantal items in de array items

keyword
Type: string | null

keyword ontvangen in een POST-array
het keyword wordt gedecodeerd geretourneerd (%##; het plusteken '+' wordt gedecodeerd naar een spatie)

language_code
Type: string | null

taalcode in een POST-array

location_code
Type: integer | null

locatiecode in een POST-array

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/live

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

Geslaagde bewerking

Live: Google-hotels zoeken

AuthenticatieRequired

DataForSEO

Live: Google-hotels zoeken

Prijsreferentie