Get access to 30+ marketing and SEO tools. analyze competitors, keywords, and backlinks for free..
Sign in Sign Up

We use cookies to make Serpstat better. By clicking "Accept cookies", you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts. Learn more

Keywords for V4 words (SerpstatKeywordProcedure.getKeywords)

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

Request parameters

Parameter

Description

Type

Optional

Default value

Value Options

id

A request id: the response contains the same id. Enter any number (number) or text (string) value

int/string

no

1, test

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

se

ID of the search base to be searched

string

no

g_us

minusKeywords

Negative keyword array

array

yes

[ ]empty array

["app", "apple"]

filters

Filter conditions

array

yes

 

{"cost_from": 0.1}

{"right_spelling": false

sort

Order of sorting the results in the format: {{{field}}: {{order}}}

field — field to sort by:
* cost
* concurrency
* found_results
* region_queries_count

* region_queries_count_wide
* keyword_length

order — sort direction (asc — ascending, desc — descending)

array

yes

['cost' => 'asc', 'region_queries_count' => 'desc']

{"keyword": "desc"} 

or

['cost' => 'asc', 'region_queries_count' => 'desc']

page Page number in response int yes 1 "page": "5"
size Number of results per page in response int yes 100

"size": "10"

min: 1, max: 1000

To filter the results, use the following parameters:

Parameter Description Possible values 
queries_from min number of monthly searches  0-100000000
queries_to max number of monthly searches  0-100000000
cost_from min CPC  0-200
cost_to max CPC  0-200
concurrency_from min competition for PPC keyword  0-100
concurrency_to max competition for PPC keyword  0-100
minus_keywords Negative keywords filter (a list of keywords separated by a comma) string

Response parameters

Parameter

Description

id

Response id corresponds the request id

result

Contains the answer

data Array with data

keyword

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
keyword_length 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. You can get no more than 60000 results per a query. 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 PHP Python
Request data:


{
 "id": "1",
 "method": "SerpstatKeywordProcedure.getKeywords",
 "params": {
   "keyword": "iphone",
   "se": "g_us",
   "minusKeywords": ["app", "apple"],
   "sort": {"region_queries_count": "desc"},
   "filters": {"queries_from": "1000", "queries_to": "10000"},
   "page": "1",
   "size": "10"
 }
}

Response data:
{
    "id": "1",
    "result": {
        "data": [
            {
                "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
            },
            {
                "keyword": "iphone suport",
                "cost": 0.67000000000000004,
                "concurrency": 8,
                "found_results": 62,
                "region_queries_count": 9900,
                "region_queries_count_wide": 0,
                "types": [
                    "also_asks",
                    "related_search",
                    "top_stories"
                ],
                "geo_names": [],
                "social_domains": [
                    "reddit",
                    "youtube",
                    "twitter",
                    "wikipedia"
                ],
                "right_spelling": "iphone support",
                "lang": null,
                "keyword_length": 2,
                "difficulty": null
            }
        ],
        "summary_info": {
            "page": 1,
            "total": 41575,
            "left_lines": 998735
        }
    }
}