v0.2.0-beta

OpenAPI 3.1.0

Configurer les tâches Google Hotel Info

Felo API Support

MIT

Serveur

https://openapi.felo.ai

Bibliothèques clientes

Shell Curl

DataForSEO

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

DataForSEO Opérations

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

Configurer les tâches Google Hotel Info

Met en file d'attente la consultation d'une fiche d'hôtel et renvoie un id de tâche. Enveloppé dans l'enveloppe DataForSEO : données dans tasks[0].result, résultat dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. Récupérez la forme analysée avec get_dataforseo_business_google_hotel_info_fetch ou la forme brute avec get_dataforseo_business_google_hotel_info_fetch_html.

Référence tarifaire

Facturation : coût de réponse déclaré.
Estimation de référence par requête : USD 0.2428.
Multiplicateur de référence client : 1.0. Ne pas l'appliquer une seconde fois à un montant client déjà réglé.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

Corps

application/json

Type: array (object | null)[]
- adults
  Type: integer | null
  
  nombre d'adultes
  champ facultatif
  si vous ne spécifiez pas ce champ, deux adultes seront utilisés par défaut
  exemple :
  1
- check_in
  Type: string | null
  
  date d'arrivée
  champ facultatif
  si vous ne spécifiez pas ce champ, la date de demain sera utilisée par défaut ;
  la valeur ne doit pas être antérieure à la date du jour
  format de date : "yyyy-mm-dd"
  exemple :
  "2019-01-15"
- check_out
  Type: string | null
  
  date de départ
  champ facultatif
  si vous ne spécifiez pas ce champ, notre système appliquera par défaut la date de deux jours à partir de maintenant ;
  Remarque : la valeur ne peut pas être inférieure ou égale à check_in ;
  l'intervalle entre les valeurs de check_in et check_out ne peut pas dépasser 30 jours
  format de date : "yyyy-mm-dd"
  exemple :
  "2019-01-15"
- children
  Type: array string[] | null
  
  nombre et âge des enfants
  champ facultatif
  si vous ne spécifiez pas ce champ, aucun enfant ne sera inclus dans la recherche ;
  
  définissez la valeur suivante pour inclure un enfant de 14 ans :
  [14]
  définissez la valeur suivante pour inclure un enfant de 13 ans et un enfant de 8 ans :
  [13,8]
- currency
  Type: string | null
  
  devise
  champ facultatif
  exemple :
  "USD"
- hotel_identifier
  Type: string
  
  identifiant unique de l'hôtel
  champ obligatoire si vous ne spécifiez pas keyword
  si vous utilisez ce champ, vous n'avez pas besoin de spécifier keyword
  identifiant unique d'une entité hôtelière dans la recherche Google ;
  vous pouvez obtenir la valeur en effectuant une requête vers l'Advanced Google SERP API (contenue dans l'élément hotels_pack de la réponse) ou vers le point de terminaison Hotel Searches de Business Data API
  exemple :
  ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE
- keyword
  Type: string
  
  mot-clé
  champ obligatoire si vous ne spécifiez pas hotel_identifier
  si vous utilisez ce champ, vous n'avez pas besoin de spécifier hotel_identifier
  le mot-clé que vous spécifiez doit indiquer le nom de l'entité hôtelière
  vous pouvez spécifier jusqu'à 700 caractères dans le champ keyword
  tous les %## seront décodés (le caractère ‘+’ sera décodé en espace)
  si vous devez utiliser le caractère “%” dans votre keyword, spécifiez-le comme “%25”
- language_code
  Type: string
  
  code de langue du moteur de recherche
  champ obligatoire si vous ne spécifiez pas language_name
  si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_name
  vous pouvez obtenir la liste des langues disponibles avec leur language_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/business_data/google/languages
  exemple :
  en
- language_name
  Type: string
  
  nom complet de la langue du moteur de recherche
  champ obligatoire si vous ne spécifiez pas language_code
  si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_code
  vous pouvez obtenir la liste des langues disponibles avec language_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/business_data/google/languages
  exemple :
  English
- load_prices_by_dates
  Type: boolean | null
  
  charger les prix de séjour à l'hôtel par dates
  champ facultatif
  si vous spécifiez ce paramètre avec true, la réponse inclura le tableau prices_by_dates avec les prix de séjour à l'hôtel répartis par dates
  si vous utilisez ce paramètre, le double du prix de base par requête vous sera facturé
- location_code
  Type: integer
  
  code d'emplacement du moteur de recherche
  champ obligatoire si vous ne spécifiez pas location_name_or location_coordinate
  si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ou location_coordinate
  vous pouvez obtenir la liste des emplacements disponibles avec location_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/business_data/google/locations
  exemple :
  2840
- location_coordinate
  Type: string
  
  coordonnées GPS d'un emplacement
  champ obligatoire si vous ne spécifiez pas location_name_or location_code
  si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ou location_code
  le paramètre location_coordinate doit être spécifié au format "latitude,longitude"
  nombre maximal de décimales pour "latitude" et "longitude" : 7
  Remarque : si les coordonnées servent à définir un emplacement, la recherche aura lieu dans la localité la plus proche ;
  exemple :
  53.476225,-2.243572
- location_name
  Type: string
  
  nom complet de l'emplacement du moteur de recherche
  champ obligatoire si vous ne spécifiez pas location_code ou location_coordinate
  si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_code ou location_coordinate
  vous pouvez obtenir la liste des emplacements disponibles avec location_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/business_data/google/locations
  exemple :
  London,England,United Kingdom
- pingback_url
  Type: string | null
  
  URL de notification d'une tâche terminée
  champ facultatif
  lorsqu'une tâche est terminée, nous vous en informons par une requête GET envoyée à l'URL que vous avez spécifiée ;
  vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée pour URL ;
  nous définirons les valeurs nécessaires avant d'envoyer la requête ;
  exemple :
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Remarque : les caractères spéciaux de pingback_url seront encodés pour URL ;
  notamment, le caractère # sera encodé en %23
  
  en savoir plus dans notre centre d'aide
- postback_data
  Type: string
  
  type de données de postback_url
  champ obligatoire si vous spécifiez postback_url
  correspond au type de données qui sera envoyé à votre serveur
  valeurs possibles :
  advanced, html
- postback_url
  Type: string | null
  
  URL d'envoi des résultats de la tâche
  champ facultatif
  une fois la tâche terminée, nous enverrons une requête POST avec ses résultats compressés au format gzip à l'adresse postback_url que vous avez spécifiée ;
  vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête ;
  exemple :
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Remarque : les caractères spéciaux de postback_url seront encodés pour URL ;
  notamment, le caractère # sera encodé en %23
  
  en savoir plus dans notre centre d'aide
- prices_date_range
  Type: string | null
  
  période prédéfinie pour récupérer les données de prix quotidiennes
  champ facultatif
  pour utiliser ce paramètre, vous devez spécifier load_prices_by_dates avec true
  si prices_start_date n'est pas spécifié, la date de début est fixée à la date check_in
  valeurs possibles : month, three_months, six_months, year
  valeur par défaut : month
- prices_end_date
  Type: string | null
  
  date de fin pour charger les prix par dates
  champ facultatif
  pour utiliser ce paramètre, vous devez spécifier load_prices_by_dates avec true
  si ce paramètre n'est pas spécifié, vous obtiendrez les prix par date pour le mois
  format de date : yyyy-mm-dd
  exemple :
  2025-05-21
- prices_start_date
  Type: string | null
  
  date de début pour charger les prix par dates
  champ facultatif
  pour utiliser ce paramètre, vous devez spécifier load_prices_by_dates avec true
  si ce paramètre n'est pas spécifié, la date de début est fixée à la date check_in
  format de date : yyyy-mm-dd
  exemple :
  2025-05-20
- priority
  Type: integer | null
  
  priorité de la tâche
  champ facultatif
  peut prendre les valeurs suivantes :
  1 – priorité d'exécution normale (définie par défaut)
  2 – priorité d'exécution élevée. Les tâches à priorité d'exécution élevée sont facturées en supplément.
  Le coût peut être calculé sur la page Tarifs.
- tag
  Type: string | null
  
  identifiant de tâche défini par l'utilisateur
  champ facultatif
  la limite est de 255 caractères ;
  vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat ;
  vous trouverez la valeur tag spécifiée dans l'objet data de la réponse

Réponses

200
Type: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskPostResponseInfo
cost
Type: number | null Format: double

coût total des tâches, USD

status_code
Type: integer | null

code d'état général vous pouvez trouver la liste complète des codes de réponse ici

status_message
Type: string | null

message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici

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

tableau de tâches

Type: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskPostTaskInfo
cost
Type: number | null Format: double

coût total des tâches, USD

data
Type: object | null

contient les mêmes paramètres que ceux spécifiés dans la requête POST

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

identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID

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

chemin de l'URL

result
Type: object | null

tableau de résultats
dans ce cas, la valeur sera null

result_count
Type: integer | null Format: int64

nombre d'éléments dans le tableau de résultats

status_code
Type: integer | null

code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici

status_message
Type: string | null

message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici

time
Type: string | null

temps d'exécution, en secondes

tasks_count
Type: integer | null Format: int64

le nombre de tâches dans le tableau de tâches

tasks_error
Type: integer | null Format: int64

le nombre de tâches dans le tableau de tâches renvoyées avec une erreur

time
Type: string | null

temps d'exécution total, en secondes

version
Type: string | null

la version actuelle de l'API
application/json
400

La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
401

Une clé API Felo valide est requise.
402

La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
403

Le compte n'est pas autorisé à effectuer cette opération.
429

Une limite de requêtes ou de dépenses a été atteinte.
502

Le service n'a pas pu terminer la requête.
503

L'API ou le service de facturation est temporairement indisponible.
504

Le service a expiré lors du traitement de la requête.
default

Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

application/json

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

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/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",
    "hotel_identifier": "ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE",
    "tag": "some_string_123",
    "postback_url": "https://your-server.com/postbackscript.php",
    "postback_data": "advanced"
  }
]'

Afficher le schéma

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

Opération réussie

Configurer les tâches Google Hotel Info

AuthentificationRequired

DataForSEO

Configurer les tâches Google Hotel Info

Référence tarifaire