Metrics

Métriques Keyword.com via l'API

Votre client connecte son compte Keyword.com et votre produit interroge 34 métriques par le même endpoint que les autres plateformes. Chaque métrique a un identifiant (reference_key) qui figure dans l'appel.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "comparison_start": "2026-09-01",
  "comparison_end": "2026-09-30",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "keyword:total_keywords",
      "component": "number_v1",
      "metrics": [
        "total_keywords"
      ]
    }
  ]
}
Exemple : « Mots-clés surveillés » en octobre, comparé à septembre.

Plus d'exemples d'appels Keyword.com

Le même endpoint pour chaque type de métrique. Les champs metrics et dimensions de chaque élément viennent du catalogue de la plateforme (GET /api/metrics/{integration_slug}).

Graphique

Position moyenne au fil du temps

Évolution de la position moyenne sur Google des mots-clés surveillés pendant la période analysée.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "keyword:average_position_over_time",
      "component": "chart_v1",
      "metrics": [
        "average_position"
      ],
      "dimensions": [
        "date"
      ]
    }
  ]
}

Tableau

Positionnement des mots-clés

Position de chaque mot-clé surveillé à la fin de la période analysée, avec la variation cumulée pendant la période et la page sur laquelle il est positionné.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "keyword:keywords",
      "component": "datatable_v1",
      "metrics": [
        "position",
        "position_change",
        "best_position",
        "search_volume",
        "cpc",
        "ranking_url"
      ],
      "dimensions": [
        "keyword"
      ]
    }
  ]
}

Chiffre

Mots-clés positionnés

Nombre de mots-clés qui occupent une position parmi les 100 premiers résultats de Google à la fin de la période analysée.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "keyword:ranked_keywords",
      "component": "number_v1",
      "metrics": [
        "ranked_keywords"
      ]
    }
  ]
}

Chiffres

22 métriques

  • Mots-clés surveillés

    Nombre de mots-clés surveillés dans le projet à la fin de la période analysée.

    keyword:total_keywords
  • Mots-clés positionnés

    Nombre de mots-clés qui occupent une position parmi les 100 premiers résultats de Google à la fin de la période analysée.

    keyword:ranked_keywords
  • Mots-clés sans position

    Nombre de mots-clés qui n'ont pas été trouvés parmi les 100 premiers résultats de Google à la fin de la période analysée.

    keyword:unranked_keywords
  • Position moyenne

    Position moyenne sur Google des mots-clés positionnés à la fin de la période analysée. Les mots-clés en dehors des 100 premiers résultats ne sont pas pris en compte dans la moyenne.

    keyword:average_position
  • Mots-clés dans le top 3

    Nombre de mots-clés parmi les trois premiers résultats de Google à la fin de la période analysée.

    keyword:top_3
  • Mots-clés dans le top 10

    Nombre de mots-clés sur la première page de Google à la fin de la période analysée.

    keyword:top_10
  • Mots-clés dans le top 20

    Nombre de mots-clés parmi les vingt premiers résultats de Google à la fin de la période analysée.

    keyword:top_20
  • Mots-clés dans le top 50

    Nombre de mots-clés parmi les cinquante premiers résultats de Google à la fin de la période analysée.

    keyword:top_50
  • Mots-clés dans le top 100

    Nombre de mots-clés parmi les cent premiers résultats de Google à la fin de la période analysée.

    keyword:top_100
  • Part de voix dans le top 3

    Pourcentage des mots-clés surveillés qui sont parmi les trois premiers résultats de Google à la fin de la période analysée.

    keyword:top_3_rate
  • Part de voix sur la première page

    Pourcentage des mots-clés surveillés qui sont sur la première page de Google à la fin de la période analysée.

    keyword:top_10_rate
  • Part de voix positionnée

    Pourcentage des mots-clés surveillés trouvés parmi les 100 premiers résultats de Google à la fin de la période analysée.

    keyword:top_100_rate
  • Mots-clés qui ont monté

    Nombre de mots-clés qui ont progressé dans le classement entre le premier et le dernier jour de la période analysée, y compris ceux qui sont entrés dans les 100 premiers résultats.

    keyword:improved_keywords
  • Mots-clés qui ont baissé

    Nombre de mots-clés qui ont perdu des positions entre le premier et le dernier jour de la période analysée, y compris ceux qui sont sortis des 100 premiers résultats.

    keyword:declined_keywords
  • Mots-clés qui ont maintenu leur position

    Nombre de mots-clés qui ont terminé la période analysée à la même position que celle où elles ont commencé.

    keyword:unchanged_keywords
  • Variation moyenne de position

    Moyenne des positions gagnées pendant la période analysée. Une valeur positive signifie que les mots-clés ont progressé dans le classement.

    keyword:average_position_change
  • Volume de recherche total

    Somme du volume de recherche mensuel de tous les mots-clés surveillés.

    keyword:total_search_volume
  • Volume de recherche moyen

    Volume de recherche mensuel moyen des mots-clés surveillés.

    keyword:average_search_volume
  • CPC moyen

    Coût par clic moyen que Google Ads indique pour les mots-clés surveillés.

    keyword:average_cpc
  • Extraits en vedette

    Nombre de mots-clés pour lesquelles le domaine surveillé occupe le extrait en vedette de Google.

    keyword:featured_snippets
  • Mots-clés dans le pack local

    Nombre de mots-clés pour lesquelles le domaine surveillé apparaît dans les résultats locaux de Google.

    keyword:local_pack
  • Part de voix

    Part des clics estimés des mots-clés surveillés qui vont au domaine du projet, par rapport à tous les domaines positionnés pour eux.

    keyword:share_of_voice

Graphiques

4 métriques

  • Position moyenne au fil du temps

    Évolution de la position moyenne sur Google des mots-clés surveillés pendant la période analysée.

    keyword:average_position_over_time
  • Évolution du positionnement

    Évolution du nombre de mots-clés dans le top 3, sur la première page et parmi les 100 premiers résultats.

    keyword:rankings_over_time
  • Distribution des positions

    Comment les mots-clés surveillés se répartissent par plages de position à la fin de la période analysée.

    keyword:position_distribution
  • Mots-clés par appareil

    Comment les mots-clés surveillés se divisent entre le suivi sur ordinateur et sur mobile.

    keyword:keywords_by_device

Tableaux

8 métriques

  • Positionnement des mots-clés

    Position de chaque mot-clé surveillé à la fin de la période analysée, avec la variation cumulée pendant la période et la page sur laquelle il est positionné.

    keyword:keywords
  • Détails des mots-clés

    Historique de positionnement et de concurrence de chaque mot-clé surveillé.

    keyword:keywords_detailed
  • Performance des mots-clés dans Search Console

    Clics, impressions et taux de clics de chaque mot-clé. Disponible uniquement lorsque le Search Console est connecté dans Keyword.com.

    keyword:keywords_search_console
  • Positionnement par tag

    Performance de chaque groupe de mots-clés marqué avec une étiquette dans Keyword.com.

    keyword:keywords_by_tag
  • Positionnement par page

    Pages du domaine surveillé qui sont positionnées pour le plus grand nombre de mots-clés pendant la période analysée.

    keyword:keywords_by_landing_page
  • Positionnement par outil de recherche

    Performance des mots-clés surveillés dans chaque domaine régional de Google suivi.

    keyword:keywords_by_search_engine
  • Positionnement par intention de recherche

    Performance des mots-clés surveillés regroupés par l'intention que Keyword.com attribue à chaque recherche.

    keyword:keywords_by_intent
  • Part de voix par domaine

    Domaines qui se disputent les mots-clés surveillés, classés par la part des clics estimés que chacun reçoit.

    keyword:competitors

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.