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

Share this article with your friends

Are you sure?

Introducing Serpstat

Find out about the main features of the service in a convenient way for you!

Please send a request, and our specialist will offer you education options: a personal demonstration, a trial period, or materials for self-study and increasing expertise — everything for a comfortable start to work with Serpstat.

Name

Email

Phone

We are glad of your comment
I agree to Serpstat`s Privacy Policy.

Thank you, we have saved your new mailing settings.

Open support chat