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
}