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

Configurer les tâches ‘Google Ads Search Volume’ 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 ‘Google Ads Search Volume’ en temps réel

​

Volume de recherche Google Ads pour une liste de keywords. Renvoie keyword, location_code, language_code, search_partners, competition, competition_index, search_volume, low_top_of_page_bid, high_top_of_page_bid, cpc et monthly_searches, ainsi que spell lorsque Google a corrigé le terme. 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. Il s'agit du nombre classique de volume de recherche ; pour la fréquence à laquelle les gens interrogent un assistant, utilisez post_dataforseo_ai_keyword_volume_live. Les variantes de soumission et de récupération de ce point de terminaison effectuent le même travail de manière asynchrone, au même prix, pour les lots trop volumineux pour attendre.

Référence tarifaire

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

Corps
application/json
  • Type: array (object | null)[]
    • date_from
      Type: string | null

      date de début de la plage de temps
      champ facultatif
      format de date : "yyyy-mm-dd"
      valeur minimale : 4 ans à compter de la date actuelle
      par défaut, les données sont renvoyées pour les 12 derniers mois ;
      Remarque : la date indiquée ne peut pas être supérieure à celle indiquée dans date_to et/ou à la date d'hier ;si le point de terminaison Status renvoie false dans le champ actual_data, date_from peut être défini au mois d'avant-dernier et avant ;
      si le point de terminaison Status renvoie true dans le champ actual_data, date_from peut être défini au mois dernier et avant

    • date_to
      Type: string | null

      date de fin de la plage de temps
      champ facultatif
      Remarque : la date indiquée ne peut pas être supérieure au mois dernier, Google Ads ne renvoie pas de données sur le mois en cours ;
      si vous ne spécifiez pas ce champ, la date d'hier sera utilisée par défaut
      format de date : "yyyy-mm-dd"
      exemple :
      "2022-11-30"

    • include_adult_keywords
      Type: boolean | null

      inclure les mots-clés associés au contenu pour adultes
      champ facultatif
      si défini sur true, les mots-clés pour adultes seront inclus dans la réponse
      valeur par défaut : false
      notez que l'API peut ne renvoyer aucune donnée pour ces mots-clés en raison des restrictions de Google Ads

    • keywords
      Type: array string[]

      mots-clés
      champ obligatoire
      Le nombre maximal de mots-clés que vous pouvez indiquer : 1000
      Le nombre maximal de caractères par mot-clé : 80
      Le nombre maximal de mots par expression de mot-clé : 10
      les mots-clés que vous indiquez seront convertis en minuscules
      Remarque n° 1 : Google Ads peut ne renvoyer aucune donnée pour certains groupes de mots-clés ;
      Remarque n° 2 : Google Ads fournit des valeurs de volume de recherche combinées pour des groupes de mots-clés similaires
      pour obtenir le volume de recherche de mots-clés similaires, nous recommandons d'envoyer ces mots-clés dans des requêtes distinctes ;
      Remarque n° 3 : Google Ads n'autorise pas l'utilisation de certains symboles et caractères (par exemple, symboles UTF, emojis), vous ne pouvez donc pas les utiliser lors de la définition d'une tâche ;
      pour en savoir plus sur les symboles et caractères utilisables, consultez cet article

      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 | null

      code de langue du moteur de recherche
      champ facultatif
      vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leur language_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      exemple :
      en

    • language_name
      Type: string | null

      nom complet de la langue du moteur de recherche
      champ facultatif
      vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leur language_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      exemple :
      English

    • location_code
      Type: integer | null

      code d'emplacement du moteur de recherche
      champ facultatif
      si vous n'indiquez pas l'emplacement, vous recevrez des résultats mondiaux, c'est-à-dire pour tous les emplacements disponibles ;
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ni location_coordinate ;
      vous pouvez obtenir la liste des emplacements disponibles des moteurs de recherche avec leur location_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      exemple :
      2840

    • location_coordinate
      Type: string | null

      coordonnées GPS d'un emplacement
      champ facultatif
      si vous n'indiquez pas l'emplacement, vous recevrez des résultats mondiaux, c'est-à-dire pour tous les emplacements disponibles ;
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ni location_code ;
      le paramètre location_coordinate doit être indiqué au format "latitude,longitude" ;
      les données seront fournies pour le pays auquel appartiennent les coordonnées indiquées ;
      exemple :
      52.6178549,-155.352142

    • location_name
      Type: string | null

      nom complet de l'emplacement du moteur de recherche
      champ facultatif
      si vous n'indiquez pas l'emplacement, vous recevrez des résultats mondiaux, c'est-à-dire pour tous les emplacements disponibles ;
      si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_code ni location_coordinate
      vous pouvez obtenir la liste des emplacements disponibles du moteur de recherche avec leur location_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      exemple :
      London,England,United Kingdom

    • search_partners
      Type: boolean | null

      inclure les partenaires de recherche Google
      champ facultatif
      si vous indiquez true, les résultats seront fournis pour les réseaux détenus, exploités et syndiqués de Google et des sites partenaires qui hébergent la recherche Google ;
      valeur par défaut : false - les résultats sont renvoyés pour les sites de recherche Google

    • sort_by
      Type: string | null

      paramètres de tri des résultats
      champ facultatif
      utilisez ces paramètres pour trier les résultats par relevance, search_volume, competition_index, low_top_of_page_bid ou high_top_of_page_bid par ordre décroissant
      valeur par défaut : relevance

    • 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 le tableau data de la réponse

Réponses
  • 200
    Type: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResponseInfo
    • 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_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo
        • 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

          • competition
            Type: string | null

            concurrence
            représente la quantité relative de concurrence associée au mot-clé donné uniquement dans les SERP payants ;
            cette valeur est basée sur les données Google Ads et peut prendre les valeurs suivantes : HIGH, MEDIUM, LOW ;
            s'il n'y a pas de données, la valeur est null ;
            en savoir plus sur la métrique dans cet article du centre d'aide

          • competition_index
            Type: integer | null

            concurrence
            représente la quantité relative de concurrence associée au mot-clé donné uniquement dans les SERP payants ;
            cette valeur est basée sur les données Google Ads et peut être comprise entre 0 et 100 (inclus) ;
            s'il n'y a pas de données, la valeur est null ;
            en savoir plus sur la métrique dans cet article du centre d'aide

          • cpc
            Type: number | null

            coût par clic
            indique le montant payé (USD) pour chaque clic sur l'annonce diffusée pour un mot-clé donné

          • high_top_of_page_bid
            Type: number | null

            enchère maximale pour que l'annonce s'affiche en haut de la première page
            indique la valeur supérieure à environ 80 % des enchères les plus basses pour lesquelles des annonces ont été diffusées (d'après les statistiques Google Ads pour les annonceurs) ;
            la valeur peut varier selon la localisation indiquée dans une requête POST

          • keyword
            Type: string | null

            mot-clé
            le mot-clé est renvoyé avec %## décodé (le caractère plus '+' sera décodé en espace)

          • 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

          • low_top_of_page_bid
            Type: number | null

            enchère minimale pour que l'annonce s'affiche en haut de la première page
            indique la valeur supérieure à environ 20 % des enchères les plus basses pour lesquelles des annonces ont été diffusées (d'après les statistiques Google Ads pour les annonceurs) ;
            la valeur peut varier selon la localisation indiquée dans une requête POST

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

            recherches mensuelles
            représente le nombre (approximatif) de recherches sur cette idée de mot-clé (tel que disponible pour les douze derniers mois par défaut), ciblées sur les emplacements géographiques indiqués ;
            s'il n'y a pas de données, la valeur est null

            • month
              Type: integer | null

              mois

            • search_volume
              Type: integer | null

              taux moyen mensuel de volume de recherche

            • year
              Type: integer | null

              année

          • search_partners
            Type: boolean | null

            indique si les données des réseaux partenaires sont incluses dans la réponse

          • search_volume
            Type: integer | null Format: int64

            taux moyen mensuel de volume de recherche ;
            représente le nombre (approximatif) de recherches sur l'idée de mot-clé donnée sur google.com ou sur google.com et ses partenaires, selon le ciblage de l'utilisateur ;
            s'il n'y a pas de données, la valeur est null

          • spell
            Type: string | null

            orthographe correcte du mot-clé
            Remarque :si le mot-clé du tableau POST semble mal orthographié, les données seront renvoyées pour le mot-clé correctement orthographié ;
            nous utilisons les fonctionnalités de l'API Google Ads pour vérifier et valider l'orthographe des mots-clés, en savoir plus via ce lien

        • 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/keywords_data/google_ads/search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "keywords": [
      "buy laptop",
      "cheap laptops for sale",
      "purchase laptop"
    ],
    "date_from": "2021-08-01",
    "search_partners": true
  }
]'

{
  "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,
          "spell": null,
          "location_code": null,
          "language_code": null,
          "search_partners": null,
          "competition": null,
          "competition_index": null,
          "search_volume": null,
          "low_top_of_page_bid": null,
          "high_top_of_page_bid": null,
          "cpc": null,
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Setting Live ‘Google Ads Search Volume’ Tasks