Top for a keyword (keyword_top)

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
}