--- updatedAt: 2025-11-07T23:55:49.000Z agentTools: projectIndex: https://developers.similarweb.com/llms.txt --- # Website Keywords Returns the keywords driving search clicks for a specified domain.
Device Granularity Metrics
desktop, mobile, or total Monthly or last 28 days keyword,\ clicks,\ traffic\_share,\ difficulty,\ competition,\ primary\_intent,\ secondary\_intent,\ volume,\ cpc,\ zero\_clicks\_share,\ position,\ serp\_features,\ top\_url
To retrieve 'Last 28 days' data, remove the start\_date & end\_date parameters. > 📘 Price > > **0.13 data credits** per keyword. > > The default number of results for this endpoint is 100, which means the credit cost by default will be **13 data credits**. > ❗️ Currently, this endpoint only supports a single month of data. Hence, start\_date and end\_date must be equal # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "keywords30", "version": "4.0" }, "servers": [ { "url": "https://api.similarweb.com/v4/website-analysis/" } ], "security": [ {} ], "paths": { "/keywords": { "get": { "summary": "Website Keywords", "description": "Returns the keywords driving search clicks for a specified domain.", "operationId": "website-analysis-keywords", "parameters": [ { "name": "api_key", "in": "query", "description": "Your Similarweb API key.", "required": true, "schema": { "type": "string", "default": "Add_Your_API_KEY" } }, { "name": "URL", "in": "query", "description": "Enter a domain of interest, without 'www.' or brackets {}.", "required": true, "schema": { "type": "string", "default": "cnn.com" } }, { "name": "start_date", "in": "query", "description": "Start month (format: YYYY-MM)", "schema": { "type": "string", "default": "2023-03" } }, { "name": "end_date", "in": "query", "description": "End month (format: YYYY-MM)", "schema": { "type": "string", "default": "2023-03" } }, { "name": "country", "in": "query", "description": "Country filter, as a 2-letter ISO country code, or \"world\" for worldwide. To see the country filters you have access to, please refer to the Check Capabilities endpoint.", "required": true, "schema": { "type": "string", "default": "us" } }, { "name": "traffic_source", "in": "query", "description": "[optional] Set the traffic source type. Possible values: Organic, Paid, or All.", "schema": { "type": "string", "default": "All" } }, { "name": "web_source", "in": "query", "description": "[optional] Select the web source. Possible values: Desktop, MobileWeb, or Total.", "schema": { "type": "string", "default": "Total" } }, { "name": "branded_type", "in": "query", "description": "[optional]: Select the branded type. Possible values: Branded, NonBranded, or All.", "schema": { "type": "string", "default": "All" } }, { "name": "limit", "in": "query", "description": "[optional] Select the number of results that are returned. Default: 100.", "schema": { "type": "string", "default": "100" } }, { "name": "offset", "in": "query", "description": "[optional] Specify an offset from where to start returning data.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "VIEW EXAMPLE RESPONSE": { "value": "{\n \"keywords\": [\n {\n \"keyword\": \"cnn\",\n \"clicks\": 6527609,\n \"traffic_share\": 0.20739891001023394,\n \"difficulty\": 95,\n \"competition\": null,\n \"primary_intent\": \"Navigational\",\n \"secondary_intent\": null,\n \"volume\": 7670020,\n \"cpc\": 1.42,\n \"cpc_low_bid\": 0.01,\n \"cpc_high_bid\": 0.27,\n \"zero_clicks_share\": 0.1498,\n \"position\": 1,\n \"serp_features\": [\n \"news\",\n \"video\",\n \"organic\",\n \"organic_sitelinks\",\n \"organic_expanded_sitelinks\",\n \"related_questions\"\n ],\n \"top_url\": \"cnn.com\"\n },\n {\n \"keyword\": \"weather\",\n \"clicks\": 1136378,\n \"traffic_share\": 0.03610564887688733,\n \"difficulty\": 99,\n \"competition\": 1,\n \"primary_intent\": \"Navigational\",\n \"secondary_intent\": null,\n \"volume\": 111557650,\n \"cpc\": 0.62,\n \"cpc_low_bid\": 0.03,\n \"cpc_high_bid\": 0.53,\n \"zero_clicks_share\": 0.8304,\n \"position\": 2,\n \"serp_features\": [\n \"news\",\n \"video\",\n \"organic\",\n \"organic_sitelinks\",\n \"organic_expanded_sitelinks\",\n \"related_questions\",\n \"organic_inline_sitelinks\"\n ],\n \"top_url\": \"cnn.com/weather\"\n },\n {\n \"keyword\": \"trump\",\n \"clicks\": 750832,\n \"traffic_share\": 0.023855861832533777,\n \"difficulty\": 99,\n \"competition\": null,\n \"primary_intent\": \"Informational\",\n \"secondary_intent\": null,\n \"volume\": 18826790,\n \"cpc\": 0,\n \"cpc_low_bid\": 0,\n \"cpc_high_bid\": 0,\n \"zero_clicks_share\": 0.6185,\n \"position\": 1,\n \"serp_features\": [\n \"news\",\n \"video\",\n \"organic\"\n ],\n \"top_url\": \"amp.cnn.com/cnn/2023/03/18/politics/donald-trump-manhattan-da-arrest-protests/index.html\"\n },\n {\n \"keyword\": \"nashville shooting\",\n \"clicks\": 515556,\n \"traffic_share\": 0.01638053879287748,\n \"difficulty\": null,\n \"competition\": null,\n \"primary_intent\": \"Informational\",\n \"secondary_intent\": \"Navigational\",\n \"volume\": 11347940,\n \"cpc\": 0,\n \"cpc_low_bid\": 0,\n \"cpc_high_bid\": 0,\n \"zero_clicks_share\": 0.4053,\n \"position\": 2,\n \"serp_features\": [\n \"news\",\n \"organic\"\n ],\n \"top_url\": \"amp.cnn.com/cnn/2023/03/29/us/covenant-school-shooting-nashville-tennessee-wednesday/index.html\"\n },\n {\n \"keyword\": \"cnn news\",\n \"clicks\": 490768,\n \"traffic_share\": 0.015592960342432044,\n \"difficulty\": 95,\n \"competition\": null,\n \"primary_intent\": \"Navigational\",\n \"secondary_intent\": null,\n \"volume\": 571720,\n \"cpc\": 0.65,\n \"cpc_low_bid\": 0.03,\n \"cpc_high_bid\": 1.87,\n \"zero_clicks_share\": 0.1431,\n \"position\": 1,\n \"serp_features\": [\n \"news\",\n \"video\",\n \"organic\",\n \"organic_sitelinks\",\n \"organic_expanded_sitelinks\",\n \"organic_inline_sitelinks\"\n ],\n \"top_url\": \"cnn.com\"\n },\n {\n \"keyword\": \"alex murdaugh\",\n \"clicks\": 432002,\n \"traffic_share\": 0.013725813528696508,\n \"difficulty\": 19,\n \"competition\": null,\n \"primary_intent\": \"Informational\",\n \"secondary_intent\": null,\n \"volume\": 4818190,\n \"cpc\": 0.17,\n \"cpc_low_bid\": 0.01,\n \"cpc_high_bid\": 3.25,\n \"zero_clicks_share\": 0.5657,\n \"position\": 1,\n \"serp_features\": [\n \"news\",\n \"video\",\n \"organic\",\n \"related_questions\",\n \"organic_inline_sitelinks\"\n ],\n \"top_url\": \"amp.cnn.com/cnn/2023/03/03/us/alex-murdaugh-sentencing-friday/index.html\"\n },\n {\n \"keyword\": \"ukraine news\",\n \"clicks\": 337799,\n \"traffic_share\": 0.010732742172906958,\n \"difficulty\": 98,\n \"competition\": 3,\n \"primary_intent\": \"Informational\",\n \"secondary_intent\": null,\n \"volume\": 1786460,\n \"cpc\": 1.49,\n \"cpc_low_bid\": 1.51,\n \"cpc_high_bid\": 3.04,\n \"zero_clicks_share\": 0.4331,\n \"position\": 1,\n \"serp_features\": [\n \"news\",\n \"video\",\n \"organic\",\n \"organic_sitelinks\",\n \"organic_expanded_sitelinks\",\n \"related_questions\",\n \"organic_inline_sitelinks\"\n ],\n \"top_url\": \"cnn.com/europe/live-news/russia-ukraine-war-news-03-21-23/index.html\"\n },\n {\n \"keyword\": \"chatgpt\",\n \"clicks\": 299962,\n \"traffic_share\": 0.009530563464277624,\n \"difficulty\": 80,\n \"competition\": 3,\n \"primary_intent\": \"Navigational\",\n \"secondary_intent\": null,\n \"volume\": 15088000,\n \"cpc\": 0.78,\n \"cpc_low_bid\": 0.34,\n \"cpc_high_bid\": 0.91,\n \"zero_clicks_share\": 0.1854,\n \"position\": 2,\n \"serp_features\": [\n \"news\",\n \"video\",\n \"organic\",\n \"organic_sitelinks\",\n \"organic_expanded_sitelinks\",\n \"related_questions\"\n ],\n \"top_url\": \"amp.cnn.com/cnn/2023/03/21/tech/google-bard/index.html\"\n },\n {\n \"keyword\": \"trump arrested\",\n \"clicks\": 298307,\n \"traffic_share\": 0.009477979861910058,\n \"difficulty\": null,\n \"competition\": null,\n \"primary_intent\": \"Informational\",\n \"secondary_intent\": null,\n \"volume\": 1970240,\n \"cpc\": 0,\n \"cpc_low_bid\": 0,\n \"cpc_high_bid\": 0,\n \"zero_clicks_share\": 0.6764,\n \"position\": 4,\n \"serp_features\": [\n \"news\",\n \"video\",\n \"organic\"\n ],\n \"top_url\": \"amp.cnn.com/cnn/2023/03/18/politics/donald-trump-manhattan-da-arrest-protests/index.html\"\n },\n {\n \"keyword\": \"ukraine\",\n \"clicks\": 281471,\n \"traffic_share\": 0.008943056883384185,\n \"difficulty\": 94,\n \"competition\": 1,\n \"primary_intent\": \"Informational\",\n \"secondary_intent\": null,\n \"volume\": 5042320,\n \"cpc\": 1.67,\n \"cpc_low_bid\": 1.17,\n \"cpc_high_bid\": 3.08,\n \"zero_clicks_share\": 0.6196,\n \"position\": 1,\n \"serp_features\": [\n \"news\",\n \"video\",\n \"organic\",\n \"twitter\",\n \"related_questions\",\n \"organic_inline_sitelinks\"\n ],\n \"top_url\": \"amp.cnn.com/cnn/europe/live-news/russia-ukraine-war-news-03-06-23/index.html\"\n }\n ],\n \"keywords_count\": 478711,\n \"meta\": {\n \"query\": {\n \"limit\": 10,\n \"offset\": 0,\n \"asc\": null,\n \"sort\": null\n },\n \"request\": {\n \"traffic_source\": \"All\",\n \"branded_type\": \"All\",\n \"web_source\": \"MobileWeb\",\n \"page_search_type\": \"Domain\",\n \"domain\": \"cnn.com\",\n \"format\": \"json\",\n \"start_date\": \"2023-03-01\",\n \"end_date\": \"2023-03-31\",\n \"country\": \"us\"\n },\n \"status\": \"Success\",\n \"last_updated\": \"2024-09-30\"\n }\n}" } }, "schema": { "type": "object", "properties": { "keywords": { "type": "array", "items": { "type": "object", "properties": { "keyword": { "type": "string", "example": "cnn" }, "clicks": { "type": "integer", "example": 6527609, "default": 0 }, "traffic_share": { "type": "number", "example": 0.20739891001023394, "default": 0 }, "difficulty": { "type": "integer", "example": 95, "default": 0 }, "competition": {}, "primary_intent": { "type": "string", "example": "Navigational" }, "secondary_intent": {}, "volume": { "type": "integer", "example": 7670020, "default": 0 }, "cpc": { "type": "number", "example": 1.42, "default": 0 }, "cpc_low_bid": { "type": "number", "example": 0.01, "default": 0 }, "cpc_high_bid": { "type": "number", "example": 0.27, "default": 0 }, "zero_clicks_share": { "type": "number", "example": 0.1498, "default": 0 }, "position": { "type": "integer", "example": 1, "default": 0 }, "serp_features": { "type": "array", "items": { "type": "string", "example": "news" } }, "top_url": { "type": "string", "example": "cnn.com" } } } }, "keywords_count": { "type": "integer", "example": 478711, "default": 0 }, "meta": { "type": "object", "properties": { "query": { "type": "object", "properties": { "limit": { "type": "integer", "example": 10, "default": 0 }, "offset": { "type": "integer", "example": 0, "default": 0 }, "asc": {}, "sort": {} } }, "request": { "type": "object", "properties": { "traffic_source": { "type": "string", "example": "All" }, "branded_type": { "type": "string", "example": "All" }, "web_source": { "type": "string", "example": "MobileWeb" }, "page_search_type": { "type": "string", "example": "Domain" }, "domain": { "type": "string", "example": "cnn.com" }, "format": { "type": "string", "example": "json" }, "start_date": { "type": "string", "example": "2023-03-01" }, "end_date": { "type": "string", "example": "2023-03-31" }, "country": { "type": "string", "example": "us" } } }, "status": { "type": "string", "example": "Success" }, "last_updated": { "type": "string", "example": "2024-09-30" } } } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```