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

Keyword search suggestions (suggestions)

API v3 methods will be unavailable from 03/01/2022. Use a similar API v4 method.

The suggestions API method shows search suggestions for the keyword you requested (they are found by the full-text search). Use question=1 parameter to get questions only. The data set is similar to the Keyword research — SEO research  Search suggestions 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).

Response parameters
Parameter Description
result Contains the answer
total Number of found results
hits Contains the answer
keyword Search suggestion
geo_names List of toponyms in the array (if toponyms are present in the keywords)
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 1 limit is charged:

{
    "keyword": "iphone x fre case release",
    "geo_names": [],
    "_id": "db44a9cbdacc966c4d6dc85f5f47f056"
},

Example
Request data:

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

Response data:
{
    "result": {
        "total": 2652668,
        "hits": [
            {
                "keyword": "iphone x fre case release",
                "geo_names": [],
                "_id": "db44a9cbdacc966c4d6dc85f5f47f056"
            },
            {
                "keyword": "iphone 7 plus tekniset tiedot",
                "geo_names": [],
                "_id": "3db42bb6c2392dd351af4c759638b159"
            },
            {
                "keyword": "softlogic iphone x",
                "geo_names": [],
                "_id": "7441b8fb8c10ed2dc7c886d96a59749e"
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 999535
}

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.

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

Open support chat