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

Aperçu des mots-clés

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

Aperçu des mots-clés

​

Tout ce que Labs sait sur une liste de keywords en un seul appel : volume, difficulté, intention, concurrence et les fonctionnalités SERP qu'elles déclenchent. Renvoie se_type, location_code, language_code, items_count et items. Ce point de terminaison n'accepte pas de paramètre de limite, mais il est facturé par appel et non par élément : envoyez donc toute la liste d'un coup. 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. Commencez ici quand vous avez des mots-clés ; post_dataforseo_labs_google_keyword_ideas_live est la destination quand il vous en faut davantage.

Référence tarifaire

  • Facturation : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.0254.
  • 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)[]
    • include_clickstream_data
      Type: boolean | null

      inclure ou exclure les données des métriques basées sur le clickstream dans le résultat
      champ facultatif
      si le paramètre est défini sur true, vous recevrez les champs clickstream_keyword_info, keyword_info_normalized_with_clickstream et keyword_info_normalized_with_bing dans la réponse
      valeur par défaut : false
      avec ce paramètre activé, le double du prix de base par requête vous sera facturé

      en savoir plus sur le calcul des métriques basées sur le clickstream dans cet article du centre d'aide

    • include_serp_info
      Type: boolean | null

      inclure les données SERP pour chaque mot-clé
      champ facultatif
      s'il est défini sur true, nous renverrons un tableau serp_info contenant les données SERP (nombre de résultats de recherche, URL pertinente et fonctionnalités SERP) pour chaque mot-clé de la réponse
      valeur par défaut : false

    • keywords
      Type: array string[]

      mots-clés
      champ obligatoire
      Le nombre maximal de mots-clés que vous pouvez indiquer : 700
      Le nombre maximal de caractères pour chaque mot-clé : 80
      Le nombre maximal de mots pour chaque expression de mots-clés : 10
      les mots-clés indiqués seront convertis en minuscules et les données seront fournies dans un tableau distinct

      remarque : si certains des mots-clés indiqués dans ce tableau sont absents des résultats que vous recevez, cela signifie que notre base de données ne contient pas ces mots-clés et ne peut pas renvoyer de données à leur sujet
      les mots-clés absents des résultats ne vous seront pas facturés

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

    • language_code
      Type: string | null

      code de langue
      champ obligatoire si vous n'indiquez pas language_name
      Remarque : il est obligatoire de spécifier language_name ou language_code
      vous pouvez obtenir la liste des emplacements disponibles avec leur language_code en effectuant une requête distincte vers
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      exemple :
      en

    • language_name
      Type: string

      nom complet de la langue
      champ obligatoire si vous n'indiquez pas language_code
      Remarque : il est obligatoire de spécifier language_name ou language_code
      vous pouvez obtenir la liste des emplacements disponibles avec leur language_name en effectuant une requête distincte vers
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      exemple :
      English

    • location_code
      Type: integer

      code d'emplacement
      champ obligatoire si vous n'indiquez pas location_name
      Remarque : il est obligatoire de spécifier location_name ou location_code
      vous pouvez obtenir la liste des emplacements disponibles avec leur location_code en effectuant une requête distincte vers
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      exemple :
      2840

    • location_name
      Type: string

      nom complet de l'emplacement
      champ obligatoire si vous n'indiquez pas location_code
      Remarque : il est obligatoire de spécifier location_name ou location_code
      vous pouvez obtenir la liste des emplacements disponibles avec leur location_name en effectuant une requête distincte vers
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      exemple :
      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_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo
    • 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_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo
        • 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

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

            contient des mots-clés et les données associées

            • avg_backlinks_info
              Type: object | null · Response36Afe1097B20_AvgBacklinksInfo

              données de backlinks pour le mot-clé renvoyé
              cet objet fournit le nombre moyen de backlinks, de pages et de domaines référents, ainsi que les valeurs de classement moyennes parmi les 10 principaux sites web classés organiquement pour le mot-clé

              • backlinks
                Type: number | null

                nombre moyen de backlinks

              • dofollow
                Type: number | null

                nombre moyen de liens dofollow

              • last_updated_time
                Type: string | null

                date et heure de mise à jour des données du mot-clé
                au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
                exemple :
                2019-11-15 12:57:46 +00:00

              • main_domain_rank
                Type: number | null

                rang moyen du domaine principal
                en savoir plus sur la métrique et sa formule de calcul dans cet article du centre d'aide

              • rank
                Type: number | null

                rang moyen
                en savoir plus sur la métrique et sa formule de calcul dans cet article du centre d'aide

              • referring_domains
                Type: number | null

                nombre moyen de domaines référents

              • referring_main_domains
                Type: number | null

                nombre moyen de domaines principaux référents

              • referring_pages
                Type: number | null

                nombre moyen de pages référentes

              • se_type
                Type: string | null

                type de moteur de recherche

            • clickstream_keyword_info
              Type: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

              données clickstream du mot-clé renvoyé
              pour obtenir des résultats pour ce champ, le paramètre include_clickstream_data doit être défini sur true

              • age_distribution
                Type: object | null

                répartition des métriques basées sur le clickstream par âge
                en savoir plus sur le mode de calcul de cette métrique dans cet article du centre d'aide

                • propertyName
                  Type: integer | null Format: int64

                  Signed 64-bit integers (long type).

              • gender_distribution
                Type: object | null

                répartition des métriques estimées basées sur le clickstream par genre
                en savoir plus sur le mode de calcul de cette métrique dans cet article du centre d'aide

                • propertyName
                  Type: integer | null Format: int64

                  Signed 64-bit integers (long type).

              • last_updated_time
                Type: string | null

                date et heure de mise à jour des données du mot-clé
                au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
                exemple :
                2019-11-15 12:57:46 +00:00

              • 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 sur les douze derniers mois), ciblées sur les emplacements géographiques spécifiés

                • month
                  Type: integer | null

                  mois

                • search_volume
                  Type: integer | null

                  taux moyen mensuel de volume de recherche

                • year
                  Type: integer | null

                  année

              • search_volume
                Type: integer | null Format: int64

                taux moyen de volume de recherche mensuel
                représente le nombre (approximatif) de recherches pour l'idée de mot-clé donnée sur google.com

            • keyword
              Type: string | null

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

            • keyword_info
              Type: object | null · Response36Afe1097B20_KeywordInfo

              données de mot-clé pour le mot-clé renvoyé

              • categories
                Type: array integer[] | null

                catégories de produits et de services
                vous pouvez télécharger la liste complète des catégories possibles

              • competition
                Type: number | null

                concurrence
                représente la quantité relative de concurrence associée au mot-clé donné. Cette valeur est basée sur les données Google Ads et peut être comprise entre 0 et 1 (inclus)

              • competition_level
                Type: string | null

                niveau de concurrence
                représente le niveau relatif de concurrence associé au mot-clé donné uniquement dans les SERP payants ;
                valeurs possibles : LOW, MEDIUM, HIGH
                si le niveau de concurrence est inconnu, 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
                représente le coût par clic moyen (USD) historiquement payé pour le mot-clé

              • 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

              • last_updated_time
                Type: string | null

                date et heure de mise à jour des données du mot-clé
                au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
                exemple :
                2019-11-15 12:57:46 +00:00

              • 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 sur les douze derniers mois), ciblées sur les emplacements géographiques spécifiés

                • month
                  Type: integer | null

                  mois

                • search_volume
                  Type: integer | null

                  taux moyen mensuel de volume de recherche

                • year
                  Type: integer | null

                  année

              • se_type
                Type: string | null

                type de moteur de recherche

              • search_volume
                Type: integer | null Format: int64

                taux moyen de volume de recherche mensuel
                représente le nombre (approximatif) de recherches pour l'idée de mot-clé donnée sur google.com

              • search_volume_trend
                Type: object | null · Response36Afe1097B20_SearchVolumeTrend

                variations de la tendance du volume de recherche
                représente la variation en pourcentage du volume de recherche par rapport à la période précédente

                • monthly
                  Type: integer | null

                  variation en pourcentage du volume de recherche par rapport au mois précédent

                • quarterly
                  Type: integer | null

                  variation en pourcentage du volume de recherche par rapport au trimestre précédent

                • yearly
                  Type: integer | null

                  variation en pourcentage du volume de recherche par rapport à l'année précédente

            • keyword_info_normalized_with_bing
              Type: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              contient le volume de recherche du mot-clé normalisé par le volume de recherche Bing

              • is_normalized
                Type: boolean | null

                les informations de mot-clé sont normalisées si vrai, les valeurs sont normalisées avec les données Bing

              • last_updated_time
                Type: string | null

                date et heure de mise à jour de l'ensemble de données au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” exemple : 2019-11-15 12:57:46 +00:00

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

                taux mensuels de volume de recherche tableau d'objets avec les taux de volume de recherche pour un mois donné d'une année

                • month
                  Type: integer | null

                  mois

                • search_volume
                  Type: integer | null

                  taux moyen mensuel de volume de recherche

                • year
                  Type: integer | null

                  année

              • search_volume
                Type: integer | null

                taux actuel de volume de recherche d'un mot-clé

            • keyword_info_normalized_with_clickstream
              Type: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              contient le volume de recherche du mot-clé normalisé par les données clickstream

              • is_normalized
                Type: boolean | null

                les informations de mot-clé sont normalisées si vrai, les valeurs sont normalisées avec les données Bing

              • last_updated_time
                Type: string | null

                date et heure de mise à jour de l'ensemble de données au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” exemple : 2019-11-15 12:57:46 +00:00

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

                taux mensuels de volume de recherche tableau d'objets avec les taux de volume de recherche pour un mois donné d'une année

                • month
                  Type: integer | null

                  mois

                • search_volume
                  Type: integer | null

                  taux moyen mensuel de volume de recherche

                • year
                  Type: integer | null

                  année

              • search_volume
                Type: integer | null

                taux actuel de volume de recherche d'un mot-clé

            • keyword_properties
              Type: object | null · Response36Afe1097B20_KeywordProperties

              informations complémentaires sur le mot-clé

              • core_keyword
                Type: string | null

                mot-clé principal d'un groupe
                contient le mot-clé principal d'un groupe déterminé par l'algorithme de regroupement de synonymes
                si la valeur est null, notre base de données ne contient aucun mot-clé que l'algorithme correspondant pourrait identifier comme synonyme de keyword

              • detected_language
                Type: string | null

                langue détectée du mot-clé
                indique la langue du mot-clé telle qu'identifiée par notre système

              • is_another_language
                Type: boolean | null

                la langue détectée du mot-clé diffère de la langue définie
                si true, la langue définie dans la requête ne correspond pas à la langue déterminée par notre système pour un mot-clé donné

              • keyword_difficulty
                Type: integer | null

                difficulté de se classer dans les 10 premiers résultats organiques pour un mot-clé
                indique la probabilité d'entrer dans les 10 premiers résultats organiques pour un mot-clé sur une échelle logarithmique de 0 à 100 ;
                calculée en analysant, entre autres paramètres, les profils de liens des 10 premières pages des SERP ;
                en savoir plus sur la métrique dans ce guide du centre d'aide

              • se_type
                Type: string | null

                type de moteur de recherche

              • synonym_clustering_algorithm
                Type: string | null

                l'algorithme utilisé pour identifier les synonymes
                valeurs possibles :
                keyword_metrics - indique l'algorithme basé sur les paramètres keyword_info
                text_processing - indique l'algorithme basé sur le texte
                si la valeur est null, notre base de données ne contient aucun mot-clé que l'algorithme correspondant pourrait identifier comme synonyme de keyword

              • words_count
                Type: integer | null Format: int64

                nombre de mots dans le mot-clé
                indique de combien de mots se compose le mot-clé

            • 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_type
              Type: string | null

              type de moteur de recherche

            • search_intent_info
              Type: object | null · Response36Afe1097B20_SearchIntentInfo

              informations d'intention de recherche pour le mot-clé renvoyé
              en savoir plus sur l'intention de recherche dans cet article du centre d'aide

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

                intentions de recherche complémentaires
                valeurs possibles : informational, navigational, commercial, transactional

              • last_updated_time
                Type: string | null

                date et heure de mise à jour des données du mot-clé
                au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
                exemple :
                2019-11-15 12:57:46 +00:00

              • main_intent
                Type: string | null

                intention de recherche principale
                valeurs possibles : informational, navigational, commercial, transactional

              • se_type
                Type: string | null

                type de moteur de recherche

            • search_partners
              Type: boolean | null

              indique les données pour Google et les sites partenaires
              si true, les résultats sont renvoyés pour les réseaux détenus, exploités et syndiqués de Google et des sites partenaires qui hébergent la recherche Google ;
              si false, les résultats sont renvoyés uniquement pour les sites de recherche Google

            • serp_info
              Type: object | null · Response36Afe1097B20_SerpInfo

              données SERP
              la valeur sera null si vous n'avez pas défini le champ include_serp_info sur true dans le tableau POST ou s'il n'existe aucune donnée SERP pour ce mot-clé dans notre base de données

              • 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

              • last_updated_time
                Type: string | null

                date et heure de mise à jour des données du mot-clé
                au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
                exemple :
                2019-11-15 12:57:46 +00:00

              • previous_updated_time
                Type: string | null

                date et heure précédant la plus récente mise à jour des données SERP
                au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
                exemple :
                2019-10-15 12:57:46 +00:00

              • se_results_count
                Type: integer | null Format: int64

                nombre de résultats de recherche pour le mot-clé renvoyé

              • se_type
                Type: string | null

                type de moteur de recherche

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

                types de résultats de recherche dans la SERP
                contient les types de résultats de recherche (items) trouvés dans la SERP
                types d'éléments possibles :
                answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
                remarque : les résultats réels ne seront renvoyés que pour les éléments organic, paid, featured_snippet et local_pack

          • items_count
            Type: integer | null Format: int64

            le nombre de résultats renvoyés dans le tableau items

          • 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_type
            Type: string | null

            type de moteur de recherche

        • 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/dataforseo_labs/google/keyword_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keyword_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "include_clickstream_data": true,
    "include_serp_info": true,
    "keywords": [
      "iphone"
    ]
  }
]'

{
  "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": [
        {
          "se_type": null,
          "location_code": null,
          "language_code": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "keyword": null,
              "location_code": null,
              "language_code": null,
              "search_partners": null,
              "keyword_info": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
              "clickstream_keyword_info": "[Max Depth Exceeded]",
              "keyword_properties": "[Max Depth Exceeded]",
              "serp_info": "[Max Depth Exceeded]",
              "avg_backlinks_info": "[Max Depth Exceeded]",
              "search_intent_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Keyword Overview