Keywords selection

The SerpstatKeywordProcedure.getKeywords shows organic keywords associated with the researched keyword that domains are ranking for in Google`s top-100 results and for every found keyword you’ll see its volume, CPC and level of competition. The data set is similar to the Keyword research — SEO research — Keywords selection report.

General request parameters and instructions for using Serpstat API

Search databases available

Request parameters
Parameter	Description	Type	Optional	Default value	Value Options
id	A request id: the response contains the same id.	int/string	no		Text or number value
method	API method name	string	no		SerpstatKeywordProcedure.getKeywords
params	The object with parameters {...}, it lists all the following parameters and arrays [...]	array	no
keyword	Keyword to search for	string	no		"iphone" (any text value)
se	ID of the search base to be searched.	string	no		g_us (search databases list)
minusKeywords	Negative keyword array	array	yes		["app", "apple"] — array of excluding keywords
filters	Filter conditions	array	yes		Cost: "cost": 10 (0-200) — Price per click in US$ "cost_to": 10 (0-200) — Price per click to "cost_from": 1 (0-200) — Price per click from Volume: "region_queries_count": 1000 (0-100,000,000) — Keyword volume by the selected region "region_queries_count_to": 2000 (0-100,000,000) — Volume to "region_queries_count_from": 300 (0-100,000,000) — Volume from Number of words in phrase: "keyword_length": 1 (any number value) — Number of words in the keyword "keyword_length_from" (any number value) — Number of words from "keyword_length_to" (any number value) — Number of words to Difficulty: "difficulty": 3 (0-100) — Difficulty of the keyword "difficulty_from": 5 (0-100) — Difficulty from "difficulty_to": 10 (0-100) — Difficulty to Concurrency: "concurrency": 7 (1-100) — Concurrency "concurrency_to": 7 (1-100) — Competition to "concurrency_from": 1 (1-100) — Competition from Right spelling: "right spelling": "true" — contains all; "right spelling": "false" — does not contain all. Keywords: "keyword_contain" — Contains all (exact matching); "keyword_not_contain" — Does not contain all (exact matching); "keyword_contain_one_of" — Contains one of (exact matching); "keyword_not_contain_one_of" — Does not contain one of (exact matching); "keyword_contain_broad_match" — Contains all (broad match); "keyword_not_contain_broad_match" — Does not contain all (broad match); "keyword_contain_one_of_broad_match" — Contains one of (broad match); "keyword_not_contain_one_of_broad_match" — Does not contain one of (broad match); Language: "lang": {uk,ru,en,bg,pl,de,es,it,fr,ro,be,hu,ka,el,other} - Specify keyword language Language filtration works only for g_ua database
sort	Sort by data (ascending and descending)	array	yes	"cost": "asc" "region_queries_count": "desc	"keyword_length" — Sort results by keyword length "difficulty" — Sort the results by the level of keywords competition level to advance in organic search in the top-10 "cost" — Sort results by cost per click (in USD) "region_queries_count" — Sort results by frequency of a key phrase in the selected region
order	sort direction	array	yes	"cost": "asc" "region_queries_count": "desc"	Sort direction (asc — ascending, desc — descending)
page	Page number in response	int	yes	1	"page": 5 (any number value)
size	Number of results per page in response	int	yes	100	"size": 10 (any number value) min: 1, max: 1000

Response parameters
Parameter	Description
id	Response id corresponds the request id
result	Contains the answer
data	Array with data
keyword	Suggested keyword
cost	Cost per click, $
concurrency	Keyword competition in the PPC (0-100%)
found_results	Number of results found for the keyword
region_queries_count	Search volume in a selected region
region_queries_count_wide	Search volume in selected search engine database in broad match
types	List of special elements shown in SERP (for example, video, carousel or map)
geo_names	List of toponyms in the array (if toponyms are present in the keywords)
social_domains	Social domains listed top-10 for a selected keyword
right_spelling	Recommended correction of a misspelled keyword
lang	Language of the keyword
keyword_lenght	Number of words divided by space in a keyword
difficulty	The assessment of the level of competition for a keyword to advance in organic search in the top-10 (from 0 to 100)
summary_info	Object with data
page	Page number
total	Number of found results
left_lines	API credits remaining

Credits: the number of charged credits corresponds to the number of results obtained upon request. With the Serpstat API, you can only get the first 60,000 results, regardless of the number and size of the queries themselves. For more data - use the export option in the Domain Analysis, Keyword Analysis, or URL Analysis sections, or contact the manager for a personal upload of the results. Part of the API response, for which 1 credit is charged:

{
    "keyword": "how to download you tube videos on iphone",
    "cost": 0.56999999999999995,
    "concurrency": 1,
    "found_results": 729000000,
    "region_queries_count": 9900,
    "region_queries_count_wide": 0,
    "types": [
        "a_box_fsnippet",
        "local_related_search",
        "related_search"
        ],
    "geo_names": [],
    "social_domains": [
        "youtube",
        "reddit"
        ],
    "right_spelling": "how to download youtube videos on iphone",
    "lang": null,
    "keyword_length": 8,
    "difficulty": 17.57
},

Example Python

Request data:

{
 "id": "1",
 "method": "SerpstatKeywordProcedure.getKeywords",
 "params": {
   "keyword": "iphone",
   "se": "g_us",
   "minusKeywords": ["app", "apple"],
   "filters": {"lang": "en"},
   "sort": {"region_queries_count": "asc"},
   "page": 1,
   "size": 2
 }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "keyword": "lowest price of iphone 4s in india",
                "cost": 0,
                "concurrency": 0,
                "found_results": 347000,
                "region_queries_count": 1,
                "region_queries_count_wide": 0,
                "types": [],
                "geo_names": [
                    "india"
                ],
                "social_domains": [
                    "amazon",
                    " youtube",
                    " pinterest"
                ],
                "right_spelling": null,
                "lang": "en",
                "keyword_length": 7,
                "difficulty": 3.7806799607656694
            },
            {
                "keyword": "iphone 5 s in india",
                "cost": 0,
                "concurrency": 0,
                "found_results": 15000000,
                "region_queries_count": 1,
                "region_queries_count_wide": 0,
                "types": [],
                "geo_names": [
                    "india"
                ],
                "social_domains": [
                    "wikipedia",
                    " amazon",
                    " youtube"
                ],
                "right_spelling": null,
                "lang": "en",
                "keyword_length": 5,
                "difficulty": 4.167060216464227
            }
        ],
        "summary_info": {
            "page": 1,
            "total": 6363925,
            "left_lines": 992762
        }
    }
}

Serpstat API request drafts: link