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 |
|---|---|---|---|---|---|
| source | query | String | Yes | N/A | Country code of the regional keyword database (e.g., us, uk).For acceptable values, see Regional database codes. |
| keywords[] | form-data | String | Yes | N/A | Keyword input. When sending only one keyword, include one keywords[] parameter. |
| keywords[] | form-data | String | No | N/A | Keyword input. Repeat the keywords[] parameter to submit multiple keywords (up to 5,000 per request). |
| sort | form-data | String | No | cpc | Field used to sort the returned list of keywords. Common sortable fields: – volume– cpc– difficulty– competition |
| sort_order | form-data | String | No | desc | Sorting order for the sort field. Possible values: – asc: ascending– desc: descending |
| cols | form-data | String | No | keyword, volume, cpc, competition, difficulty, history_trend | Comma-separated list of specific response parameter names to include in the output for each keyword: – keyword – volume– cpc– difficulty– competition– history_trend If omitted, all available data points are returned. |
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 |
|---|---|---|
| is_data_found | Boolean | Indicates whether data was successfully found and retrieved for this specific keyword:true – if foundfalse – otherwise |
| keyword | String | Keyword phrase itself, as submitted in the request. |
| volume | Integer | Average monthly search volume for this keyword in the specified source database. |
| cpc | Float | Average Cost Per Click for this keyword. |
| competition | String/Float | Score or indicator of the level of competition for this keyword (e.g., on a 0-1 or 0-100 scale). Example shows a string. |
| difficulty | Integer | Score or indicator of the level of competition for this keyword (e.g., on a 0-1 or 0-100 scale). The example shows a string. |
| history_trend | Object | 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. |
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 | Type | Required | Default | Description |
|---|---|---|---|---|
| source | String | Yes | N/A | Country code of the regional keyword database (e.g., us, uk).For acceptable values, see Regional database codes. |
| keyword | String | Yes | N/A | Seed keyword for which to find similar keywords (e.g., avocado). |
| limit | Integer | No | 100 | Maximum number of keywords to return per page (e.g., 10). Positive integer. |
| offset | Integer | No | 0 | Starting offset for pagination (e.g., 0). Non-negative integer. |
| sort | String | No | N/A | Field used to sort the returned list of keywords. Possible values: – keyword – volume– cpc– difficulty– competition |
| sort_order | String | No | desc | Sorting order for the sort field. Possible values: – asc: ascending – desc: descending |
| history_trend | Boolean | No | FALSE | Indicates whether to include historical search volume trend data in the response. Possible values: – true– false |
| filter[volume][from] | Integer | No | N/A | Minimum monthly search volume (e.g., 50). Non-negative integer. |
| filter[volume][to] | Integer | No | N/A | Maximum monthly search volume (e.g., 5000). Non-negative integer. |
| filter[difficulty][from] | Integer | No | N/A | Minimum keyword difficulty score. Integers from 0 to 100. |
| filter[difficulty][to] | Integer | No | N/A | Maximum keyword difficulty score. Integers from 0 to 100. |
| filter[cpc][from] | Float | No | N/A | Minimum Cost Per Click (e.g., 0.1). Non-negative float. |
| filter[cpc][to] | Float | No | n/a | Maximum Cost Per Click (e.g., 3). Non-negative float. |
| filter[competition][from] | Float | No | N/A | Minimum competition score (e.g., 0.2). Floats from 0.0 to 1.0. |
| filter[competition][to] | Float | No | n/a | Maximum competition score (e.g., 0.7). Floats from 0.0 to 1.0. |
| filter[keyword_count][from] | Integer | No | N/A | Minimum number of words in the keyword (e.g., 3). Positive integer. |
| filter[keyword_count][to] | Integer | No | n/a | Maximum number of words in the keyword (e.g., 5). Positive integer. |
| filter[characters_count][from] | Integer | No | N/A | Minimum character length of the keyword (e.g., 20). Positive integer. |
| filter[characters_count][to] | Integer | No | N/A | Maximum character length of the keyword (e.g., 50). Positive integer. |
| filter[serp_features] | String | No | N/A | Comma-separated list of SERP features to filter by (e.g., sge, images, top_stories).For acceptable values, see SERP features. |
| filter[intents] | String | No | N/A | Comma-separated list of intent codes. Possible values:I – Informational (user is looking for information)C – Commercial (user is investigating products, services, or brands)T – Transactional (user wants to complete an action or purchase)L – Local (user is looking for a location or something nearby)N – Navigational (user is looking for a specific website or page) |
| filter[multi_keyword_included] | Array | No | N/A | Keywords to include based on specific patterns. Each element is an array of objects with "type" (begins, contains, ends, exact) and "value" (string to match). |
| filter[multi_keyword_excluded] | Array | No | N/A | Keywords to exclude based on specific patterns. Each element is an array of objects with "type" (begins, contains, ends, exact) and "value" (string to match). |
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&filter[intents]=I,C&filter[multi_keyword_included]=[[{"type":"contains","value":"oil"}],[{"type":"exact","value":"avocado recipes"}]]' \
--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 |
|---|---|---|
| total | Integer | Total number of similar keywords matching the criteria (ignoring limit and offset). |
| keywords | Array | Array of objects, each representing a similar keyword with its metrics. |
Each object in the keywords array includes:
| Parameter | Type | Description |
|---|---|---|
| keyword | String | Similar keyword phrase. |
| volume | Integer | Average monthly search volume for this keyword in the specified source database. |
| cpc | Float | Average Cost Per Click for this keyword. |
| difficulty | Integer | Score indicating the keyword’s ranking difficulty (0-100). |
| competition | Float | Score indicating the level of competition for this keyword (0.0-1.0). |
| intents | Array | Array of search intent codes. |
| serp_features | Array | Array of SERP features associated with the keyword. |
| history_trend | Object | If history_trend=true is included in the request, this object contains the historical search volume for the keyword.– Each key is a date string in YYYY-MM-DD format (the first day of the month).– Each value is the search volume for that month. – Can be null if historical data is unavailable. |
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", "C"],
"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 | Type | Required | Default | Description |
|---|---|---|---|---|
| source | String | Yes | N/A | Country code of the regional keyword database (e.g., us, uk).For acceptable values, see Regional database codes. |
| keyword | String | Yes | N/A | Seed keyword for which to find related keywords (e.g., avocado). |
| limit | Integer | No | 100 | Maximum number of keywords to return per page (e.g., 10). Positive integer. |
| offset | Integer | No | 0 | Starting offset for pagination (e.g., 0). Non-negative integer. |
| sort | String | No | N/A | Field used to sort the returned list of keywords. Possible values: – keyword– volume– cpc– difficulty– competition |
| sort_order | String | No | desc | Sorting order for the sort field. Possible values: – asc: ascending– desc: descending |
| history_trend | Boolean | No | FALSE | Indicates whether to include historical search volume trend data in the response. Possible values: – true– false |
| filter[volume][from] | Integer | No | N/A | Minimum monthly search volume (e.g., 50). Non-negative integer. |
| filter[volume][to] | Integer | No | N/A | Maximum monthly search volume (e.g., 5000). Non-negative integer. |
| filter[difficulty][from] | Integer | No | N/A | Minimum keyword difficulty score. Integers from 0 to 100. |
| filter[difficulty][to] | Integer | No | N/A | Maximum keyword difficulty score. Integers from 0 to 100. |
| filter[cpc][from] | Float | No | N/A | Minimum Cost Per Click (e.g., 0.1). Non-negative float. |
| filter[cpc][to] | Float | No | N/A | Maximum Cost Per Click (e.g., 3). Non-negative float. |
| filter[competition][from] | Float | No | N/A | Minimum competition score (e.g., 0.2). Floats from 0.0 to 1.0. |
| filter[competition][to] | Float | No | N/A | Maximum competition score (e.g., 0.7). Floats from 0.0 to 1.0. |
| filter[keyword_count][from] | Integer | No | N/A | Minimum number of words in the keyword (e.g., 3). Positive integer. |
| filter[keyword_count][to] | Integer | No | N/A | Maximum number of words in the keyword (e.g., 5). Positive integer. |
| filter[characters_count][from] | Integer | No | N/A | Minimum character length of the keyword (e.g., 20). Positive integer. |
| filter[characters_count][to] | Integer | No | N/A | Maximum character length of the keyword (e.g., 50). Positive integer. |
| filter[serp_features] | String | No | N/A | Comma-separated list of SERP features to filter by (e.g., sge, images, top_stories).For acceptable values, see SERP features. |
| filter[intents] | String | No | N/A | Comma-separated list of intent codes. Possible values:I – Informational (user is looking for information)C – Commercial (user is investigating products, services, or brands)T – Transactional (user wants to complete an action or purchase)L – Local (user is looking for a location or something nearby)N – Navigational (user is looking for a specific website or page) |
| filter[multi_keyword_included] | Array | No | N/A | Keywords to include based on specific patterns. Each element is an array of objects with "type" (begins, contains, ends, exact) and "value" (string to match). |
| filter[multi_keyword_excluded] | Array | No | N/A | Keywords to exclude based on specific patterns. Each element is an array of objects with "type" (begins, contains, ends, exact) and "value" (string to match). |
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&filter[intents]=I,C&filter[multi_keyword_included]=[[{"type":"contains","value":"oil"}],[{"type":"exact","value":"avocado recipes"}]]' \
--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 |
|---|---|---|
| total | Integer | Total number of related keywords matching the criteria (ignoring limit and offset). |
| keywords | Array | Array of objects, each representing a related keyword with its metrics. |
Each object in the keywords array includes:
| Parameter | Type | Description |
|---|---|---|
| keyword | String | Related keyword phrase. |
| volume | Integer | Average monthly search volume for this keyword in the specified source database. |
| cpc | Float | Average Cost Per Click for this keyword. |
| difficulty | Integer | Score indicating the keyword’s ranking difficulty (0-100). |
| competition | Float | Score indicating the level of competition for this keyword (0.0-1.0). |
| serp_features | Array | Array of SERP features associated with the keyword. |
| relevance | Integer | Relevance score of the returned keyword in relation to the queried keyword. |
| intents | Array | Array of search intent codes. |
| history_trend | Object | If history_trend=true is included in the request, this object contains the historical search volume for the keyword.– Each key is a date string in YYYY-MM-DD format (the first day of the month).– Each value is the search volume for that month. – Can be null if historical data is unavailable. |
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 | Type | Required | Default | Description |
|---|---|---|---|---|
| source | String | Yes | N/A | Country code of the regional keyword database (e.g., us, uk).For acceptable values, see Regional database codes. |
| keyword | String | Yes | N/A | Seed keyword for which to find question keywords (e.g., avocado). |
| limit | Integer | No | 100 | Maximum number of keywords to return per page (e.g., 10). Positive integer. |
| offset | Integer | No | 0 | Starting offset for pagination (e.g., 0). Non-negative integer. |
| sort | String | No | N/A | Field used to sort the returned list of keywords. Possible values: – keyword– volume– cpc– difficulty– competition |
| sort_order | String | No | desc | Sorting order for the sort field. Possible values: – asc: ascending– desc: descending |
| history_trend | Boolean | No | FALSE | Indicates whether to include historical search volume trend data in the response. Possible values: – true– false |
| filter[volume][from] | Integer | No | N/A | Minimum monthly search volume (e.g., 50). Non-negative integer. |
| filter[volume][to] | Integer | No | N/A | Maximum monthly search volume (e.g., 5000). Non-negative integer. |
| filter[difficulty][from] | Integer | No | N/A | Minimum keyword difficulty score. Integers from 0 to 100. |
| filter[difficulty][to] | Integer | No | N/A | Maximum keyword difficulty. Integers from 0 to 100. |
| filter[cpc][from] | Float | No | n/a | Minimum Cost Per Click (e.g., 0.1). Non-negative float. |
| filter[cpc][to] | Float | No | N/A | Maximum Cost Per Click (e.g., 3). Non-negative float. |
| filter[competition][from] | Float | No | N/A | Minimum competition score (e.g., 0.2). Floats from 0.0 to 1.0. |
| filter[competition][to] | Float | No | N/A | Maximum competition score (e.g., 0.7). Floats from 0.0 to 1.0. |
| filter[keyword_count][from] | Integer | No | N/A | Minimum number of words in the keyword (e.g., 3). Positive integer. |
| filter[keyword_count][to] | Integer | No | N/A | Maximum number of words in the keyword (e.g., 5). Positive integer. |
| filter[characters_count][from] | Integer | No | N/A | Minimum character length of the keyword (e.g., 20). Positive integer. |
| filter[characters_count][to] | Integer | No | N/A | Maximum character length of the keyword (e.g., 50). Positive integer. |
| filter[serp_features] | String | No | N/A | Comma-separated list of SERP features to filter by (e.g., sge, images, top_stories).For acceptable values, see SERP features. |
| filter[intents] | String | No | N/A | Comma-separated list of intent codes. Possible values:I – Informational (user is looking for information)C – Commercial (user is investigating products, services, or brands)T – Transactional (user wants to complete an action or purchase)L – Local (user is looking for a location or something nearby)N – Navigational (user is looking for a specific website or page) |
| filter[multi_keyword_included] | Array | No | N/A | Keywords to include based on specific patterns. Each element is an array of objects with "type" (begins, contains, ends, exact) and "value" (string to match). |
| filter[multi_keyword_excluded] | Array | No | N/A | Keywords to exclude based on specific patterns. Each element is an array of objects with "type" (begins, contains, ends, exact) and "value" (string to match). |
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,images&filter[intents]=I,C&filter[multi_keyword_included]=[[{"type":"contains","value":"oil"}],[{"type":"exact","value":"avocado recipes"}]]' \
--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 |
|---|---|---|
| total | Integer | Total number of question keywords matching the criteria (ignoring limit and offset). |
| keywords | Array | Array of objects, each representing a question keyword with its metrics. |
Each object in the keywords array includes:
| Parameter | Type | Description |
|---|---|---|
| keyword | String | Question keyword phrase. |
| volume | Integer | Average monthly search volume for this keyword in the specified source database. |
| cpc | Float | Average Cost Per Click for this keyword. |
| difficulty | Integer | Score indicating the keyword’s ranking difficulty (0-100). |
| competition | Float | Score indicating the level of competition for this keyword (0.0-1.0). |
| serp_features | Array | Array of SERP features associated with the keyword. |
| intents | Array | Array of search intent codes. |
| history_trend | Object | If history_trend=true is included in the request, this object contains the historical search volume for the keyword.– Each key is a date string in YYYY-MM-DD format (the first day of the month).– Each value is the search volume for that month. – Can be null if historical data is unavailable. |
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 | Type | Required | Default | Description |
|---|---|---|---|---|
| source | String | Yes | N/A | Country code of the regional keyword database (e.g., us, uk).For acceptable values, see Regional database codes. |
| keyword | String | Yes | N/A | Seed keyword for which to find longtail keywords (e.g., avocado). |
| limit | Integer | No | 100 | Maximum number of keywords to return per page (e.g., 10). Positive integer. |
| offset | Integer | No | 0 | Starting offset for pagination (e.g., 0). Non-negative integer. |
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 |
|---|---|---|
| total | Integer | Total number of longtail keywords matching the criteria (ignoring limit and offset). |
| keywords | Array | Array of longtail keyword strings. |
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"
]
}
