Felo API PlatformFelo API Platform
Tous les endpoints DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Obtenir les résultats de Business Data Google Extended Reviews par id

Serveur:https://openapi.felo.ai
Bibliothèques clientes

DataForSEO

​

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

Obtenir les résultats de Business Data Google Extended Reviews par id

​

Récupère par id une tâche en file d'attente contenant l'historique complet des avis Google d'une entreprise, au-delà de la première page que renvoie l'endpoint standard. 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. ⚠️ La taille dépend du depth défini lors de la soumission et ne peut pas être réduite ici.

Référence tarifaire

  • Facturation : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.012.
  • 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.

Paramètres de chemin
  • id
    Type: string
    obligatoire

    identifiant de la tâche
    identifiant unique de la tâche dans notre système au format UUID
    vous pourrez l'utiliser pendant 30 jours pour demander les résultats de la tâche à tout moment

Réponses
  • 200
    Type: object | null · Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetResponseInfo
    • 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_BusinessDataGoogleExtendedReviewsTaskGetTaskInfo
        • 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: array (object | null)[] | null

          tableau de résultats

          • check_url
            Type: string | null

            URL directe vers les résultats du moteur de recherche
            vous pouvez l'utiliser pour vérifier que nous fournissons des résultats précis

          • cid
            Type: string | null

            ID client défini par Google
            ID unique d'un établissement local
            en savoir plus sur l'identifiant dans cet article du centre d'aide

          • datetime
            Type: string | null

            date et heure de réception du résultat
            au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
            exemple :
            2019-11-15 12:57:46 +00:00

          • feature_id
            Type: string | null

            l'identifiant unique de l'élément 'reviews' dans la SERP
            en savoir plus sur l'identifiant dans cet article du centre d'aide

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

            avis trouvés
            vous pouvez obtenir plus de résultats avec le paramètre depth lors de la définition d'une tâche

            • images
              Type: array (object | null)[] | null

              images soumises par l'auteur de l'avis

              • alt
                Type: string | null

                balise alt de l'image

              • image_url
                Type: string | null

                URL de l'image
                l'URL menant à l'image sur la ressource d'origine ou dans le stockage DataForSEO (si la source d'origine n'est pas disponible)

              • type
                Type: string | null

                type d'élément

              • url
                Type: string | null

                URL pertinente

            • local_guide
              Type: boolean | null

              indique si l'auteur de l'avis a le statut « local guide »

            • original_owner_answer
              Type: string | null

              texte original de la réponse du propriétaire
              la réponse originale à l'avis, sans traduction automatique appliquée

            • original_review_text
              Type: string | null

              contenu original de l'avis
              le contenu original de l'avis, sans traduction automatique appliquée

            • owner_answer
              Type: string | null

              texte de la réponse du propriétaire
              la réponse du propriétaire à l'avis

            • owner_time_ago
              Type: string | null

              heure de publication
              indique le moment (au format « il y a ») où le propriétaire a envoyé la réponse à l'avis

            • owner_timestamp
              Type: string | null

              date et heure de la réponse du propriétaire à l'avis
              au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
              exemple :
              2019-11-15 12:57:46 +00:00

            • photos_count
              Type: integer | null Format: int64

              nombre total de photos soumises par l'auteur de l'avis

            • position
              Type: string | null

              l'alignement de l'avis dans la SERP
              peut prendre les valeurs suivantes : right

            • profile_image_url
              Type: string | null

              URL de l'image de profil de l'auteur de l'avis

            • profile_name
              Type: string | null

              nom de profil de l'auteur de l'avis

            • profile_url
              Type: string | null

              URL du profil de l'auteur de l'avis

            • rank_absolute
              Type: integer | null

              rang absolu parmi tous les avis listés
              position absolue parmi tous les avis de la liste

            • rank_group
              Type: integer | null

              position au sein d'un groupe d'éléments ayant des valeurs type identiques
              les positions des éléments ayant des valeurs type différentes sont omises de rank_group

            • rating
              Type: object | null · Response36Afe1097B20_RatingInfo

              la note soumise par l'auteur de l'avis

              • rating_max
                Type: integer | null

                la valeur maximale d'un rating_type

              • rating_type
                Type: string | null

                le type de note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax

              • value
                Type: number | null Format: double

                la valeur de la note

              • votes_count
                Type: integer | null Format: int64

                la quantité d'avis

            • review_highlights
              Type: array (object | null)[] | null

              points forts de l'avis
              contient les critères et évaluations mis en évidence

              • assessment
                Type: string | null

                évaluation de la caractéristique

              • feature
                Type: string | null

                caractéristique évaluée

            • review_id
              Type: string | null

              l'identifiant unique d'un avis sur Google
              exemple :
              ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE

            • review_text
              Type: string | null

              le contenu de l'avis

            • review_url
              Type: string | null

              l'URL de l'avis

            • reviews_count
              Type: integer | null Format: int64

              nombre total d'avis soumis par l'auteur de l'avis

            • source
              Type: object | null · Response36Afe1097B20_Source

              source de l'avis
              contient des informations sur la source où l'avis a été publié

              • domain
                Type: string | null

                domaine de la source où l'avis a été publié

              • image
                Type: string | null

                image à la une de la source

              • title
                Type: string | null

                nom de la source où l'avis a été publié

            • time_ago
              Type: string | null

              l'heure de publication
              indique le moment (au format « il y a ») où l'avis a été listé

            • timestamp
              Type: string | null

              date et heure de publication d'un avis
              au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
              exemple :
              2019-11-15 12:57:46 +00:00

            • type
              Type: string | null

              type d'élément

            • xpath
              Type: string | null

              le XPath de l'avis

          • items_count
            Type: integer | null Format: int64

            le nombre d'éléments d'avis dans le tableau de résultats
            vous pouvez obtenir plus de résultats avec le paramètre depth lors de la définition d'une tâche

          • keyword
            Type: string | null

            mot-clé reçu dans un tableau POST
            le mot-clé est renvoyé avec %## décodé (le caractère '+' sera décodé en espace)

          • language_code
            Type: string | null

            code de langue dans un tableau POST

          • location_code
            Type: integer | null

            code de localisation dans un tableau POST

          • place_id
            Type: string | null

            identifiant unique d'un établissement commercial attribué par Google
            en savoir plus sur l'identifiant dans cet article du centre d'aide

          • rating
            Type: object | null · Response36Afe1097B20_RatingInfo

            note de l'établissement local correspondant
            taux de popularité basé sur les avis et affiché dans la SERP

            • rating_max
              Type: integer | null

              la valeur maximale d'un rating_type

            • rating_type
              Type: string | null

              le type de note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax

            • value
              Type: number | null Format: double

              la valeur de la note

            • votes_count
              Type: integer | null Format: int64

              la quantité d'avis

          • reviews_count
            Type: integer | null Format: int64

            le nombre total d'avis

          • se_domain
            Type: string | null

            domaine du moteur de recherche dans un tableau POST

          • sub_title
            Type: string | null

            sous-titre de l'élément 'reviews' dans la SERP
            informations supplémentaires (par exemple, l'adresse) sur l'élément 'reviews' pour lequel les avis sont collectés

          • title
            Type: string | null

            titre de l'élément 'reviews' dans la SERP
            le nom de l'établissement local pour lequel les avis sont collectés

          • type
            Type: string | null

            type d'élément

        • 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
Request Example for get/v1/beta/dataforseo/business_data/google/extended_reviews/task_get/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/extended_reviews/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "title": null,
          "sub_title": null,
          "rating": {
            "rating_type": null,
            "value": null,
            "votes_count": null,
            "rating_max": null
          },
          "feature_id": null,
          "place_id": null,
          "cid": null,
          "reviews_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "review_text": null,
              "original_review_text": null,
              "time_ago": null,
              "timestamp": null,
              "rating": "[Max Depth Exceeded]",
              "reviews_count": null,
              "photos_count": null,
              "local_guide": null,
              "profile_name": null,
              "profile_url": null,
              "review_url": null,
              "profile_image_url": null,
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null,
              "review_id": null,
              "images": [
                "[Max Depth Exceeded]"
              ],
              "review_highlights": [
                "[Max Depth Exceeded]"
              ],
              "source": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Get Business Data Google Extended Reviews Results by id