---
updatedAt: 2025-11-07T23:55:47.000Z
agentTools:
projectIndex: https://developers.similarweb.com/llms.txt
---
# Keywords Overview
Provides an overview of keyword or keyword list performance, offering insights such as search volume, click distribution, competition metrics, and other key indicators.
Device
Granularity
Metrics
desktop, mobile, or total
Monthly or last 28 days
Keyword,\
Volume,\
Clicks,\
Zero Clicks,\
SERP Composition,\
Organic Difficulty,\
Paid Competition,\
Intent,\
CPC range,\
Total Spent
To retrieve 'Last 28 days' data, remove the start\_date & end\_date parameters.
> 📘 Price
>
> **17 data credits** per keyword or keyword group.
> 👍 How to find your Keyword List ID
>
> * Insert your API key into the following endpoint, then use the JSON result: "response" > "keyword\_groups" > "id" to retrieve the keyword groups created or shared in your account.\
> .\
> To retrieve only the Keyword Lists created by your user, add the parameter "\&userOnlyGroups=true".
> * Visit an existing keyword list on the Similarweb platform and extract the ID (e.g. 5dd82db8-3ec5-462c-9699-5aa37a1b71de) from the URL (e.g.
> ❗️ Currently, this endpoint only supports a single month of data. Hence, start\_date and end\_date must be equal
## Now also available via Batch API
You can now retrieve this data via our Batch API to streamline large-scale data access and reduce complexity.
### Benefits
* Get bulk results in a single CSV file
* Automate delivery to: AWS S3, Google Cloud Storage, Snowflake
* Easily integrate into your data pipeline
* Schedule and track report generation
* Reduce the number of individual API calls
### Limitations
* Supported granularities: daily, monthly
* Up to 100 keywords per request
### Need help?
See our [Batch API starter guide](https://developers.similarweb.com/docs/set-up-your-batch-api) or check out the [Batch API Reference](https://developers.similarweb.com/reference/request-report) to get started and discover more features.
{`
`}
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "organic-keyword-analysis",
"version": "4.0"
},
"servers": [
{
"url": "https://api.similarweb.com/v4/keywords/"
}
],
"security": [
{}
],
"paths": {
"/{keyword}/analysis/overview": {
"get": {
"summary": "Keywords Overview",
"description": "Provides an overview of keyword or keyword list performance, offering insights such as search volume, click distribution, competition metrics, and other key indicators.",
"operationId": "keywords-overview",
"parameters": [
{
"name": "keyword",
"in": "path",
"description": "Enter a keyword of interest or a keyword list by ID, without brackets {}. Keyword list ids should be prefixed with '*'.",
"schema": {
"type": "string",
"default": "nike"
},
"required": true
},
{
"name": "api_key",
"in": "query",
"description": "Your Similarweb API key.",
"schema": {
"type": "string",
"default": "Add_Your_API_KEY"
}
},
{
"name": "start_date",
"in": "query",
"description": "[optional] Start date (format: YYYY-MM), Starting from 2023-01 (28 days of data returned if start_date and end_date are not given)",
"schema": {
"type": "string",
"default": "2023-01"
}
},
{
"name": "end_date",
"in": "query",
"description": "[optional] End date (format: YYYY-MM), Starting from 2023-01 (28 days of data returned if start_date and end_date are not given)",
"schema": {
"type": "string",
"default": "2023-01"
}
},
{
"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.",
"schema": {
"type": "string",
"default": "us"
}
},
{
"name": "web_source",
"in": "query",
"description": "[optional] Sets the web source type (supports: Desktop, Mobile Web, Total). Default (if not given) is Total",
"schema": {
"type": "string",
"default": "Total"
}
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"data\": {\n \"volume\": 560860,\n \"volume_change\": 0.915800188552925,\n \"clicks\": 412151.92759394,\n \"clicks_change\": 1.16505041342492,\n \"zero_clicks_searches\": 0.3837,\n \"zero_clicks_searches_change\": -0.223436551305404,\n \"serp_composition\": {\n \"classic_organic\": 0.536153923641112,\n \"organic_serp_features\": 0.00625927583728069,\n \"text_ads\": 0.390261412209136,\n \"pla\": 0.067325388312471\n },\n \"organic_difficulty\": 89,\n \"paid_competition\": 100,\n \"primary_intent\": \"transactional\",\n \"cpc_range\": {\n \"low_bid\": 1.8,\n \"high_bid\": 4.38\n },\n \"total_spent\": {\n \"min\": 317992.439587291,\n \"max\": 773781.60299574\n }\n },\n \"meta\": {\n \"request\": {\n \"web_source\": \"Desktop\",\n \"is_keyword_group\": false,\n \"country\": \"us\",\n \"keyword\": \"iphone\",\n \"format\": \"json\",\n \"start_date\": \"2024-09-01\",\n \"end_date\": \"2024-09-01\"\n },\n \"status\": \"Success\",\n \"last_updated\": \"2024-10-31\"\n }\n}"
}
},
"schema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"volume": {
"type": "integer",
"example": 560860,
"default": 0
},
"volume_change": {
"type": "number",
"example": 0.915800188552925,
"default": 0
},
"clicks": {
"type": "number",
"example": 412151.92759394,
"default": 0
},
"clicks_change": {
"type": "number",
"example": 1.16505041342492,
"default": 0
},
"zero_clicks_searches": {
"type": "number",
"example": 0.3837,
"default": 0
},
"zero_clicks_searches_change": {
"type": "number",
"example": -0.223436551305404,
"default": 0
},
"serp_composition": {
"type": "object",
"properties": {
"classic_organic": {
"type": "number",
"example": 0.536153923641112,
"default": 0
},
"organic_serp_features": {
"type": "number",
"example": 0.00625927583728069,
"default": 0
},
"text_ads": {
"type": "number",
"example": 0.390261412209136,
"default": 0
},
"pla": {
"type": "number",
"example": 0.067325388312471,
"default": 0
}
}
},
"organic_difficulty": {
"type": "integer",
"example": 89,
"default": 0
},
"paid_competition": {
"type": "integer",
"example": 100,
"default": 0
},
"primary_intent": {
"type": "string",
"example": "transactional"
},
"cpc_range": {
"type": "object",
"properties": {
"low_bid": {
"type": "number",
"example": 1.8,
"default": 0
},
"high_bid": {
"type": "number",
"example": 4.38,
"default": 0
}
}
},
"total_spent": {
"type": "object",
"properties": {
"min": {
"type": "number",
"example": 317992.439587291,
"default": 0
},
"max": {
"type": "number",
"example": 773781.60299574,
"default": 0
}
}
}
}
},
"meta": {
"type": "object",
"properties": {
"request": {
"type": "object",
"properties": {
"web_source": {
"type": "string",
"example": "Desktop"
},
"is_keyword_group": {
"type": "boolean",
"example": false,
"default": true
},
"country": {
"type": "string",
"example": "us"
},
"keyword": {
"type": "string",
"example": "iphone"
},
"format": {
"type": "string",
"example": "json"
},
"start_date": {
"type": "string",
"example": "2024-09-01"
},
"end_date": {
"type": "string",
"example": "2024-09-01"
}
}
},
"status": {
"type": "string",
"example": "Success"
},
"last_updated": {
"type": "string",
"example": "2024-10-31"
}
}
}
}
}
}
}
},
"400": {
"description": "400",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{}"
}
},
"schema": {
"type": "object",
"properties": {}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```