API Description

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

ParameterLocationData TypeMandatoryDefault ValueDescriptionAcceptable ValuesExample
sourcequerystringYesN/AAlpha-2 country code of the regional keyword database. See Regional Database Codes.us
keywords[]form-datastringYesN/AFor a single keyword, use one keywords[] parameter.seo ranking
keywords[]form-datastringNoN/ARepeat the keywords[] to analyze multiple keywords. A maximum of 5,000 keywords can be submitted per call.seo competitors
sortform-datastringNocpcThe field by which the returned list of keywords should be sorted. Common sortable fields include volume, cpc, difficulty, competition.volume, cpc, difficulty, competition, history_trendcpc
sort_orderform-datastringNodescThe order of sorting for the sort field.asc: ascending
desc: descending
desc
colsform-datastringNokeyword, volume, cpc, competition, difficulty, history_trendA 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_trendkeyword, 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.

Title of the code block
Copy
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.

ParameterData TypeDescriptionExample
is_data_foundbooleanIndicates whether data was successfully found and retrieved for this specific keyword. true if found, false otherwise.TRUE
keywordstringThe keyword phrase itself, as submitted in the request.“seranking.com”
volumeintegerThe average monthly search volume for this keyword in the specified source database.10
cpcfloatThe average Cost Per Click (CPC) for this keyword.0
competitionstring or floatA 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”
difficultyintegerA 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_trendobjectAn 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

Title of the code block
Copy
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

Title of the code block
Copy
[
{
"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

ParameterLocationData TypeMandatoryDefault ValueDescriptionAcceptable ValuesExample
sourcequerystringYesN/AAlpha-2 country code of the regional keyword database.See Regional Database Codes.us
keywordquerystringYesN/AThe seed keyword for which to find similar keywords.avocado
limitqueryintegerNo100Maximum number of keywords to return per page.Positive integers.10
offsetqueryintegerNo0Starting offset for pagination.Non-negative integers.0
sortquerystringNoN/AThe field by which the returned list of keywords should be sorted.keyword, volume, cpc, difficulty, competitionkeyword
sort_orderquerystringNodescThe order of sorting for the sort field.asc: ascending desc: descendingasc
history_trendquerybooleanNoFALSEWhether to include historical search volume trend data in the response.true, falseTRUE
filter[volume][from]queryintegerNoN/AMinimum monthly search volume.Non-negative integers.50
filter[volume][to]queryintegerNoN/AMaximum monthly search volume.Non-negative integers.5000
filter[difficulty][from]queryintegerNoN/AMinimum keyword difficulty score (0-100).Integers from 0 to 100.18
filter[difficulty][to]queryintegerNoN/AMaximum keyword difficulty score (0-100).Integers from 0 to 100.40
filter[cpc][from]queryfloatNoN/AMinimum Cost Per Click.Non-negative floats.0.1
filter[cpc][to]queryfloatNoN/AMaximum Cost Per Click.Non-negative floats.3
filter[competition][from]queryfloatNoN/AMinimum competition score (0.0-1.0).Floats from 0.0 to 1.0.0.2
filter[competition][to]queryfloatNoN/AMaximum competition score (0.0-1.0).Floats from 0.0 to 1.0.0.7
filter[keyword_count][from]queryintegerNoN/AMinimum number of words in the keyword.Positive integers.3
filter[keyword_count][to]queryintegerNoN/AMaximum number of words in the keyword.Positive integers.5
filter[characters_count][from]queryintegerNoN/AMinimum character length of the keyword.Positive integers.20
filter[characters_count][to]queryintegerNoN/AMaximum character length of the keyword.Positive integers.50
filter[serp_features]querystringNoN/AComma-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.

Title of the code block
Copy
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.

ParameterData TypeDescriptionExample
totalintegerThe total number of similar keywords matching the criteria (ignoring limit and offset).35
keywordsarrayAn array of objects, each representing a similar keyword with its metrics.See below

Each object in the keywords array includes:

ParameterData TypeDescriptionExample
keywordstringThe similar keyword phrase.“can you cook with avocado oil”
volumeintegerThe average monthly search volume for this keyword in the specified source database.480
cpcfloatThe average Cost Per Click (CPC) for this keyword.1.20
difficultyintegerA score representing the keyword’s ranking difficulty (0-100).6
competitionfloatA score indicating the level of competition for this keyword (0.0-1.0).0.4
intentsarrayAn array of search intent codes: I (Informational), N (Navigational), C (Commercial), L (Local).[“I”]
serp_featuresarrayAn array of SERP features associated with the keyword.[“featured_snippets”, “videos”]
history_trendobjectIf 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

Title of the code block
Copy
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

Title of the code block
Copy
{
"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
}
}
]
}

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

ParameterLocationData TypeMandatoryDefault ValueDescriptionAcceptable ValuesExample
sourcequerystringYesN/AAlpha-2 country code of the regional keyword database.See Regional Database Codes.us
keywordquerystringYesN/AThe seed keyword for which to find related keywords.avocado
limitqueryintegerNo100Maximum number of keywords to return per page.Positive integers.10
offsetqueryintegerNo0Starting offset for pagination.Non-negative integers.0
sortquerystringNoN/AThe field by which the returned list of keywords should be sorted.keyword, volume, cpc, difficulty, competitionkeyword
sort_orderquerystringNodescThe order of sorting for the sort field.asc: ascending desc: descendingasc
history_trendquerybooleanNoFALSEWhether to include historical search volume trend data in the response.true, falseTRUE
filter[volume][from]queryintegerNoN/AMinimum monthly search volume.Non-negative integers.50
filter[volume][to]queryintegerNoN/AMaximum monthly search volume.Non-negative integers.5000
filter[difficulty][from]queryintegerNoN/AMinimum keyword difficulty score (0-100).Integers from 0 to 100.18
filter[difficulty][to]queryintegerNoN/AMaximum keyword difficulty score (0-100).Integers from 0 to 100.40
filter[cpc][from]queryfloatNoN/AMinimum Cost Per Click.Non-negative floats.0.1
filter[cpc][to]queryfloatNoN/AMaximum Cost Per Click.Non-negative floats.3
filter[competition][from]queryfloatNoN/AMinimum competition score (0.0-1.0).Floats from 0.0 to 1.0.0.2
filter[competition][to]queryfloatNoN/AMaximum competition score (0.0-1.0).Floats from 0.0 to 1.0.0.7
filter[keyword_count][from]queryintegerNoN/AMinimum number of words in the keyword.Positive integers.3
filter[keyword_count][to]queryintegerNoN/AMaximum number of words in the keyword.Positive integers.5
filter[characters_count][from]queryintegerNoN/AMinimum character length of the keyword.Positive integers.20
filter[characters_count][to]queryintegerNoN/AMaximum character length of the keyword.Positive integers.50
filter[serp_features]querystringNoN/AComma-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.

Title of the code block
Copy
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.

ParameterData TypeDescriptionExample
totalintegerThe total number of related keywords matching the criteria (ignoring limit and offset).35
keywordsarrayAn array of objects, each representing a related keyword with its metrics.See below

Each object in the keywords array includes:

ParameterData TypeDescriptionExample
keywordstringThe related keyword phrase.“avocado anbauen deutschland”
volumeintegerThe average monthly search volume for this keyword in the specified source database.480
cpcfloatThe average Cost Per Click (CPC) for this keyword.1.20
difficultyintegerA score representing the keyword’s ranking difficulty (0-100).6
competitionfloatA score indicating the level of competition for this keyword (0.0-1.0).0.4
intentsarrayAn array of search intent codes: I (Informational), N (Navigational), C (Commercial), L (Local).[“I”]
serp_featuresarrayAn array of SERP features associated with the keyword.[“featured_snippets”, “videos”]
history_trendobjectIf 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

Title of the code block
Copy
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

Title of the code block
Copy
{
"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

ParameterLocationData TypeMandatoryDefault ValueDescriptionAcceptable ValuesExample
sourcequerystringYesN/AAlpha-2 country code of the regional keyword database.See Regional Database Codes.us
keywordquerystringYesN/AThe seed keyword for which to find question keywords.avocado
limitqueryintegerNo100Maximum number of keywords to return per page.Positive integers.10
offsetqueryintegerNo0Starting offset for pagination.Non-negative integers.0
sortquerystringNoN/AThe field by which the returned list of keywords should be sorted.keyword, volume, cpc, difficulty, competitionkeyword
sort_orderquerystringNodescThe order of sorting for the sort field.asc: ascending desc: descendingasc
history_trendquerybooleanNoFALSEWhether to include historical search volume trend data in the response.true, falseTRUE
filter[volume][from]queryintegerNoN/AMinimum monthly search volume.Non-negative integers.50
filter[volume][to]queryintegerNoN/AMaximum monthly search volume.Non-negative integers.5000
filter[difficulty][from]queryintegerNoN/AMinimum keyword difficulty score (0-100).Integers from 0 to 100.18
filter[difficulty][to]queryintegerNoN/AMaximum keyword difficulty score (0-100).Integers from 0 to 100.40
filter[cpc][from]queryfloatNoN/AMinimum Cost Per Click.Non-negative floats.0.1
filter[cpc][to]queryfloatNoN/AMaximum Cost Per Click.Non-negative floats.3
filter[competition][from]queryfloatNoN/AMinimum competition score (0.0-1.0).Floats from 0.0 to 1.0.0.2
filter[competition][to]queryfloatNoN/AMaximum competition score (0.0-1.0).Floats from 0.0 to 1.0.0.7
filter[keyword_count][from]queryintegerNoN/AMinimum number of words in the keyword.Positive integers.3
filter[keyword_count][to]queryintegerNoN/AMaximum number of words in the keyword.Positive integers.5
filter[characters_count][from]queryintegerNoN/AMinimum character length of the keyword.Positive integers.20
filter[characters_count][to]queryintegerNoN/AMaximum character length of the keyword.Positive integers.50
filter[serp_features]querystringNoN/AComma-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.

Title of the code block
Copy
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.

ParameterData TypeDescriptionExample
totalintegerThe total number of question keywords matching the criteria (ignoring limit and offset).3
keywordsarrayAn array of objects, each representing a question keyword with its metrics.See below

Each object in the keywords array includes:

ParameterData TypeDescriptionExample
keywordstringThe question keyword phrase.“für welche organe sind avocados gut”
volumeintegerThe average monthly search volume for this keyword in the specified source database.480
cpcfloatThe average Cost Per Click (CPC) for this keyword.1.20
difficultyintegerA score representing the keyword’s ranking difficulty (0-100).6
competitionfloatA score indicating the level of competition for this keyword (0.0-1.0).0.4
intentsarrayAn array of search intent codes: I (Informational), N (Navigational), C (Commercial), L (Local).[“I”]
serp_featuresarrayAn array of SERP features associated with the keyword.[“featured_snippets”, “videos”]
history_trendobjectIf 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

Title of the code block
Copy
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

Title of the code block
Copy
{
"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

ParameterLocationData TypeMandatoryDefault ValueDescriptionAcceptable ValuesExample
sourcequerystringYesN/AAlpha-2 country code of the regional keyword database.See Regional Database Codes.us
keywordquerystringYesN/AThe seed keyword for which to find longtail keywords.avocado
limitqueryintegerNo100Maximum number of keywords to return per page.Positive integers.10
offsetqueryintegerNo0Starting offset for pagination.Non-negative integers.0
sortquerystringNoN/AThe field by which the returned list of keywords should be sorted.keyword, volume, cpc, difficulty, competitionkeyword
sort_orderquerystringNodescThe order of sorting for the sort field.asc: ascending desc: descendingasc
filter[volume][from]queryintegerNoN/AMinimum monthly search volume.Non-negative integers.50
filter[volume][to]queryintegerNoN/AMaximum monthly search volume.Non-negative integers.5000
filter[difficulty][from]queryintegerNoN/AMinimum keyword difficulty score (0-100).Integers from 0 to 100.18
filter[difficulty][to]queryintegerNoN/AMaximum keyword difficulty score (0-100).Integers from 0 to 100.40
filter[cpc][from]queryfloatNoN/AMinimum Cost Per Click.Non-negative floats.0.1
filter[cpc][to]queryfloatNoN/AMaximum Cost Per Click.Non-negative floats.3
filter[competition][from]queryfloatNoN/AMinimum competition score (0.0-1.0).Floats from 0.0 to 1.0.0.2
filter[competition][to]queryfloatNoN/AMaximum competition score (0.0-1.0).Floats from 0.0 to 1.0.0.7
filter[keyword_count][from]queryintegerNoN/AMinimum number of words in the keyword.Positive integers.3
filter[keyword_count][to]queryintegerNoN/AMaximum number of words in the keyword.Positive integers.5
filter[characters_count][from]queryintegerNoN/AMinimum character length of the keyword.Positive integers.20
filter[characters_count][to]queryintegerNoN/AMaximum character length of the keyword.Positive integers.50
filter[serp_features]querystringNoN/AComma-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.

Title of the code block
Copy
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.

ParameterData TypeDescriptionExample
totalintegerThe total number of longtail keywords matching the criteria (ignoring limit and offset).35
keywordsarrayAn array of longtail keyword strings.See below

Sample Request: longtail

Title of the code block
Copy
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

Title of the code block
Copy
{
"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"
]
}