DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live: uitgebreide Google-hotelinfo
De Google-vermelding van één hotel: kamers, voorzieningen, prijzen en de boekingsopties die Google toont. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. De ruwe vorm is post_dataforseo_business_google_hotel_info_live_html, de in de wachtrij geplaatste vorm post_dataforseo_business_google_hotel_info_submit. Om het hotel eerst te vinden gebruik je post_dataforseo_business_google_hotel_searches_live.
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.
- Type: array (object | null)[]
- adultsType: integer | null
aantal volwassenen
optioneel veld
als u dit veld niet opgeeft, worden standaard twee volwassenen gebruikt
voorbeeld:1 - checkType: string | null
_in incheckdatum
optioneel veld
als u dit veld niet opgeeft, wordt standaard de datum van morgen gebruikt;
de waarde mag niet eerder zijn dan de datum van vandaag
datumnotatie:"yyyy-mm-dd"
voorbeeld:"2019-01-15" - checkType: string | null
_out uitcheckdatum
optioneel veld
als u dit veld niet opgeeft, past ons systeem standaard de datum van over twee dagen toe;
Let op: de waarde mag niet kleiner dan of gelijk aancheck_inzijn;
het bereik tussen de waardencheck_inencheck_outmag niet meer dan 30 dagen bedragen
datumnotatie:"yyyy-mm-dd"
voorbeeld:"2019-01-15" - childrenType: array string[] | null
aantal en leeftijd van kinderen
optioneel veld
als u dit veld niet opgeeft, worden er geen kinderen in de zoekopdracht opgenomen;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] - currencyType: string | null
valuta
optioneel veld
voorbeeld:"USD" - hotelType: string
_identifier unieke hotelidentificatie
verplicht veld
unieke identificatie van een hotelentiteit in Google Zoeken;
u kunt de waarde verkrijgen door een verzoek te doen aan de Advanced Google SERP API (opgenomen in het elementhotelsvan de respons), of aan het Hotel Searches-endpoint van de Business Data API
voorbeeld:ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE - languageType: string
_code taalcode van de zoekmachine
verplicht veld als ulanguage_nameniet opgeeft
als u dit veld gebruikt, hoeft ulanguage_nameniet op te geven
de lijst met beschikbare talen van de zoekmachine en hunlanguage_codeontvangt u via een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/business_data/google/languages
voorbeeld:en - languageType: string
_name volledige naam van de taal van de zoekmachine
verplicht veld als ulanguage_codeniet opgeeft
als u dit veld gebruikt, hoeft ulanguage_codeniet op te geven
de lijst met beschikbare talen van de zoekmachine en hunlanguage_nameontvangt u via een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/business_data/google/languages
voorbeeld:English - loadType: boolean | null
_prices _by _dates hotelprijzen per datum laden
optioneel veld
als u deze parameter optrueinstelt, bevat de respons de arrayprices_by_datesmet hotelovernachtingsprijzen uitgesplitst per datum
als u deze parameter gebruikt, wordt de dubbele basisprijs per verzoek in rekening gebracht - locationType: integer
_code locatiecode van de zoekmachine
verplicht veld als ulocation_nameoflocation_coordinateniet opgeeft
als u dit veld gebruikt, hoeft ulocation_nameoflocation_coordinateniet op te geven
de lijst met beschikbare locaties metlocation_codeontvangt u via een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/business_data/google/locations
voorbeeld:2840 - locationType: string
_coordinate GPS-coördinaten van een locatie
verplicht veld als ulocation_nameoflocation_codeniet opgeeft
als u dit veld gebruikt, hoeft ulocation_nameoflocation_codeniet op te geven
de parameterlocation_coordinatemoet 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 - locationType: string
_name volledige naam van de locatie van de zoekmachine
verplicht veld als ulocation_codeoflocation_coordinateniet opgeeft
als u dit veld gebruikt, hoeft ulocation_codeoflocation_coordinateniet op te geven
de lijst met beschikbare locaties van de zoekmachine en hunlocation_nameontvangt u via een afzonderlijk verzoek aanhttps://api.dataforseo.com/v3/business_data/google/locations
voorbeeld:London,England,United Kingdom - pricesType: string | null
_date _range vooraf gedefinieerde periode voor het ophalen van dagelijkse prijsgegevens
optioneel veld
om deze parameter te gebruiken, moet uload_prices_by_datesoptrueinstellen
alsprices_start_dateniet is opgegeven, wordt de startdatum ingesteld op de datumcheck_in
mogelijke waarden:month,three_months,six_months,year
standaardwaarde:month - pricesType: string | null
_end _date einddatum om prijzen per datum te laden
optioneel veld
om deze parameter te gebruiken, moet uload_prices_by_datesoptrueinstellen
als deze parameter niet is opgegeven, ontvangt u prijzen per datum voor de maand
datumnotatie:yyyy-mm-dd
voorbeeld:2025-05-21 - pricesType: string | null
_start _date startdatum om prijzen per datum te laden
optioneel veld
om deze parameter te gebruiken, moet uload_prices_by_datesoptrueinstellen
als deze parameter niet is opgegeven, wordt de startdatum ingesteld op de datumcheck_in
datumnotatie:yyyy-mm-dd
voorbeeld:2025-05-20 - tagType: 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 waardetagvind je in hetdata-object van de respons
- Type: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo200
- Type: number | null Formaat: doublecost
Totale kosten van taken, USD
- Type: integer | nullstatus
_code algemene statuscode de volledige lijst met responscodes vindt u hier
- Type: string | nullstatus
_message algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier
- Type: array (object | null)[] | nulltasks
array van taken
- Type: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo
- costType: number | null Formaat: double
Totale kosten van taken, USD
- dataType: object | null
Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven
- propertyType: object | null
Name
- idType: string | null
taak-id eenduidige taak-id in ons systeem in UUID-indeling
- pathType: array (string | null)[] | null
URL-pad
- resultType: array (object | null)[] | null
array van resultaten
- aboutType: object | null · Response36Afe1097B20_HotelAboutInfo
informatie over het hotel
- amenitiesType: array (object | null)[] | null
hotelvoorzieningen
informatie over hotelvoorzieningen- categoryType: string | null
gestandaardiseerde categorie van de voorziening
- categoryType: string | null
_label label van de categorie
- itemsType: array (object | null)[] | null
specifieke voorzieningen en details
- amenityType: string | null
gestandaardiseerde naam van de voorziening
- amenityType: string | null
_label weergegeven naam van de voorziening
- hintType: string | null
gestandaardiseerde details over de voorziening
- hintType: string | null
_label weergegeven details over de voorziening
- isType: boolean | null
_available geeft aan of de
amenitybeschikbaar is in het hotel
- checkType: object | null · Response36Afe1097B20_TimeInfo
_in _time check-intijd van het hotel
check-intijd zoals vermeld in de hotelvermelding- hourType: integer | null
uren in 24-uursformaat
- minuteType: integer | null
minuten
- checkType: object | null · Response36Afe1097B20_TimeInfo
_out _time check-outtijd van het hotel
check-outtijd zoals vermeld in de hotelvermelding- hourType: integer | null
uren in 24-uursformaat
- minuteType: integer | null
minuten
- descriptionType: string | null
beschrijving van het hotel
de beschrijving van het hotel waarvoor de resultaten worden verzameld - domainType: string | null
hoteldomein
domein van de website van het hotel - fullType: string | null
_address volledig adres van het hotel
adres van het hotel in gestandaardiseerd formaat - popularType: array (object | null)[] | null
_amenities hotelvoorzieningen
informatie over hotelvoorzieningen met het label 'populair'- amenityType: string | null
gestandaardiseerde naam van de voorziening
- amenityType: string | null
_label weergegeven naam van de voorziening
- hintType: string | null
gestandaardiseerde details over de voorziening
- hintType: string | null
_label weergegeven details over de voorziening
- isType: boolean | null
_available geeft aan of de
amenitybeschikbaar is in het hotel
- subType: array (string | null)[] | null
_descriptions aanvullende beschrijving van het hotel
details over het hotel die naast de beschrijving worden verstrekt - urlType: string | null
hotel-URL
URL naar de website van het hotel zoals vermeld in de vermelding
- addressType: string | null
adres van het hotel
fysiek adres van het hotel - checkType: string | null
_url directe URL naar zoekmachineresultaten
u kunt deze gebruiken om te controleren of we nauwkeurige resultaten hebben geleverd - datetimeType: 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 - hotelType: string | null
_identifier id ontvangen in een POST-array
dit veld bevat de parameterhotel_identifierdie bij het instellen van een taak is opgegeven;
voorbeeld:CgoI-KWyzenM_MV3EAE - languageType: string | null
_code taalcode in een POST-array
- locationType: object | null · Response36Afe1097B20_HotelLocationInfo
informatie over de locatie van het hotel
informatie over de locatie waar het hotel zich bevindt- latitudeType: number | null
breedtegraad van het hotel
breedtegraadcoördinaten van de hotellocatie
voorbeeld:39.4806397 - locationType: array (object | null)[] | null
_chain elementen van de locatieketen
aanvullende parameters van elk element van de locatieketen- cardType: string | null
_id kaartidentificatie
- cidType: string | null
- featureType: string | null
_id - titleType: string | null
titel van het element in de locatieketen
- longitudeType: number | null
lengtegraad van het hotel
breedtegraadcoördinaten van de hotellocatie
voorbeeld:-106.0512973 - mapsType: string | null
_url URL naar de locatie van het hotel in Google Maps
- neighborhoodType: string | null
naam van de buurt waar het hotel ligt
- neighborhoodType: string | null
_description beschrijving van de buurt waar het hotel ligt
- overallType: number | null
_score totaalscore van de hotellocatie
geeft de totaalscore van de hotellocatie in het bereik van 1 tot 5;
berekend op basis van gegevens over de nabijheid van het hotel tot nabijgelegen activiteiten en restaurants, vervoer en luchthavens;
let op: de criteria wegen niet allemaal even zwaar in de totaalscore - scoreType: object | null
_by _categories categoriëscores van de hotellocatie
de scores van de hotellocatie gekoppeld aan de categorieën die de nabijheid tot nabijgelegen activiteiten, restaurants, vervoer en luchthavens aangeven;- propertyType: number | null Formaat: double
Name
- locationType: integer | null
_code locatiecode in een POST-array
- overviewType: array (string | null)[] | null
_images afbeeldingen in het hoteloverzicht
array met URL's naar afbeeldingen die in het hoteloverzicht worden weergegeven - phoneType: string | null
telefoonnummer van het hotel
contacttelefoonnummer van het hotel - pricesType: object | null · Response36Afe1097B20_HotelPriceInfo
prijsdetails van de hotelentiteit
bevat informatie over de prijzen van het hotel- checkType: string | null
_in 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 - checkType: string | null
_out check-outdatum en -tijd
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:2019-11-15 12:57:46 +00:00 - currencyType: string | null
prijsvaluta
USDwordt standaard toegepast, tenzij anders aangegeven in de POST-array - discountType: string | null
_text tekst over een toegepaste korting
- itemsType: array (object | null)[] | null
aangetroffen itemtypen
typen zoekmachineresultaten die in deitems-array voorkomen;
mogelijke itemtypen:hotel_search_item- currencyType: string | null
prijsvaluta
USDwordt standaard toegepast, tenzij anders aangegeven in de POST-array - domainType: string | null
domein van een derde partij domein van de pagina van een website van een derde partij met prijsinformatie
- freeType: string | null
_cancellation _until 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
- isType: boolean | null
_paid geeft aan of het gaat om een betaalde hotelvermelding
alstrue, is het bijbehorendehotel_search_itemeen betaalde advertentie
alsfalse, is het bijbehorendehotel_search_itemeen organische hotelvermelding - offersType: array (object | null)[] | null
uitgelichte prijsaanbiedingen
- currencyType: string | null
prijsvaluta
USDwordt standaard toegepast, tenzij anders aangegeven in de POST-array - freeType: string | null
_cancellation _until 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
- maxType: integer | null
_visitors het maximale aantal bezoekers het maximale aantal bezoekers waarvoor de prijsaanbieding geldig is
- offerType: array (string | null)[] | null
_images afbeeldingen van de prijsaanbieding URL's van de afbeeldingen in de prijsaanbieding
- priceType: number | null
prijs per nacht
- titleType: string | null
titel van het hotel
- typeType: string | null
elementtype
- urlType: string | null
URL van de prijsaanbieding URL naar de pagina van de website waar de prijsaanbieding verschijnt
- officialType: boolean | null
_site - priceType: number | null
prijs per nacht
- titleType: string | null
titel van het hotel
- typeType: string | null
elementtype
- urlType: string | null
URL van de pagina van een derde partij URL naar de pagina van een website van een derde partij met prijsinformatie
- priceType: number | null
prijs per nacht
- priceType: number | null Formaat: int64
_without _discount volledige prijs per nacht zonder toegepaste korting
- pricesType: array (object | null)[] | null
_by _dates - checkType: string | null
_in _date - checkType: string | null
_out _date - currencyType: string | null
prijsvaluta
USDwordt standaard toegepast, tenzij anders aangegeven in de POST-array - priceType: number | null
prijs per nacht
- visitorsType: integer | null
aantal hotelbezoekers voor deze prijs
- reviewsType: object | null · Response36Afe1097B20_HotelReviewInfo
hotelbeoordelingen per criterium
informatie over beoordelingen van de hotelentiteit- mentionsType: array (object | null)[] | null
vermeldingen van het hotel
informatie over hotelreviews per criterium- negativeType: integer | null Formaat: int64
_count aantal negatieve reviews per criterium
- positiveType: integer | null Formaat: int64
_count aantal positieve reviews per criterium
- positiveType: number | null
_score positieve score per criterium
- titleType: string | null
titel van het beoordeelde criterium
- totalType: integer | null Formaat: int64
_count aantal van alle reviews per criterium
- visibleType: boolean | null
_by _default element is standaard zichtbaar
geeft aan of het reviewelement standaard zichtbaar is
- otherType: array (object | null)[] | null
_sites _reviews reviews op websites van derden
reviews van websites van derden- ratingType: object | null · Response36Afe1097B20_RatingInfo
beoordeling in de review
informatie over de beoordeling die in de review op een site van derden is opgenomen- ratingType: integer | null
_max de maximale waarde voor een rating_type
- ratingType: string | null
_type het type beoordeling hier vindt u de volgende elementen: Max5, Percents, CustomMax
- valueType: number | null Formaat: double
de waarde van de beoordeling
- votesType: integer | null Formaat: int64
_count het aantal feedbacks
- reviewType: string | null
_text reviewtekst
tekst van de review - titleType: string | null
titel van de review
bevat de naam van de site van derden waar de review oorspronkelijk verscheen - urlType: string | null
URL van de review
URL van de site van derden waar de review oorspronkelijk verscheen
- ratingType: object | null
_distribution beoordelingsverdeling per stem
de verdeling van stemmen over de beoordeling in het bereik van 1 tot 5- propertyType: integer | null Formaat: Int64
Name
- valueType: number | null
totale hotelbeoordeling op basis van klantstemmen
- votesType: integer | null Formaat: int64
_count aantal klantstemmen
het aantal klantstemmen dat meetelt in de berekening van de hotelbeoordeling
- starsType: integer | null
sterrenclassificatie van het hotel
classificatie van 1 tot 5 sterren, weergegeven na de beoordelingen in hoteloverzicht - starsType: string | null
_description sterrenclassificatie van het hotel
classificatie van 1 tot 5 sterren, weergegeven na de beoordelingen in het hoteloverzicht - titleType: string | null
titel van het hotel
de titel van de hotelentiteit waarvoor de resultaten worden verzameld
- resultType: integer | null Formaat: int64
_count Aantal elementen in de result-array
- statusType: integer | null
_code statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier
- statusType: string | null
_message informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier
- timeType: string | null
Uitvoeringstijd in seconden
- Type: integer | null Formaat: int64tasks
_count Het aantal taken in de tasks-array
- Type: integer | null Formaat: int64tasks
_error Het aantal taken in de tasks-array dat met een fout is geretourneerd
- Type: string | nulltime
totale uitvoeringstijd, seconden
- Type: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/live/advanced \
--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",
"hotel_identifier": "CgoI-KWyzenM_MV3EAE"
}
]'
{
"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": [
{
"hotel_identifier": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"title": null,
"stars": null,
"stars_description": null,
"address": null,
"phone": null,
"about": {
"description": null,
"sub_descriptions": [
"[Max Depth Exceeded]"
],
"check_in_time": "[Max Depth Exceeded]",
"check_out_time": "[Max Depth Exceeded]",
"full_address": null,
"domain": null,
"url": null,
"amenities": [
"[Max Depth Exceeded]"
],
"popular_amenities": [
"[Max Depth Exceeded]"
]
},
"location": {
"neighborhood": null,
"neighborhood_description": null,
"maps_url": null,
"overall_score": null,
"score_by_categories": null,
"latitude": null,
"longitude": null,
"location_chain": [
"[Max Depth Exceeded]"
]
},
"reviews": {
"value": null,
"votes_count": null,
"mentions": [
"[Max Depth Exceeded]"
],
"rating_distribution": null,
"other_sites_reviews": [
"[Max Depth Exceeded]"
]
},
"overview_images": [
null
],
"prices": {
"price": null,
"price_without_discount": null,
"currency": null,
"discount_text": null,
"check_in": null,
"check_out": null,
"visitors": null,
"items": [
"[Max Depth Exceeded]"
],
"prices_by_dates": [
"[Max Depth Exceeded]"
]
}
}
]
}
]
}