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

Top for a keyword (keyword_top)

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

The keyword_top method shows you Google's top-100 or Yandex's top-50 search results for the analyzed keyword. The data set is similar to the Top pages report in Keyword research.

General request parameters and instructions for using Serpstat API

Response parameters
Parameter Description
result Contains the answer
top Contains the result
position Domain's position for a keyword
url Page that ranks for the keyword
domain Domain which ranks for the keyword
subdomain Subdomain which ranks for the keyword
types A list of special elements shown in SERP (for example, video, carousel or map)
ads Number of found Ads (if there are ads in the results)
results Number of results
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:

{
    "position": 1,
    "url": "https://www.apple.com/iphone/",
    "domain": "apple.com",
    "subdomain": "www.apple.com",
    "types": [
        "shopping_top",
        "kn_graph_carousel_list",
        "also_asks",
        "snip_breadcrumbs"
        ]
},

Example
Request data:

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

Response data:
{
    "result": {
        "top": [
            {
                "position": 1,
                "url": "https://www.apple.com/iphone/",
                "domain": "apple.com",
                "subdomain": "www.apple.com",
                "types": [
                    "shopping_top",
                    "kn_graph_carousel_list",
                    "also_asks",
                    "snip_breadcrumbs"
                ]
            },
            {
                "position": 2,
                "url": "https://www.apple.com/",
                "domain": "apple.com",
                "subdomain": "www.apple.com",
                "types": [
                    "shopping_top",
                    "kn_graph_carousel_list",
                    "also_asks",
                    "snip_breadcrumbs"
                ]
            }
        ],
        "ads": [],
        "types": [
            "shopping_top",
            "kn_graph_carousel_list",
            "also_asks"
        ],
        "results": 79
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 999258
}