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

Related Keywords (related_keywords)

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

The related_keywords method shows all search queries that are semantically related to the searched keyword. The data set is similar to the Keyword research — SEO research  Related keywords 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: number (set to the 1st page by default).

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 related keywords
hits Contains the answer
keyword Related keyword
region_queries_count Search volume in selected search engine database
cost Cost per click, $
concurrency Keyword competition in PPC (0-100%)
geo_names List of in the array (if are present in the keywords)
types A list of special elements shown in (for example, video, carousel or map)
right_spelling Proposed correction for a keyword with a spelling error
weight The degree of keywords similarity
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": "when will next iphone come out",
    "region_queries_count": 2900,
    "cost": 6.75,
    "concurrency": 2,
    "geo_names": [],
    "types": [
        "also_asks",
        "snip_breadcrumbs"
        ],
    "weight": 1,
    "difficulty": 67
}

Example
Request data:

api.serpstat.com/v3/related_keywords?query=iphone&token=XXX&se=g_us&right_spelling=not_contains

Response data:
{
    "result": {
        "total": 2025,
        "hits": [
            {
                "keyword": "iphone_",
                "region_queries_count": 1220000,
                "cost": 1.96,
                "concurrency": 100,
                "geo_names": [],
                "types": [
                    "kn_graph_carousel_list",
                    "also_asks",
                    "top_stories",
                    "ads_bot",
                    "snip_breadcrumbs"
                ],
                "weight": 5,
                "difficulty": 90
            },
            {
                "keyword": "when will next iphone come out",
                "region_queries_count": 2900,
                "cost": 6.75,
                "concurrency": 2,
                "geo_names": [],
                "types": [
                    "also_asks",
                    "snip_breadcrumbs"
                ],
                "weight": 1,
                "difficulty": 67
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 999335
}