Keyword reports
Jump to Get Keyword MetricsGet Keyword Metrics
Price: 20 API units per request
Returns metrics from the latest snapshot available for the specified month.
Jump to EndpointEndpoint
Query parameters
keywordRequired
Keyword to get metrics for. Length must be between 1 and 255 characters.
Example: seo tools
Value/Type: string
countryRequired
Two-letter country code (ISO 3166-1 alpha-2) for which the metrics are returned.
Supported values: AF, AL, DZ, AO, AR, AM, AU, AT, AZ, BS, BH, BD, BY, BE, BZ, BO, BA, BW, BR, BN, BG, KH, CM, CA, CV, CL, CO, CR, HR, CY, CZ, CD, DK, DO, EC, EG, SV, EE, ET, FI, FR, GE, DE, GH, GR, GT, GY, HT, HN, HK, HU, IS, IN, ID, IE, IL, IT, JM, JP, JO, KZ, KW, LV, LB, LY, LT, LU, MG, MY, MT, MU, MX, MD, MN, ME, MA, MZ, NA, NP, NL, NZ, NI, NG, NO, OM, PK, PA, PY, PE, PH, PL, PT, QA, RO, RU, SA, SN, RS, SG, SK, SI, ZA, KR, ES, LK, SE, CH, TW, TH, TT, TN, TR, UA, AE, UK, US, UY, VE, VN, ZM, ZW.
Example: US
Value/Type: string
month
Monthly snapshot for which the data is returned. Format: YYYY-MM. Minimum: 2012-01. Maximum: the current month.
Default: the current month.
Example: 2024-01
Value/Type: string
format
Response format. Supported values: json (default), csv.
Value/Type: string
Response Parameters
meta
Response metadata describing the request context.
Value/Type: object
country
Country code that was used to compute the metrics.
Example: US
Value/Type: string
keyword
Keyword that was analyzed.
Value/Type: string
month
Monthly snapshot the metrics correspond to, in YYYY-MM format.
Value/Type: string
request_id
Unique identifier of the request. You will need it when contacting Semrush Customer Support.
Value/Type: string
status_code
HTTP status code of the response.
Value/Type: integer
success
Specifies if the request was processed successfully (true).
Value/Type: boolean
data
SEO and PPC metrics for the keyword.
Value/Type: object
competitive_density
Competition level of advertisers bidding on the analyzed keyword within their PPC campaigns. Ranges from 0 to 100, where 100 indicates the highest level of competition. May be NULL if the metric has not been calculated for the keyword.
Value/Type: integer
cpc
Average price, in USD cents, that advertisers pay for a click on an ad triggered by the analyzed keyword. May be NULL if the metric has not been calculated for the keyword.
Value/Type: string
intents
Search intents associated with the keyword.
Possible values: INFORMATIONAL, NAVIGATIONAL, COMMERCIAL, TRANSACTIONAL.
Value/Type: string[]
keyword_difficulty
Measure of how difficult it is to rank organically in the Googleâs top 10 results for the analyzed keyword. May be NULL if the difficulty score has not been calculated for the keyword.
Value/Type: integer
number_of_results
Number of URLs displayed in organic search results for the keyword. May be NULL if data is unavailable for the keyword.
Value/Type: string
search_volume
Average number of monthly searches for the keyword over the past 12 months. May be NULL if the metric has not been calculated for the keyword.
Value/Type: string
serp_features
All SERP features triggered by the keyword.
Possible values: INSTANT_ANSWER, KNOWLEDGE_PANEL, CAROUSEL, LOCAL_PACK, TOP_STORIES, IMAGE_PACK, SITELINKS, REVIEWS, TWEET, VIDEO, FEATURED_VIDEO, FEATURED_SNIPPET, AMP, IMAGE, ADS_TOP, ADS_BOTTOM, SHOPPING_ADS, HOTELS_PACK, JOBS_SEARCH, FEATURED_IMAGES, VIDEO_CAROUSEL, PEOPLE_ALSO_ASK, FAQ, FLIGHTS, FIND_RESULTS_ON, RECIPES, RELATED_TOPICS, TWITTER_CAROUSEL, INDENTED, NEWS, ADDRESS_PACK, APPLICATION, EVENTS, POPULAR_PRODUCTS, RELATED_PRODUCTS, RELATED_SEARCHES, SEE_RESULTS_ABOUT, SHORT_VIDEOS, WEB_STORIES, APPLICATION_LIST, BUYING_GUIDE, ORGANIC_CAROUSEL, THINGS_TO_KNOW, DATASETS, DISCUSSIONS_AND_FORUMS, EXPLORE_BRANDS, QUESTIONS_AND_ANSWERS, POPULAR_STORES, REFINE, PEOPLE_ALSO_SEARCH, ADS_MIDDLE, AI_OVERVIEW.
Value/Type: string[]
trends
Monthly search interest over the last 12 months. Each value is an integer from 0 to 100 indicating search volume relative to the peak month within this 12-month period, where 100 indicates the highest search interest. Useful for identifying seasonality, predictable spikes, and interest trends.
Value/Type: integer[]
curl -H 'Authorization: Apikey YOUR_API_KEY' "https://api.semrush.com/apis/v4/keywords/v1/metrics?keyword=seo%20tools&country=US&month=2024-01"{
"meta": {
"country": "US",
"keyword": "seo tools",
"month": "2024-01",
"request_id": "4fb1773ec2a8d61a0407f464599f897c",
"status_code": 200,
"success": true
},
"data": {
"competitive_density": 78,
"cpc": "1245",
"intents": ["COMMERCIAL", "INFORMATIONAL"],
"keyword_difficulty": 74,
"number_of_results": "1850000000",
"search_volume": "60500",
"serp_features": ["SITELINKS", "PEOPLE_ALSO_ASK", "AI_OVERVIEW", "RELATED_SEARCHES"],
"trends": [82, 78, 85, 90, 88, 92, 95, 100, 96, 91, 87, 84]
}
}competitive_density;cpc;intents;keyword_difficulty;number_of_results;search_volume;serp_features;trends
78;1245;COMMERCIAL,INFORMATIONAL;74;1850000000;60500;SITELINKS,PEOPLE_ALSO_ASK,AI_OVERVIEW,RELATED_SEARCHES;82,78,85,90,88,92,95,100,96,91,87,84Last updated: July 15, 2026