Keyword Analysis provides a deep-dive into any keyword on the web to discover the competitive landscape for any search term.
Keyword Analysis measures actual traffic generated by a particular keyword to a particular site from any search engine - not just a snapshot of the keyword position on the results page. In addition, it includes information on CPC, volume, website position, and landing pages related to the SERP.
When generating a report, make sure all metrics are supported by same granularity as the requested report.
Data credits are Similarweb's currency. Keywords are calculated as 1:25 (data credit:result) and for site_keywords the calculation is 1:100.
As pricing may vary from report to report you can estimate the total credit amount for each report generated by our Request-Validate endpoint.
Batch API and REST API have different Keys
Make sure you're using the correct API Key with the query
Example Request:
POST https://api.similarweb.com/v3/batch/request-report
{
"domains":[
"cnn.com"
],
"countries": ["IL","US"],
"metrics":[
"all_keyword_volume",
"all_keyword_monthly_search_volume",
"all_keyword_cpc",
"desktop_keyword_difficulty",
"zero_clicks_share",
"zero_clicks_latest_serp_date"
],
"start_date": "2022-12-01",
"end_date": "2023-01-01",
"limit":1000,
"granularity": "monthly",
"delivery_method": "download_link",
"response_format": "csv"
}
POST https://api.similarweb.com/v3/batch/request-report
{
"domains":[
"cnn.com"
],
"countries": ["IL","US"],
"metrics":[
"desktop_keywords_organic_visits",
"desktop_keywords_organic_share",
"desktop_keywords_top_organic_url",
"desktop_keywords_top_organic_url_position"
],
"start_date": "2022-12-01",
"end_date": "2023-01-01",
"granularity": "7days",
"delivery_method": "download_link",
"response_format": "csv"
}
Keywords Table
Table URL: https://api.similarweb.com/v3/batch/keywords/request-report
Primary Keys: domains, keywords, countries
| Metric Name | Description | Supported Granularity | Type |
|---|---|---|---|
| all_keyword_volume | Average number of searches performed for this keyword. | Monthly | Double |
| all_keyword_cpc | Provides the CPC for the the keyword (desktop+mobile). CPC is the average price that advertisers paid for a click on their ad in Google’s paid search results | Monthly | Double |
| desktop_keyword_difficulty | Provides the measure of how difficult it would be to rank on the top results for a keyword. Range of 1-100 | Monthly | Double |
| zero_clicks_share | Provides the percentage of searches that are zero-clicks. | Monthly | Double |
| zero_clicks_latest_serp_date | Provides the data for the latest SERP search. | Monthly | Date |
Keyword CPC with historical data is a unique data point that is available on the API but no on the platform
Site_Keywords Table:
Table URL: https://api.similarweb.com/v3/batch/site_keywords/request-report
Primary Keys: domains, keywords, countries
| Metric Name | Description | Supported Granularity | Type |
|---|---|---|---|
| desktop_keywords_total_visits, desktop_keywords_organic_visits, desktop_keywords_paid_visits | Returns the total/organic/paid number of visits driven to a website by clicks on the keyword | 7days, weekly | Double |
| desktop_keywords_total_share, desktop_keywords_organic_share, desktop_keywords_paid_share | Returns the total/organic/paid traffic share driven to a website by a specific keyword | 7days, weekly | Double |
| desktop_keywords_top_all_url, desktop_keywords_top_organic_url, desktop_keywords_top_paid_url | Most recent URL displayed in all/paid/organic Google search results, in the selected country, from the past 30 days. | 7days, weekly | String |
| desktop_keywords_top_all_url_position, desktop_keywords_top_organic_url_position, desktop_keywords_top_paid_url_position | The URL's average overall/paid/organic position on the Google SERP in the selected timeframe | 7days, weekly | Int |