Configurer les tâches Business Data Tripadvisor Reviews
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurer les tâches Business Data Tripadvisor Reviews
Met en file d'attente les avis Tripadvisor d'un établissement et renvoie un id de tâche. Enveloppé dans l'enveloppe DataForSEO : les données dans tasks[0].result, l'issue dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. Récupérez avec get_dataforseo_business_tripadvisor_reviews_fetch ; l'équivalent Trustpilot est post_dataforseo_business_trustpilot_reviews_submit.
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.
- Type: array (object | null)[]
- depthType: integer | null
profondeur d'analyse
champ facultatif
nombre d'avis dans le SERP ;
nous recommandons vivement de définir la profondeur d'analyse par multiples de dix, car nos systèmes traitent dix avis d'affilée ;
valeur par défaut :10;
valeur maximale :4490
Votre compte sera facturé pour chaque SERP contenant jusqu'à 10 résultats ;
Définir une profondeur supérieure à 10 peut entraîner des frais supplémentaires si le moteur de recherche renvoie plus de 10 résultats ;
Le coût peut être calculé sur la page Tarifs. - keywordType: string
mot-clé
champ obligatoire si vous ne spécifiez pasurl_path
le mot-clé que vous spécifiez doit indiquer le nom d'une entreprise existante ou d'un lieu phare sur Tripadvisor ;
vous pouvez spécifier jusqu'à 700 caractères dans le champkeyword;
tous les %## seront décodés (le caractère ‘+’ sera décodé en espace) ;
si vous devez utiliser le caractère “%” dans votrekeyword, spécifiez-le comme “%25” - languageType: string | null
_code code de langue du moteur de recherche
champ facultatif
si vous utilisez ce champ, votre compte sera facturé pour une requête supplémentaire
vous pouvez obtenir la liste des langues disponibles aveclanguage_codeen effectuant une requête distincte surhttps://api.dataforseo.com/v3/business_data/tripadvisor/languages
exemple :en
Des frais supplémentaires s'appliquent pour la définition d'un paramètre de langue sur ce point de terminaison.
Le coût peut être calculé sur la page Tarifs. - languageType: string | null
_name nom complet de la langue du moteur de recherche
champ facultatif
si vous utilisez ce champ, votre compte sera facturé pour une requête supplémentaire
vous pouvez obtenir la liste des langues disponibles aveclanguage_nameen effectuant une requête distincte surhttps://api.dataforseo.com/v3/business_data/tripadvisor/languages
exemple :English
Des frais supplémentaires s'appliquent pour la définition d'un paramètre de langue sur ce point de terminaison.
Le coût peut être calculé sur la page Tarifs. - locationType: integer
_code code d'emplacement du moteur de recherche
champ obligatoire si vous ne spécifiez paslocation_nameouurl_path
vous pouvez obtenir la liste des emplacements disponibles aveclocation_codeen effectuant une requête distincte surhttps://api.dataforseo.com/v3/business_data/tripadvisor/locations
exemple :1003854 - locationType: string
_name nom complet de l'emplacement du moteur de recherche
champ obligatoire si vous ne spécifiez paslocation_codeouurl_path
vous pouvez obtenir la liste des emplacements disponibles aveclocation_nameen effectuant une requête distincte surhttps://api.dataforseo.com/v3/business_data/tripadvisor/locations
exemple :London,England,United Kingdom - monthsType: array string[] | null
filtrer par mois de visite du voyageur
champ facultatif
valeurs possibles :january,february,march,april,may,april,june,july,august,september,october,november,december
vous pouvez spécifier plusieurs valeurs à la fois - pingbackType: string | null
_url 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$idet ‘$tag’ comme variable$tagencodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
exemple :http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Remarque : les caractères spéciaux depingback_urlseront encodés pour URL ;
notamment, le caractère#sera encodé en%23 - postbackType: string | null
_url 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 formatgzipà l'adressepostback_urlque vous avez spécifiée
vous pouvez utiliser la chaîne ‘$id’ comme variable$idet ‘$tag’ comme variable$tagencodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
exemple :http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Remarque : les caractères spéciaux depostback_urlseront encodés pour URL ;
notamment, le caractère#sera encodé en%23 - priorityType: integer | null
- ratingsType: array string[] | null
note du voyageur Tripadvisor pour un lieu d'intérêt
champ facultatif
note fondée sur les avis écrits par un voyageur après sa visite d'un lieu.
valeurs possibles :excellent,very_good,average,poor,terrible
vous pouvez spécifier plusieurs valeurs à la fois - sortType: string | null
_by paramètres de tri des résultats
champ facultatif
vous pouvez utiliser ce champ pour trier les résultats ;
types de tri possibles :most_recentdetailed_reviews - tagType: 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 valeurtagspécifiée dans l'objetdatade la réponse - translateType: boolean | null
_reviews traduire les avis selon le chemin de l'URL
champ facultatif
si la valeur esttrue, les avis renvoyés seront traduits dans la langue correspondant auurl_pathspécifié ;
par exemple, siurl_pathcontienttripadvisor.itet quetranslate_reviewsvauttrue, les avis seront traduits en italien ;
valeur par défaut :true
en savoir plus sur la traduction des avis dans cet article du centre d'aide - urlType: string
_path chemin de l'URL de l'entité commerciale
champ obligatoire si vous ne spécifiez paskeyword
chemin de l'URL vers la page Tripadvisor de l'entité commerciale ;
exemples :Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.htmlhttps://www.tripadvisor.com/Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html - visitType: array string[] | null
_type filtre par type de voyageur ayant laissé un avis
champ facultatif
valeurs possibles :families,couples,solo,business,friends
vous pouvez indiquer plusieurs valeurs à la fois
- Type: object | null · Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskPostResponseInfo200
- Type: number | null Format: doublecost
coût total des tâches, USD
- Type: integer | nullstatus
_code code d'état général vous pouvez trouver la liste complète des codes de réponse ici
- Type: string | nullstatus
_message message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici
- Type: array (object | null)[] | nulltasks
tableau de tâches
- Type: object | null · Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskPostTaskInfo
- costType: number | null Format: double
coût total des tâches, USD
- dataType: object | null
contient les mêmes paramètres que ceux spécifiés dans la requête POST
- propertyType: object | null
Name
- idType: string | null
identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID
- pathType: array (string | null)[] | null
chemin de l'URL
- resultType: object | null
tableau de résultats
dans ce cas, la valeur seranull - resultType: integer | null Format: int64
_count nombre d'éléments dans le tableau de résultats
- statusType: integer | null
_code 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
- statusType: string | null
_message message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici
- timeType: string | null
temps d'exécution, en secondes
- Type: integer | null Format: int64tasks
_count le nombre de tâches dans le tableau de tâches
- Type: integer | null Format: int64tasks
_error le nombre de tâches dans le tableau de tâches renvoyées avec une erreur
- Type: string | nulltime
temps d'exécution total, en secondes
- Type: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"url_path": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
"location_code": 1003854,
"pingback_url": "https://your-server.com/pingback.php?id=$id&tag=$tag",
"tag": "some_string_123"
}
]'
{
"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
}
]
}