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"
]
}
]
}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_keywordsRanked keywords
Number of keywords holding a position in Google's first 100 results at the end of the analyzed period.
keyword:ranked_keywordsUnranked keywords
Number of keywords that were not found in Google's first 100 results at the end of the analyzed period.
keyword:unranked_keywordsAverage 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_positionKeywords in the top 3
Number of keywords ranking among Google's first three results at the end of the analyzed period.
keyword:top_3Keywords in the top 10
Number of keywords ranking on Google's first page at the end of the analyzed period.
keyword:top_10Keywords in the top 20
Number of keywords ranking among Google's first twenty results at the end of the analyzed period.
keyword:top_20Keywords in the top 50
Number of keywords ranking among Google's first fifty results at the end of the analyzed period.
keyword:top_50Keywords in the top 100
Number of keywords ranking among Google's first hundred results at the end of the analyzed period.
keyword:top_100Top 3 share
Percentage of the tracked keywords ranking among Google's first three results at the end of the analyzed period.
keyword:top_3_rateFirst page share
Percentage of the tracked keywords ranking on Google's first page at the end of the analyzed period.
keyword:top_10_rateRanked share
Percentage of the tracked keywords found in Google's first 100 results at the end of the analyzed period.
keyword:top_100_rateKeywords 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_keywordsKeywords 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_keywordsKeywords that held position
Number of keywords that ended the analyzed period in the same position they started.
keyword:unchanged_keywordsAverage position change
Average number of positions gained during the analyzed period. A positive value means the keywords climbed the ranking.
keyword:average_position_changeTotal search volume
Sum of the monthly search volume of every tracked keyword.
keyword:total_search_volumeAverage search volume
Average monthly search volume of the tracked keywords.
keyword:average_search_volumeAverage CPC
Average cost per click Google Ads reports for the tracked keywords.
keyword:average_cpcFeatured snippets
Number of keywords for which the tracked domain holds Google's featured snippet.
keyword:featured_snippetsKeywords in the local pack
Number of keywords for which the tracked domain appears in Google's local results.
keyword:local_packShare 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_timeRanking evolution
Evolution of how many keywords rank in the top 3, on the first page and within the first 100 results.
keyword:rankings_over_timePosition distribution
How the tracked keywords are spread across the ranking bands at the end of the analyzed period.
keyword:position_distributionKeywords 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:keywordsKeyword details
Ranking history and competitiveness of each tracked keyword.
keyword:keywords_detailedKeyword 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_consoleRankings by tag
Performance of each group of keywords tagged inside Keyword.com.
keyword:keywords_by_tagRankings by page
Pages of the tracked domain that rank for the most keywords during the analyzed period.
keyword:keywords_by_landing_pageRankings by search engine
Performance of the tracked keywords in each Google regional domain being monitored.
keyword:keywords_by_search_engineRankings by search intent
Performance of the tracked keywords grouped by the intent Keyword.com attributes to each search.
keyword:keywords_by_intentShare 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.
