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

Phrase Match Keywords (keywords)

API v3 methods will be unavailable from 12/31/2021. Use a similar API v4 method.

The keywords method 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

Following parameters can be used for pagination:
page_size: number of results per page (default: 100, max: 1000);
page:  page number (set to the 1st page by default).

You can use the following parameters to filter the results:

Parameter Description Possible settings
queries_from min number of monthly searches  0-100,000,000
queries_to max number of monthly searches  0-100,000,000
cost_from min CPC  0-200
cost_to max CPC  0-200
concurrency_from min level of competition  1-100
concurrency_to max level of competition  1-100
minus_keywords   filtering by negative keywords (separated by commas) string
right_spelling filtering by misspelled keywords 

not_contains - contains misspelled keywords;

contains - does not contain misspelled keywords

To sort the results apply the following parameters:
sort: field that needs to be sorted;
order: sorting order (asc - ascending, desc -  descending).

Response parameters
Parameter Description 
result Contains the answer
total Number of found results
hits Contains the answer
keyword Specified keyword
cost Cost per click, $
concurrency Keyword competition in PPC (0-100%)
found_results The number of results found for the keyword
region_queries_count Search volume in selected search engine database
types A 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 (Facebook, Youtube,etc.) which rank for a keyword in top-10
right_spelling Proposed correction for a keyword with a spelling error
keyword_length Number of words divided by space in a 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%)
status_msg Response "OK" or "Error" report on a successful or unsuccessful request
status_code Response code "200" — successful request. Errors occur when credits are exceeded (number of simultaneous requests or account credits)
left_lines API credits remaining

Part of the API response for which you spend 1 credit:

{
    "keyword": "iphone 11",
    "keyword_id": "76373283",
    "cost": 0.7,
    "concurrency": 100,
    "found_results": 96,
    "region_queries_count": 2240000,
    "types": [
        "also_asks",
        "ads_top"
        ],
    "geo_names": [],
    "social_domains": [
        "wikipedia",
        "pinterest",
        "reddit",
        "amazon"
        ],
    "right_spelling": null,
    "lang": null,
    "keyword_length": 2,
    "difficulty": 30.39
},

Example
Request data:

api.serpstat.com/v3/keywords?query=iphone&token=XXX&se=g_us

Response data:
{
    "result": {
        "total": 8323766,
        "hits": [
            {
                "keyword": "iphone 11",
                "keyword_id": "76373283",
                "cost": 0.7,
                "concurrency": 100,
                "found_results": 96,
                "region_queries_count": 2240000,
                "types": [
                    "also_asks",
                    "ads_top"
                ],
                "geo_names": [],
                "social_domains": [
                    "wikipedia",
                    "pinterest",
                    "reddit",
                    "amazon"
                ],
                "right_spelling": null,
                "lang": null,
                "keyword_length": 2,
                "difficulty": 30.39
            },
            {
                "keyword": "iphone 1 1",
                "keyword_id": "128864865",
                "cost": 0.7,
                "concurrency": 100,
                "found_results": 81,
                "region_queries_count": 2240000,
                "types": [
                    "also_asks",
                    "shopping_top"
                ],
                "geo_names": [],
                "social_domains": [
                    "wikipedia",
                    "amazon",
                    "reddit"
                ],
                "right_spelling": null,
                "lang": null,
                "keyword_length": 3,
                "difficulty": 84.69767683592724
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 999738
}