API
Keyword research
The Keyword Research API allows you to retrieve keyword metrics, such as search volume, CPC, competition, and difficulty, as well as discover similar, related, question, and long-tail keywords. Endpoints support both single-keyword and bulk requests for keyword analysis.
Export keyword metrics
POST
https://api.seranking.com/v1/keywords/export
Cost: 100 credits per request
Retrieve various data points for a list of specified keywords within a given regional database. It’s designed for bulk analysis and returns metrics like search volume, CPC, competition, keyword difficulty, and historical search volume trends for each submitted keyword.
Request parameters
| Parameter | Location | Type | Required | Default | Description | Acceptable values | Example |
|---|---|---|---|---|---|---|---|
| source | query | string | Yes | N/A | Alpha-2 country code of the regional keyword database. | See Regional Database Codes. | us |
| keywords[] | form-data | string | Yes | N/A | For a single keyword, use one keywords[] parameter. | seo ranking | |
| keywords[] | form-data | string | No | N/A | Repeat the keywords[] to analyze multiple keywords. A maximum of 5,000 keywords can be submitted per call. | seo competitors | |
| sort | form-data | string | No | cpc | The field by which the returned list of keywords should be sorted. Common sortable fields include volume, cpc, difficulty, competition. | volume, cpc, difficulty, competition, history_trend | cpc |
| sort_order | form-data | string | No | desc | The order of sorting for the sort field. | asc: ascending desc: descending | desc |
| cols | form-data | string | No | keyword, volume, cpc, competition, difficulty, history_trend | A comma-separated list of specific response parameter names to include in the output for each keyword. If omitted, all available data points are returned. | keyword, volume, cpc, competition, difficulty, history_trend | keyword, volume, difficulty |
Request example
NOTE: The source parameter should be included as a query parameter in the endpoint URL.
curl -X POST 'https://api.seranking.com/v1/keywords/export?source=us' \
-H 'Authorization: Token YOUR_API_KEY' \
--form 'keywords[]="seo platform"' \
--form 'keywords[]="seranking.com"' \
--form 'sort="cpc"' \
--form 'sort_order="desc"' \
--form 'cols="keyword,volume,cpc,competition,difficulty,history_trend"'
Response parameters
If successful, the server returns a JSON array. Each object in this array corresponds to one of the keywords submitted in the request and contains the requested data points.
| Parameter | Type | Description | Example |
|---|---|---|---|
| is_data_found | boolean | Indicates whether data was successfully found and retrieved for this specific keyword. true if found, false otherwise. | TRUE |
| keyword | string | The keyword phrase itself, as submitted in the request. | “seranking.com” |
| volume | integer | The average monthly search volume for this keyword in the specified source database. | 10 |
| cpc | float | The average Cost Per Click (CPC) for this keyword. | 0 |
| competition | string or float | A score or indicator of the level of competition for this keyword (e.g., on a 0-1 or 0-100 scale). Example shows string. | “0.00” |
| difficulty | integer | A score representing the keyword’s ranking difficulty (often on a 0-100 scale), indicating how hard it is to rank organically for it. | 90 |
| history_trend | object | An object containing historical search volume data for the keyword. Each key is a “YYYY-MM-DD” string representing the first day of a month, and the value is the search volume for that month. | {“2024-06-01”: 30, “2024-07-01”: 50, …} |
Response example
[
{
"is_data_found": true,
"keyword": "seo platform",
"volume": 160,
"cpc": 3.87,
"competition": 0.06,
"difficulty": 31,
"history_trend": {
"2024-06-01": 70,
"2024-07-01": 70,
"2024-08-01": 80,
"2024-09-01": 140,
"2024-10-01": 140,
"2024-11-01": 140,
"2024-12-01": 110,
"2025-01-01": 160,
"2025-02-01": 200,
"2025-03-01": 240,
"2025-04-01": 240,
"2025-05-01": 300
}
},
{
"is_data_found": true,
"keyword": "seranking.com",
"volume": 480,
"cpc": 2,
"competition": 0.01,
"difficulty": 16,
"history_trend": {
"2024-06-01": 30,
"2024-07-01": 50,
"2024-08-01": 40,
"2024-09-01": 70,
"2024-10-01": 20,
"2024-11-01": 30,
"2024-12-01": 40,
"2025-01-01": 260,
"2025-02-01": 1300,
"2025-03-01": 1600,
"2025-04-01": 1300,
"2025-05-01": 880
}
}
]
Get similar keywords
GET
https://api.seranking.com/v1/keywords/similar
Cost: 10 credits per returned keyword
Retrieve keywords similar to a specified seed keyword within a regional database. Semantically similar keywords include synonyms, close variations, or different phrasings with the same intent. The method returns metrics such as search volume, CPC, competition, keyword difficulty, search intent, and historical trends.
Request parameters
| Parameter | Location | Type | Required | Default | Description | Acceptable values | Example |
|---|---|---|---|---|---|---|---|
| source | query | string | Yes | n/a | Alpha-2 country code of the regional keyword database. | See Regional Database Codes. | us |
| keyword | query | string | Yes | n/a | The seed keyword for which to find similar keywords. | avocado | |
| limit | query | integer | No | 100 | Maximum number of keywords to return per page. | Positive integers. | 10 |
| offset | query | integer | No | 0 | Starting offset for pagination. | Non-negative integers. | 0 |
| sort | query | string | No | n/a | The field by which the returned list of keywords should be sorted. | keyword, volume, cpc, difficulty, competition | keyword |
| sort_order | query | string | No | desc | The order of sorting for the sort field. | asc: ascending desc: descending | asc |
| history_trend | query | boolean | No | FALSE | Whether to include historical search volume trend data in the response. | true, false | TRUE |
| filter[volume][from] | query | integer | No | n/a | Minimum monthly search volume. | Non-negative integers. | 50 |
| filter[volume][to] | query | integer | No | n/a | Maximum monthly search volume. | Non-negative integers. | 5000 |
| filter[difficulty][from] | query | integer | No | n/a | Minimum keyword difficulty score (0-100). | Integers from 0 to 100. | 18 |
| filter[difficulty][to] | query | integer | No | n/a | Maximum keyword difficulty score (0-100). | Integers from 0 to 100. | 40 |
| filter[cpc][from] | query | float | No | n/a | Minimum Cost Per Click. | Non-negative floats. | 0.1 |
| filter[cpc][to] | query | float | No | n/a | Maximum Cost Per Click. | Non-negative floats. | 3 |
| filter[competition][from] | query | float | No | n/a | Minimum competition score (0.0-1.0). | Floats from 0.0 to 1.0. | 0.2 |
| filter[competition][to] | query | float | No | n/a | Maximum competition score (0.0-1.0). | Floats from 0.0 to 1.0. | 0.7 |
| filter[keyword_count][from] | query | integer | No | n/a | Minimum number of words in the keyword. | Positive integers. | 3 |
| filter[keyword_count][to] | query | integer | No | n/a | Maximum number of words in the keyword. | Positive integers. | 5 |
| filter[characters_count][from] | query | integer | No | n/a | Minimum character length of the keyword. | Positive integers. | 20 |
| filter[characters_count][to] | query | integer | No | n/a | Maximum character length of the keyword. | Positive integers. | 50 |
| filter[serp_features] | query | string | No | n/a | Comma-separated list of SERP features to filter by. | See SERP Features. | sge,images,top_stories |
Request example
curl --location 'https://api.seranking.com/v1/keywords/similar?source=us&keyword=avocado&limit=10&offset=0&sort=keyword&sort_order=asc&history_trend=true&filter[volume][from]=50&filter[volume][to]=5000&filter[difficulty][from]=18&filter[difficulty][to]=40&filter[cpc][from]=0.10&filter[cpc][to]=3.00&filter[competition][from]=0.2&filter[competition][to]=0.7&filter[keyword_count][from]=3&filter[keyword_count][to]=5&filter[characters_count][from]=20&filter[characters_count][to]=50&filter[serp_features]=featured_snippets,images' \
--header 'Authorization: Token YOUR_API_KEY'
Response parameters
If successful, the server returns a JSON object containing the total count of available similar keywords and an array of keyword objects.
| Parameter | Type | Description | Example |
|---|---|---|---|
| total | integer | The total number of similar keywords matching the criteria (ignoring limit and offset). | 35 |
| keywords | array | An array of objects, each representing a similar keyword with its metrics. | See below |
Each object in the keywords array includes:
| Parameter | Type | Description | Example |
|---|---|---|---|
| keyword | string | The similar keyword phrase. | “can you cook with avocado oil” |
| volume | integer | The average monthly search volume for this keyword in the specified source database. | 480 |
| cpc | float | The average Cost Per Click (CPC) for this keyword. | 1.20 |
| difficulty | integer | A score representing the keyword’s ranking difficulty (0-100). | 6 |
| competition | float | A score indicating the level of competition for this keyword (0.0-1.0). | 0.4 |
| intents | array | An array of search intent codes: I (Informational), N (Navigational), C (Commercial), L (Local). | [“I”] |
| serp_features | array | An array of SERP features associated with the keyword. | [“featured_snippets”, “videos”] |
| history_trend | object | If requested via history_trend=true, an object with historical search volume data. Each key is a “YYYY-MM-DD” string (first day of the month), and the value is the search volume for that month. Can be null if data is not available. | {“2024-05-01”: 400, “2024-06-01”: 450, …} |
Response example
{
"total": 35,
"keywords": [
{
"keyword": "can you cook with avocado oil",
"volume": 480,
"cpc": 1.20,
"difficulty": 6,
"competition": 0.4,
"intents": ["I"],
"serp_features": ["featured_snippets", "videos"],
"history_trend": {
"2024-05-01": 400,
"2024-06-01": 450,
"2024-07-01": 480,
"2024-08-01": 500,
"2024-09-01": 520,
"2024-10-01": 480,
"2024-11-01": 460,
"2024-12-01": 440,
"2025-01-01": 500,
"2025-02-01": 550,
"2025-03-01": 600,
"2025-04-01": 0
}
},
{
"keyword": "avocado recipes",
"volume": 1000,
"cpc": 0.80,
"difficulty": 12,
"competition": 0.3,
"intents": ["I"],
"serp_features": ["recipes", "images"],
"history_trend": {
"2024-05-01": 900,
"2024-06-01": 950,
"2024-07-01": 1000,
"2024-08-01": 1050,
"2024-09-01": 1100,
"2024-10-01": 1000,
"2024-11-01": 950,
"2024-12-01": 900,
"2025-01-01": 1050,
"2025-02-01": 1100,
"2025-03-01": 1200,
"2025-04-01": 0
}
}
]
}
Get related keywords
GET
https://api.seranking.com/v1/keywords/related
Cost: 10 credits per returned keyword
Retrieve keywords that are topically related to a specified seed keyword within a regional database. Topically related keywords are based on having a high degree of overlapping URLs in their search results. The method returns metrics such as search volume, CPC, competition, keyword difficulty, search intent, relevance score, and optional historical search volume trends.
Request parameters
| Parameter | Location | Type | Required | Default | Description | Acceptable values | Example |
|---|---|---|---|---|---|---|---|
| source | query | string | Yes | n/a | Alpha-2 country code of the regional keyword database. | See Regional Database Codes. | us |
| keyword | query | string | Yes | n/a | The seed keyword for which to find related keywords. | avocado | |
| limit | query | integer | No | 100 | Maximum number of keywords to return per page. | Positive integers. | 10 |
| offset | query | integer | No | 0 | Starting offset for pagination. | Non-negative integers. | 0 |
| sort | query | string | No | n/a | The field by which the returned list of keywords should be sorted. | keyword, volume, cpc, difficulty, competition | keyword |
| sort_order | query | string | No | desc | The order of sorting for the sort field. | asc: ascending desc: descending | asc |
| history_trend | query | boolean | No | FALSE | Whether to include historical search volume trend data in the response. | true, false | TRUE |
| filter[volume][from] | query | integer | No | n/a | Minimum monthly search volume. | Non-negative integers. | 50 |
| filter[volume][to] | query | integer | No | n/a | Maximum monthly search volume. | Non-negative integers. | 5000 |
| filter[difficulty][from] | query | integer | No | n/a | Minimum keyword difficulty score (0-100). | Integers from 0 to 100. | 18 |
| filter[difficulty][to] | query | integer | No | n/a | Maximum keyword difficulty score (0-100). | Integers from 0 to 100. | 40 |
| filter[cpc][from] | query | float | No | n/a | Minimum Cost Per Click. | Non-negative floats. | 0.1 |
| filter[cpc][to] | query | float | No | n/a | Maximum Cost Per Click. | Non-negative floats. | 3 |
| filter[competition][from] | query | float | No | n/a | Minimum competition score (0.0-1.0). | Floats from 0.0 to 1.0. | 0.2 |
| filter[competition][to] | query | float | No | n/a | Maximum competition score (0.0-1.0). | Floats from 0.0 to 1.0. | 0.7 |
| filter[keyword_count][from] | query | integer | No | n/a | Minimum number of words in the keyword. | Positive integers. | 3 |
| filter[keyword_count][to] | query | integer | No | n/a | Maximum number of words in the keyword. | Positive integers. | 5 |
| filter[characters_count][from] | query | integer | No | n/a | Minimum character length of the keyword. | Positive integers. | 20 |
| filter[characters_count][to] | query | integer | No | n/a | Maximum character length of the keyword. | Positive integers. | 50 |
| filter[serp_features] | query | string | No | n/a | Comma-separated list of SERP features to filter by. | See SERP Features. | sge,images,top_stories |
Request example
curl --location 'https://api.seranking.com/v1/keywords/related?source=us&keyword=avocado&limit=10&offset=0&sort=keyword&sort_order=asc&history_trend=true&filter[volume][from]=50&filter[volume][to]=5000&filter[difficulty][from]=18&filter[difficulty][to]=40&filter[cpc][from]=0.10&filter[cpc][to]=3.00&filter[competition][from]=0.2&filter[competition][to]=0.7&filter[keyword_count][from]=3&filter[keyword_count][to]=5&filter[characters_count][from]=20&filter[characters_count][to]=50&filter[serp_features]=featured_snippets,images' \
--header 'Authorization: Token YOUR_API_KEY'
Response parameters
If successful, the server returns a JSON object containing the total count of available related keywords and an array of keyword objects.
| Parameter | Type | Description | Example |
|---|---|---|---|
| total | integer | The total number of related keywords matching the criteria (ignoring limit and offset). | 35 |
| keywords | array | An array of objects, each representing a related keyword with its metrics. | See below |
Each object in the keywords array includes:
| Parameter | Type | Description | Example |
|---|---|---|---|
| keyword | string | The related keyword phrase. | “avocado anbauen deutschland” |
| volume | integer | The average monthly search volume for this keyword in the specified source database. | 480 |
| cpc | float | The average Cost Per Click (CPC) for this keyword. | 1.20 |
| difficulty | integer | A score representing the keyword’s ranking difficulty (0-100). | 6 |
| competition | float | A score indicating the level of competition for this keyword (0.0-1.0). | 0.4 |
| intents | array | An array of search intent codes: I (Informational), N (Navigational), C (Commercial), L (Local). | [“I”] |
| serp_features | array | An array of SERP features associated with the keyword. | [“featured_snippets”, “videos”] |
| history_trend | object | If requested via history_trend=true, an object with historical search volume data. Each key is a “YYYY-MM-DD” string (first day of the month), and the value is the search volume for that month. Can be null if data is not available. | {“2024-05-01”: 400, “2024-06-01”: 450, …} |
Response example
{
"total": 21,
"keywords": [
{
"keyword": "avocado anbauen deutschland",
"cpc": 0,
"difficulty": 9,
"volume": 140,
"competition": 0.06,
"serp_features": [
"images",
"sge",
"related_searches"
],
"relevance": 6,
"intents": [
"I"
],
"history_trend": {
"2024-06-01": 140,
"2024-07-01": 170,
"2024-08-01": 140,
"2024-09-01": 140,
"2024-10-01": 110,
"2024-11-01": 90,
"2024-12-01": 110,
"2025-01-01": 170,
"2025-02-01": 140,
"2025-03-01": 260,
"2025-04-01": 140,
"2025-05-01": 170
}
},
{
"keyword": "avocado baum deutschland",
"cpc": 0,
"difficulty": 9,
"volume": 110,
"competition": 0.09,
"serp_features": [
"featured_snippets",
"reviews",
"images",
"sge",
"related_searches"
],
"relevance": 6,
"intents": [
"I"
],
"history_trend": {
"2024-06-01": 90,
"2024-07-01": 110,
"2024-08-01": 110,
"2024-09-01": 110,
"2024-10-01": 110,
"2024-11-01": 90,
"2024-12-01": 90,
"2025-01-01": 70,
"2025-02-01": 110,
"2025-03-01": 170,
"2025-04-01": 140,
"2025-05-01": 140
}
}
]
}
Get question keywords
GET
https://api.seranking.com/v1/keywords/questions
Cost: 10 credits per returned keyword
Retrieve keywords phrased as common user questions related to a specified seed keyword within a regional database. The method returns metrics such as search volume, CPC, competition, keyword difficulty, search intent, and optional historical search volume trends.
Request parameters
| Parameter | Location | Type | Required | Default | Description | Acceptable values | Example |
|---|---|---|---|---|---|---|---|
| source | query | string | Yes | n/a | Alpha-2 country code of the regional keyword database. | See Regional Database Codes. | us |
| keyword | query | string | Yes | n/a | The seed keyword for which to find question keywords. | avocado | |
| limit | query | integer | No | 100 | Maximum number of keywords to return per page. | Positive integers. | 10 |
| offset | query | integer | No | 0 | Starting offset for pagination. | Non-negative integers. | 0 |
| sort | query | string | No | n/a | The field by which the returned list of keywords should be sorted. | keyword, volume, cpc, difficulty, competition | keyword |
| sort_order | query | string | No | desc | The order of sorting for the sort field. | asc: ascending desc: descending | asc |
| history_trend | query | boolean | No | FALSE | Whether to include historical search volume trend data in the response. | true, false | TRUE |
| filter[volume][from] | query | integer | No | n/a | Minimum monthly search volume. | Non-negative integers. | 50 |
| filter[volume][to] | query | integer | No | n/a | Maximum monthly search volume. | Non-negative integers. | 5000 |
| filter[difficulty][from] | query | integer | No | n/a | Minimum keyword difficulty score (0-100). | Integers from 0 to 100. | 18 |
| filter[difficulty][to] | query | integer | No | n/a | Maximum keyword difficulty score (0-100). | Integers from 0 to 100. | 40 |
| filter[cpc][from] | query | float | No | n/a | Minimum Cost Per Click. | Non-negative floats. | 0.1 |
| filter[cpc][to] | query | float | No | n/a | Maximum Cost Per Click. | Non-negative floats. | 3 |
| filter[competition][from] | query | float | No | n/a | Minimum competition score (0.0-1.0). | Floats from 0.0 to 1.0. | 0.2 |
| filter[competition][to] | query | float | No | n/a | Maximum competition score (0.0-1.0). | Floats from 0.0 to 1.0. | 0.7 |
| filter[keyword_count][from] | query | integer | No | n/a | Minimum number of words in the keyword. | Positive integers. | 3 |
| filter[keyword_count][to] | query | integer | No | n/a | Maximum number of words in the keyword. | Positive integers. | 5 |
| filter[characters_count][from] | query | integer | No | n/a | Minimum character length of the keyword. | Positive integers. | 20 |
| filter[characters_count][to] | query | integer | No | n/a | Maximum character length of the keyword. | Positive integers. | 50 |
| filter[serp_features] | query | string | No | n/a | Comma-separated list of SERP features to filter by. | See SERP Features. | sge,images,top_stories |
Request example
curl --location --globoff 'https://api.seranking.com/v1/keywords/questions?source=us&keyword=avocado&limit=10&offset=0&sort=keyword&sort_order=asc&history_trend=true&filter[volume][from]=100&filter[volume][to]=100000&filter[difficulty][from]=0&filter[difficulty][to]=30&filter[cpc][from]=0&filter[cpc][to]=100&filter[competition][from]=0&filter[competition][to]=0.1&filter[keyword_count][from]=3&filter[keyword_count][to]=8&filter[characters_count][from]=15&filter[characters_count][to]=50&filter[serp_features]=sge%2Cimages' \
--header 'Authorization: Token YOUR_API_KEY'
Response parameters
If successful, the server returns a JSON object containing the total count of available question keywords and an array of keyword objects.
| Parameter | Type | Description | Example |
|---|---|---|---|
| total | integer | The total number of question keywords matching the criteria (ignoring limit and offset). | 3 |
| keywords | array | An array of objects, each representing a question keyword with its metrics. | See below |
Each object in the keywords array includes:
| Parameter | Type | Description | Example |
|---|---|---|---|
| keyword | string | The question keyword phrase. | “für welche organe sind avocados gut” |
| volume | integer | The average monthly search volume for this keyword in the specified source database. | 480 |
| cpc | float | The average Cost Per Click (CPC) for this keyword. | 1.20 |
| difficulty | integer | A score representing the keyword’s ranking difficulty (0-100). | 6 |
| competition | float | A score indicating the level of competition for this keyword (0.0-1.0). | 0.4 |
| intents | array | An array of search intent codes: I (Informational), N (Navigational), C (Commercial), L (Local). | [“I”] |
| serp_features | array | An array of SERP features associated with the keyword. | [“featured_snippets”, “videos”] |
| history_trend | object | If requested via history_trend=true, an object with historical search volume data. Each key is a “YYYY-MM-DD” string (first day of the month), and the value is the search volume for that month. Can be null if data is not available. | {“2024-05-01”: 400, “2024-06-01”: 450, …} |
Response example
{
"total": 3,
"keywords": [
{
"keyword": "für welche organe sind avocados gut",
"cpc": 0,
"difficulty": 11,
"volume": 140,
"competition": 0,
"serp_features": [
"images",
"sge",
"related_searches"
],
"intents": [
"I"
],
"history_trend": null
},
{
"keyword": "how are avocados grown",
"cpc": 0,
"difficulty": 24,
"volume": 110,
"competition": 0.03,
"serp_features": [
"featured_snippets",
"reviews",
"images",
"related_searches"
],
"intents": [
"I"
],
"history_trend": {
"2024-06-01": 140,
"2024-07-01": 140,
"2024-08-01": 110,
"2024-09-01": 90,
"2024-10-01": 140,
"2024-11-01": 90,
"2024-12-01": 70,
"2025-01-01": 110,
"2025-02-01": 90,
"2025-03-01": 110,
"2025-04-01": 90,
"2025-05-01": 140
}
},
{
"keyword": "how to ripen avocados fast",
"cpc": 0,
"difficulty": 19,
"volume": 170,
"competition": 0.01,
"serp_features": [
"featured_snippets",
"people_also_ask",
"sge",
"related_searches"
],
"intents": [
"I"
],
"history_trend": {
"2024-06-01": 210,
"2024-07-01": 170,
"2024-08-01": 140,
"2024-09-01": 110,
"2024-10-01": 170,
"2024-11-01": 170,
"2024-12-01": 140,
"2025-01-01": 210,
"2025-02-01": 140,
"2025-03-01": 140,
"2025-04-01": 210,
"2025-05-01": 210
}
}
]
}
Get longtail keywords
GET
https://api.seranking.com/v1/keywords/longtail
Cost: 10 credits per returned keyword
Retrieve long-tail keywords related to a specified seed keyword within a regional database. Long-tail keywords have a lower search volume, often indicating more specific user intent and less competition.
Request parameters
| Parameter | Location | Type | Required | Default | Description | Acceptable values | Example |
|---|---|---|---|---|---|---|---|
| source | query | string | Yes | n/a | Alpha-2 country code of the regional keyword database. | See Regional Database Codes. | us |
| keyword | query | string | Yes | n/a | The seed keyword for which to find longtail keywords. | avocado | |
| limit | query | integer | No | 100 | Maximum number of keywords to return per page. | Positive integers. | 10 |
| offset | query | integer | No | 0 | Starting offset for pagination. | Non-negative integers. | 0 |
Request example
curl --location --globoff 'https://api.seranking.com/v1/keywords/longtail?source=us&keyword=avocado&limit=10&offset=0' \
--header 'Authorization: Token YOUR_API_KEY'
Response parameters
If successful, the server returns a JSON object containing the total count of available longtail keywords and an array of keyword strings.
| Parameter | Type | Description | Example |
|---|---|---|---|
| total | integer | The total number of longtail keywords matching the criteria (ignoring limit and offset). | 35 |
| keywords | array | An array of longtail keyword strings. | See below |
Response example
{
"total": 40717,
"keywords": [
"1 1/2 oz avocado",
"1 1/2 oz of avocado",
"1 2 medium avocado protein",
"1 8 avocado calories",
"1 avocado brownies",
"1 avocado dip recipe",
"1 avocado eiweiß",
"1 avocado fett",
"1 avocado gewicht ohne kern",
"1 avocado guacamole calories"
]
}
