Metrics

Keyword.com metrics via API

Your customer connects their Keyword.com account and your product queries 34 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.

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"
      ]
    }
  ]
}
Example: "Tracked keywords" in October, compared to September.

More Keyword.com request examples

The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).

Chart

Average position over time

Evolution of the average Google position of the tracked keywords during the analyzed period.

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"
      ]
    }
  ]
}

Table

Keyword rankings

Position of each tracked keyword at the end of the analyzed period, with the change accumulated during the period and the page that ranks.

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"
      ]
    }
  ]
}

Number

Ranked keywords

Number of keywords holding a position in Google's first 100 results at the end of the analyzed period.

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"
      ]
    }
  ]
}

Numbers

22 metrics

  • Tracked keywords

    Number of keywords being tracked in the project at the end of the analyzed period.

    keyword:total_keywords
  • Ranked keywords

    Number of keywords holding a position in Google's first 100 results at the end of the analyzed period.

    keyword:ranked_keywords
  • Unranked keywords

    Number of keywords that were not found in Google's first 100 results at the end of the analyzed period.

    keyword:unranked_keywords
  • Average position

    Average Google position of the ranked keywords at the end of the analyzed period. Keywords outside the first 100 results are not averaged.

    keyword:average_position
  • Keywords in the top 3

    Number of keywords ranking among Google's first three results at the end of the analyzed period.

    keyword:top_3
  • Keywords in the top 10

    Number of keywords ranking on Google's first page at the end of the analyzed period.

    keyword:top_10
  • Keywords in the top 20

    Number of keywords ranking among Google's first twenty results at the end of the analyzed period.

    keyword:top_20
  • Keywords in the top 50

    Number of keywords ranking among Google's first fifty results at the end of the analyzed period.

    keyword:top_50
  • Keywords in the top 100

    Number of keywords ranking among Google's first hundred results at the end of the analyzed period.

    keyword:top_100
  • Top 3 share

    Percentage of the tracked keywords ranking among Google's first three results at the end of the analyzed period.

    keyword:top_3_rate
  • First page share

    Percentage of the tracked keywords ranking on Google's first page at the end of the analyzed period.

    keyword:top_10_rate
  • Ranked share

    Percentage of the tracked keywords found in Google's first 100 results at the end of the analyzed period.

    keyword:top_100_rate
  • Keywords that improved

    Number of keywords that climbed the ranking between the first and the last day of the analyzed period, including those that entered the first 100 results.

    keyword:improved_keywords
  • Keywords that declined

    Number of keywords that lost positions between the first and the last day of the analyzed period, including those that left the first 100 results.

    keyword:declined_keywords
  • Keywords that held position

    Number of keywords that ended the analyzed period in the same position they started.

    keyword:unchanged_keywords
  • Average position change

    Average number of positions gained during the analyzed period. A positive value means the keywords climbed the ranking.

    keyword:average_position_change
  • Total search volume

    Sum of the monthly search volume of every tracked keyword.

    keyword:total_search_volume
  • Average search volume

    Average monthly search volume of the tracked keywords.

    keyword:average_search_volume
  • Average CPC

    Average cost per click Google Ads reports for the tracked keywords.

    keyword:average_cpc
  • Featured snippets

    Number of keywords for which the tracked domain holds Google's featured snippet.

    keyword:featured_snippets
  • Keywords in the local pack

    Number of keywords for which the tracked domain appears in Google's local results.

    keyword:local_pack
  • Share of voice

    Share of the estimated clicks of the tracked keywords that goes to the project's domain, compared with every domain ranking for them.

    keyword:share_of_voice

Charts

4 metrics

  • Average position over time

    Evolution of the average Google position of the tracked keywords during the analyzed period.

    keyword:average_position_over_time
  • Ranking evolution

    Evolution of how many keywords rank in the top 3, on the first page and within the first 100 results.

    keyword:rankings_over_time
  • Position distribution

    How the tracked keywords are spread across the ranking bands at the end of the analyzed period.

    keyword:position_distribution
  • Keywords by device

    How the tracked keywords are split between desktop and mobile tracking.

    keyword:keywords_by_device

Tables

8 metrics

  • Keyword rankings

    Position of each tracked keyword at the end of the analyzed period, with the change accumulated during the period and the page that ranks.

    keyword:keywords
  • Keyword details

    Ranking history and competitiveness of each tracked keyword.

    keyword:keywords_detailed
  • Keyword performance in Search Console

    Clicks, impressions and click-through rate of each keyword. Only available when Search Console is connected inside Keyword.com.

    keyword:keywords_search_console
  • Rankings by tag

    Performance of each group of keywords tagged inside Keyword.com.

    keyword:keywords_by_tag
  • Rankings by page

    Pages of the tracked domain that rank for the most keywords during the analyzed period.

    keyword:keywords_by_landing_page
  • Rankings by search engine

    Performance of the tracked keywords in each Google regional domain being monitored.

    keyword:keywords_by_search_engine
  • Rankings by search intent

    Performance of the tracked keywords grouped by the intent Keyword.com attributes to each search.

    keyword:keywords_by_intent
  • Share of voice by domain

    Domains disputing the tracked keywords, ranked by the share of estimated clicks each one takes.

    keyword:competitors

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.