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

Obtenir les résultats ‘Bing Keyword Performance’ 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 ‘Bing Keyword Performance’ par id

​

Récupère une tâche de performance de mots-clés Bing en file d'attente par id. 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. 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. ⚠️ La taille de la réponse a été fixée par le depth ou la limite définie lors de la soumission et ne peut pas être réduite ici ; si elle est trop grande, soumettez à nouveau avec une valeur plus petite plutôt que de paginer.

Référence tarifaire

  • Mesure : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.012.
  • Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à 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_KeywordsDataBingKeywordPerformanceTaskGetResponseInfo
    • 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_KeywordsDataBingKeywordPerformanceTaskGetTaskInfo
        • 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

          • keyword
            Type: string | null

            mot-clé dans un tableau POST

          • keyword_kpi
            Type: object | null · Response36Afe1097B20_KeywordKpi

            objet contenant les métriques de mots-clés
            s'il n'y a pas de données, la valeur est null

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

              données de mots-clés agrégées pour les appareils de bureau
              s'il n'y a pas de données, la valeur est null

              • ad_position
                Type: string | null

                représente la position de l'annonce pertinente dans les SERP
                peut prendre les valeurs suivantes :
                FirstPage1 : la première annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage2 : la deuxième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage3 : la troisième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage4 : la quatrième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage5 : la cinquième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage6 : la sixième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage7 : la septième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage8 : la huitième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage9 : la neuvième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage10 : la dixième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                MainLine1 : la première annonce à apparaître en haut de la page de résultats de recherche
                MainLine2 : la deuxième annonce à apparaître en haut de la page de résultats de recherche
                MainLine3 : la troisième annonce à apparaître en haut de la page de résultats de recherche
                MainLine4 : la quatrième annonce à apparaître en haut de la page de résultats de recherche

              • average_bid
                Type: number | null Format: double

                enchère moyenne du mot-clé

              • average_cpc
                Type: number | null Format: double

                coût moyen par clic, USD
                calculé en divisant le coût de tous les clics par le nombre de clics

              • clicks
                Type: integer | null

                clics sur l'annonce
                le nombre de clics générés par le mot-clé et le type de correspondance au cours du dernier mois

              • ctr
                Type: number | null Format: double

                taux de clics en pourcentage
                calculé en divisant le nombre de clics par le nombre d'impressions et en multipliant le résultat par 100

              • impressions
                Type: integer | null

                impressions de l'annonce
                le nombre d'impressions générées par le mot-clé et le type de correspondance au cours du dernier mois

              • total_cost
                Type: number | null Format: int64

                coût total d'une annonce, USD
                le coût d'utilisation du mot-clé et du type de correspondance indiqués au cours du dernier mois

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

              données de mots-clés agrégées pour les appareils mobiles
              s'il n'y a pas de données, la valeur est null

              • ad_position
                Type: string | null

                représente la position de l'annonce pertinente dans les SERP
                peut prendre les valeurs suivantes :
                FirstPage1 : la première annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage2 : la deuxième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage3 : la troisième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage4 : la quatrième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage5 : la cinquième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage6 : la sixième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage7 : la septième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage8 : la huitième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage9 : la neuvième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage10 : la dixième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                MainLine1 : la première annonce à apparaître en haut de la page de résultats de recherche
                MainLine2 : la deuxième annonce à apparaître en haut de la page de résultats de recherche
                MainLine3 : la troisième annonce à apparaître en haut de la page de résultats de recherche
                MainLine4 : la quatrième annonce à apparaître en haut de la page de résultats de recherche

              • average_bid
                Type: number | null Format: double

                enchère moyenne du mot-clé

              • average_cpc
                Type: number | null Format: double

                coût moyen par clic, USD
                calculé en divisant le coût de tous les clics par le nombre de clics

              • clicks
                Type: integer | null

                clics sur l'annonce
                le nombre de clics générés par le mot-clé et le type de correspondance au cours du dernier mois

              • ctr
                Type: number | null Format: double

                taux de clics en pourcentage
                calculé en divisant le nombre de clics par le nombre d'impressions et en multipliant le résultat par 100

              • impressions
                Type: integer | null

                impressions de l'annonce
                le nombre d'impressions générées par le mot-clé et le type de correspondance au cours du dernier mois

              • total_cost
                Type: number | null Format: int64

                coût total d'une annonce, USD
                le coût d'utilisation du mot-clé et du type de correspondance indiqués au cours du dernier mois

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

              données de mots-clés agrégées pour les tablettes
              s'il n'y a pas de données, la valeur est null

              • ad_position
                Type: string | null

                représente la position de l'annonce pertinente dans les SERP
                peut prendre les valeurs suivantes :
                FirstPage1 : la première annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage2 : la deuxième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage3 : la troisième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage4 : la quatrième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage5 : la cinquième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage6 : la sixième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage7 : la septième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage8 : la huitième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage9 : la neuvième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                FirstPage10 : la dixième annonce à apparaître sur le côté droit de la première page de résultats de recherche
                MainLine1 : la première annonce à apparaître en haut de la page de résultats de recherche
                MainLine2 : la deuxième annonce à apparaître en haut de la page de résultats de recherche
                MainLine3 : la troisième annonce à apparaître en haut de la page de résultats de recherche
                MainLine4 : la quatrième annonce à apparaître en haut de la page de résultats de recherche

              • average_bid
                Type: number | null Format: double

                enchère moyenne du mot-clé

              • average_cpc
                Type: number | null Format: double

                coût moyen par clic, USD
                calculé en divisant le coût de tous les clics par le nombre de clics

              • clicks
                Type: integer | null

                clics sur l'annonce
                le nombre de clics générés par le mot-clé et le type de correspondance au cours du dernier mois

              • ctr
                Type: number | null Format: double

                taux de clics en pourcentage
                calculé en divisant le nombre de clics par le nombre d'impressions et en multipliant le résultat par 100

              • impressions
                Type: integer | null

                impressions de l'annonce
                le nombre d'impressions générées par le mot-clé et le type de correspondance au cours du dernier mois

              • total_cost
                Type: number | null Format: int64

                coût total d'une annonce, USD
                le coût d'utilisation du mot-clé et du type de correspondance indiqués au cours du dernier mois

          • language_code
            Type: string | null

            code de langue dans un tableau POST
            s'il n'y a pas de données, la valeur est_nulln

          • location_code
            Type: integer | null

            code d'emplacement dans un tableau POST
            s'il n'y a pas de données, la valeur est_nulln

          • month
            Type: integer | null

            Integer numbers.

          • year
            Type: integer | null

            indique l'année pour laquelle les données sont fournies
            exemple :
            2020

            _ _ _ _ _ _ monthn

        • 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/keywords_data/bing/keyword_performance/task_get/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/keyword_performance/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,
          "location_code": null,
          "language_code": null,
          "year": null,
          "month": null,
          "keyword_kpi": {
            "desktop": [
              "[Max Depth Exceeded]"
            ],
            "mobile": [
              "[Max Depth Exceeded]"
            ],
            "tablet": [
              "[Max Depth Exceeded]"
            ]
          }
        }
      ]
    }
  ]
}
Get ‘Bing Keyword Performance’ Results by id