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

Configurer les tâches questions et réponses Google My Business en temps réel

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

Configurer les tâches questions et réponses Google My Business en temps réel

​

Les questions et réponses d'un Google Business Profile, trouvées par keyword et location_code. Renvoie keyword, se_domain, location_code, language_code, check_url, datetime, cid, feature_id et item_types. 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é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)[]
    • depth
      Type: integer | null

      profondeur d'analyse
      champ facultatif
      nombre de résultats dans le SERP
      valeur par défaut : 20
      valeur maximale : 100
      Votre compte sera facturé pour chaque SERP contenant jusqu'à 20 résultats ;
      Définir une profondeur supérieure à 20 peut entraîner des frais supplémentaires si le moteur de recherche renvoie plus de 20 résultats ;
      Si la profondeur spécifiée est supérieure au nombre de questions de la réponse, la différence sera automatiquement remboursée sur le solde de votre compte ;
      Le coût peut être calculé sur la page Tarifs.

    • keyword
      Type: string

      mot-clé
      champ obligatoire
      le mot-clé que vous spécifiez doit indiquer le nom de l'établissement local
      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” ;

      ce champ peut aussi servir à transmettre les paramètres suivants :
      cid - un id unique de l'entité commerciale, défini par Google ;
      place_id - un identifiant de l'entité commerciale dans Google Maps ;

      exemple :
      cid:194604053573767737
      place_id:GhIJQWDl0CIeQUARxks3icF8U8A

      en savoir plus sur les identifiants cid et place_id dans cet article du centre d'aide

      en savoir plus sur les règles et limites des champs keyword et keywords dans les API DataForSEO dans cet article du centre d'aide

    • 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

    • location_code
      Type: integer

      code de localisation du moteur de recherche
      champ obligatoire si vous n'indiquez pas location_name ou location_coordinate
      si vous utilisez ce champ, vous n'avez pas besoin d'indiquer location_name ou location_coordinate
      vous pouvez obtenir la liste des localisations disponibles avec location_code en effectuant une requête distincte vers 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,radius"
      nombre maximal de décimales pour "latitude" et "longitude" : 7
      valeur minimale pour "radius" : 199.9 (mm)
      valeur maximale pour "radius" : 199999 (mm)
      exemple :
      53.476225,-2.243572,200

    • 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

    • 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_BusinessDataGoogleQuestionsAndAnswersLiveResponseInfo
    • 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_BusinessDataGoogleQuestionsAndAnswersLiveTaskInfo
        • 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

            identifiant unique de la fonctionnalité SERP

          • item_types
            Type: array (string | null)[] | null

            types d'éléments
            types de résultats de recherche trouvés dans le tableau items ;
            types d'éléments possibles : google_business_question_item

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

            tableau d'éléments
            éléments dans google_business_question_item

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

              tableau d'éléments
              éléments dans google_business_question_item

              • answer_id
                Type: string | null

                ID de la réponse

              • answer_text
                Type: string | null

                texte actuel de la réponse

              • original_answer_text
                Type: string | null

                texte original de la réponse

              • profile_image_url
                Type: string | null

                URL de l'image de profil de l'utilisateur

              • profile_name
                Type: string | null

                nom affiché de l'utilisateur

              • profile_url
                Type: string | null

                URL du profil de l'utilisateur

              • time_ago
                Type: string | null

                heure estimée de publication de la réponse

              • timestamp
                Type: string | null

                heure exacte de publication de la réponse

              • type
                Type: string | null

                type d'élément

            • original_question_text
              Type: string | null

              texte original de la question

            • profile_image_url
              Type: string | null

              URL de l'image de profil de l'utilisateur

            • profile_name
              Type: string | null

              nom affiché de l'utilisateur

            • profile_url
              Type: string | null

              URL du profil de l'utilisateur

            • question_id
              Type: string | null

              ID de la question

            • question_text
              Type: string | null

              texte actuel de la question

            • rank_absolute
              Type: integer | null

              rang absolu parmi tous les éléments

            • 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

            • time_ago
              Type: string | null

              heure estimée de publication de la question

            • timestamp
              Type: string | null

              heure exacte de publication de la question

            • type
              Type: string | null

              type d'élément

            • url
              Type: string | null

              URL de la question

          • items_count
            Type: integer | null Format: int64

            le nombre d'éléments du tableau items

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

            tableau d'éléments de questions Google Business sans réponses

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

              tableau d'éléments
              éléments dans google_business_question_item

              • answer_id
                Type: string | null

                ID de la réponse

              • answer_text
                Type: string | null

                texte actuel de la réponse

              • original_answer_text
                Type: string | null

                texte original de la réponse

              • profile_image_url
                Type: string | null

                URL de l'image de profil de l'utilisateur

              • profile_name
                Type: string | null

                nom affiché de l'utilisateur

              • profile_url
                Type: string | null

                URL du profil de l'utilisateur

              • time_ago
                Type: string | null

                heure estimée de publication de la réponse

              • timestamp
                Type: string | null

                heure exacte de publication de la réponse

              • type
                Type: string | null

                type d'élément

            • original_question_text
              Type: string | null

              texte original de la question

            • profile_image_url
              Type: string | null

              URL de l'image de profil de l'utilisateur

            • profile_name
              Type: string | null

              nom affiché de l'utilisateur

            • profile_url
              Type: string | null

              URL du profil de l'utilisateur

            • question_id
              Type: string | null

              ID de la question

            • question_text
              Type: string | null

              texte actuel de la question

            • rank_absolute
              Type: integer | null

              rang absolu parmi tous les éléments

            • 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

            • time_ago
              Type: string | null

              heure estimée de publication de la question

            • timestamp
              Type: string | null

              heure exacte de publication de la question

            • type
              Type: string | null

              type d'élément

            • url
              Type: string | null

              URL de la question

          • 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)
            ce champ contiendra le paramètre cid si vous l'avez spécifié dans le champ keyword lors de la définition d'une tâche ;
            exemple :
            cid:2946633002421908862
            en savoir plus sur le paramètre dans cet article du centre d'aide

          • language_code
            Type: string | null

            code de langue dans un tableau POST

          • location_code
            Type: integer | null

            code de localisation dans un tableau POST

          • se_domain
            Type: string | null

            domaine du moteur de recherche tel que spécifié dans un tableau POST

        • 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 post/v1/beta/dataforseo/business_data/google/questions_and_answers/live
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/questions_and_answers/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_name": "Los Angeles,California,United States",
    "keyword": "The Last Bookstore"
  }
]'

{
  "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,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "cid": null,
          "feature_id": null,
          "item_types": [
            null
          ],
          "items_without_answers": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Setting Live Google My Business Questions and Answers Tasks