Keyword Research
You are reading the Data API docs (api.seranking.com)
.
- Keys are not interchangeable.
Project
key: 253a73adxxxxxxxxxxxxxx340aa0a939 (40-char hex)
Data
key: 80cfee7d-xxxx-xxxx-xxxx-fc8500816bb3 (UUID format) - Get your keys in your account: Project API dashboard | Data API dashboard
Questions or 401 errors? Email [email protected] and we will help.
Export Keywords Metrics
This method allows users to 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: export
Parameter | Location | Data Type | Mandatory | Default Value | 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 |
POST Request
The request should be made as a POST request with parameters sent as form data. 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: export
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 | Data 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, …} |
Sample Request: export
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"'
Sample Response: export
[
{
"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
This method allows users to retrieve a list of keywords that are semantically similar to a given seed keyword within a specified regional database. Semantically similar keywords include synonyms, close variations, or different phrasings of the same core intent.
It returns metrics like search volume, CPC, competition, keyword difficulty, search intent, and optional historical search volume trends for each suggested keyword.
Request Parameters: similar
Parameter | Location | Data Type | Mandatory | Default Value | 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 |
GET Request
The request should be made as a GET request with all parameters included in the query string.
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: similar
If successful, the server returns a JSON object containing the total count of available similar keywords and an array of keyword objects.
Parameter | Data 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 | Data 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, …} |
Sample Request: similar
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' \
--header 'Authorization: Token YOUR_API_KEY'
Sample Response: similar
{
"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
This method allows users to retrieve a list of keywords that are topically related to a given seed keyword within a specified regional database. Topically related keywords are based on having a high degree of overlapping URLs in their search results.
It returns metrics like search volume, CPC, competition, keyword difficulty, search intent, relevance score, and optional historical search volume trends for each suggested keyword.
Request Parameters: related
Parameter | Location | Data Type | Mandatory | Default Value | 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 |
GET Request
The request should be made as a GET request with all parameters included in the query string.
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: related
If successful, the server returns a JSON object containing the total count of available related keywords and an array of keyword objects.
Parameter | Data 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 | Data 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, …} |
Sample Request: related
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' \
--header 'Authorization: Token YOUR_API_KEY'
Sample Response: related
{
"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
This method allows users to retrieve a list of keywords phrased as common user questions related to a given seed keyword within a specified regional database.
It returns metrics like search volume, CPC, competition, keyword difficulty, search intent, and optional historical search volume trends for each suggested keyword.
Request Parameters: questions
Parameter | Location | Data Type | Mandatory | Default Value | 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 |
GET Request
The request should be made as a GET request with all parameters included in the query string.
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: questions
If successful, the server returns a JSON object containing the total count of available question keywords and an array of keyword objects.
Parameter | Data 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 | Data 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, …} |
Sample Request: questions
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'
Sample Response: questions
{
"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
This method allows users to retrieve a list of long-tail keywords related to a given seed keyword within a specified regional database. Long-tail keywords have a lower search volume, often indicating more specific user intent and less competition.
Request Parameters: longtail
Parameter | Location | Data Type | Mandatory | Default Value | 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 |
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 |
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 |
GET Request
The request should be made as a GET request with all parameters included in the query string.
curl --location --globoff 'https://api.seranking.com/v1/keywords/longtail?source=us&keyword=avocado&limit=10&offset=0&sort=keyword&sort_order=asc&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: longtail
If successful, the server returns a JSON object containing the total count of available longtail keywords and an array of keyword strings.
Parameter | Data 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 |
Sample Request: longtail
curl --location --globoff 'https://api.seranking.com/v1/keywords/longtail?source=us&keyword=avocado&limit=10&offset=0&sort=keyword&sort_order=asc&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'
Sample Response: longtail
{
"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"
]
}