API
Keyword Research
Keyword Research API provides programmatic access to keyword metrics and discovery. Data is refreshed on a monthly basis.
Using the API, you can:
- retrieve keyword metrics such as search volume, CPC, competition, difficulty, and historical trends
- discover similar keywords with the same user intent
- find related keywords based on overlapping search results
- get question keywords associated with a seed keyword
- discover long-tail keywords that are lower-volume and more specific
Get Keyword Metrics (Bulk)
POST https://api.seranking.com/v1/keywords/export
Cost: 100 credits per request
Retrieves 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, search intent, and historical search volume trends for each submitted keyword.
By default, the returned history_trend covers the 12 most recent months, ending at the current month. Use the optional history_to parameter to end the window at an earlier month, and history_from to start it later — together they return a custom date range (e.g. to reconstruct a keyword’s seasonality as of a past date). The window is always capped at 12 months.
Request
Send source in the query string and all other inputs in a JSON request body (Content-Type: application/json).
Note: The
source parameter must be provided as a query parameter in the endpoint URL.Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
source | String | Yes | — | Country code of the regional keyword database (e.g., us). For acceptable values, see Regional database codes. |
Body parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
keywords | String[] | Yes | — | Array of keywords to analyze, e.g. ["seo platform", "seranking.com"]. Between 1 and 5,000 keywords per request. |
sort | String | No | cpc | Field the results are sorted by: volume, cpc, difficulty, or competition. |
sort_order | String | No | desc | Sorting order: asc (ascending) or desc (descending). |
history_from | String | No | — | Start month of the history_trend window, YYYY-MM-DD (the day is ignored). Only takes effect together with history_to — sent on its own it is ignored. The window then runs from history_from through history_to inclusive, capped at the most recent 12 months. Must not be later than history_to. |
history_to | String | No | Current month | End month of the history_trend window, YYYY-MM-DD (the day is ignored). On its own it returns the 12 months ending at this month — e.g. 2024-05-01 returns 2023-06-01 through 2024-05-01. Combine with history_from for a shorter range. Must not be a future month. |
Request example
curl -X POST 'https://api.seranking.com/v1/keywords/export?source=us' \
-H 'Authorization: Token YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"keywords": ["seo platform", "seranking.com"],
"sort": "cpc",
"sort_order": "desc"
}'
Request example — custom history window
curl -X POST 'https://api.seranking.com/v1/keywords/export?source=us' \
-H 'Authorization: Token YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"keywords": ["seo platform"],
"history_from": "2024-01-01",
"history_to": "2024-05-01"
}'
Omit history_from to get the full 12 months ending at history_to.
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 (found) / false (otherwise). |
keyword | String | Keyword phrase 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 | Float | Paid-search competition level for this keyword, on a 0–1 scale (higher = more competition). |
difficulty | Integer | Keyword difficulty — how hard it is to rank organically for this keyword, on a 0–100 scale (higher = harder). |
intents | Array | Array of search 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). |
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. By default the window covers the 12 months ending at the current month; it is shifted by history_to and narrowed by history_from (see Request). |
Response example
[
{
"is_data_found": true,
"keyword": "seo platform",
"volume": 160,
"cpc": 3.87,
"competition": 0.06,
"difficulty": 31,
"intents": ["C", "I"],
"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,
"intents": ["C", "I"],
"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
Retrieves 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). For acceptable values, see Regional database codes. |
| keyword | String | Yes | N/A | Seed keyword used 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 by which keywords are sorted: • keyword • volume• cpc• difficulty• competition |
| sort_order | String | No | desc | Sorting order: • asc – ascending• desc – descending |
| history_trend | Boolean | No | FALSE | Indicates whether to include historical search volume trend data in the response: • 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 results (e.g., sge, images, top_stories). For acceptable values, see SERP features. |
| filter[intents] | String | No | N/A | Comma-separated list of intent codes: • I – informational• N – navigational• T – transactional• C – commercial• L – local |
| 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 has the following structure:
| 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, the 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
Retrieves 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 used 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 by which keywords are sorted: • keyword• volume• cpc• difficulty• competition |
| sort_order | String | No | desc | Sorting order: • asc – ascending• desc – descending |
| history_trend | Boolean | No | FALSE | Indicates whether to include historical search volume trend data in the response: • 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 results (e.g., sge, images, top_stories). For acceptable values, see SERP features. |
| filter[intents] | String | No | N/A | Comma-separated list of intent codes: • I – informational• N – navigational• T – transactional• C – commercial• L – local |
| 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 has the following structure:
| 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, the 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
Retrieves 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). For acceptable values, see Regional database codes. |
| keyword | String | Yes | N/A | Seed keyword to retrieve question-style 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 by which keywords are sorted: • keyword• volume• cpc• difficulty• competition |
| sort_order | String | No | desc | Sorting order: • asc – ascending• desc – descending |
| history_trend | Boolean | No | FALSE | Indicates whether to include historical search volume trend data in the response: • 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 results (e.g., sge, images, top_stories). For acceptable values, see SERP features. |
| filter[intents] | String | No | N/A | Comma-separated list of intent codes: • I – informational• N – navigational• T – transactional• C – commercial• L – local |
| 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 has the following structure:
| 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, the 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: 1 credit per returned keyword
Retrieves 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). For acceptable values, see Regional database codes. |
| keyword | String | Yes | N/A | Seed keyword used 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"
]
}
