Top by keyword
The SerpstatKeywordProcedure.getKeywordFullTop method shows you Google's top-100 search results for the analyzed keyword. The data set is similar to the Top by keyword report in Keyword research.
General request parameters and instructions for using Serpstat API
Search databases available
| Request parameters | |||||
| Parameter | Description | Type | Required | Default value | Value options |
| id | A request id: the response contains the same id. Enter any number (number) or text (string) value | int/string | yes | 1, test | |
| method | API method name | string | yes | SerpstatKeywordProcedure.getKeywordFullTop | |
| params | The object with parameters {...}, it lists all the following parameters and arrays [...] | array | yes | ||
| keyword | Keyword to search for | string | yes | pizza | |
| se | ID of the search base to be searched. | string | yes | g_us | |
| sort | Sort by data (ascending and descending) | array | no | {"position": "asc"} | "position": "asc"/"desc" (asc — ascending sort direction, desc — descending) - Position in top-100 |
| size | Number of results per page in response | int | no | 100 | "size": "50" min: 10, max: 100 |
| Response parameters | |
| Parameter | Description |
| id | Response id corresponds the request id |
| result | Contains the answer |
| top | Array with data |
| position | Position in top results |
| url | URL of the domain in top results |
| url_keywords_count | The number of organic keywords the URL ranks for in Google top-100 results |
| domain | Domain of the URL |
| domain_visibility | Visibility of a domain in top-20 search results. It's a relative indicator, which is calculated as a ratio of the amount and popularity of keywords a domain is shown for. About visibility |
| domain_keywords_organic | The number of organic keywords the domain ranks for in Google top-100 results |
| domain_keywords_ppc | The number of ppc keywords the domain ranks for in Google top-100 results |
| domain_top_10_keywords_count | The number of organic keywords the domain ranks for in Google top-10 results |
| domain_sdr | Serpstat Domain Rank (SDR) — an indicator of domain authority |
| domain_in_urls_count | Number of domain's backlinks |
| domain_in_domains_count | Number of referring domains |
| domain_out_urls_count | Number of links from the analyzed domain |
| domain_out_domains_count | Number of domains to which the analyzed domain links |
| summary_info | Object with summary data |
| keywords | Number of keywords in SEO (from Keywords selection report) |
| frequency | Keyword's search volume |
| cost | Cost per click (USD), that is monthly updated. |
| difficulty | The assessment of the level of competition for a keyword to advance in organic search in the top-10 (from 1 to 100) |
| concurrency | Keyword competition in the PPC (0-100%) |
| types | List of special elements shown in SERP (for example, video, carousel or map) |
| sorting | Sorting of the request |
| left_limits | API credits remaining |
| count_top_results | Number of results of the request |
| keyword | Analyzed keyword |
| se | Used search base |
Credits: the number of charged credits corresponds to the number of results obtained upon request. Part of the API response, for which 1 credit is charged:
{
"position": 27,
"url": "https://www.zpizza.com/",
"url_keywords_count": 3162,
"domain": "zpizza.com",
"domain_visibility": 0.07,
"domain_keywords_organic": 9120,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 1101,
"domain_sdr": 44,
"domain_in_urls_count": 6265,
"domain_in_domains_count": 716,
"domain_out_urls_count": 452,
"domain_out_domains_count": 129
}
{
"id": 1,
"method": "SerpstatKeywordProcedure.getKeywordFullTop",
"params": {
"keyword": "pizza",
"se": "g_us",
"sort": {
"domain": "asc"
},
"size": 10
}
}{
"id": "1",
"result": {
"top": [
{
"position": 27,
"url": "https://www.zpizza.com/",
"url_keywords_count": 3162,
"domain": "zpizza.com",
"domain_visibility": 0.07,
"domain_keywords_organic": 9120,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 1101,
"domain_sdr": 44,
"domain_in_urls_count": 6265,
"domain_in_domains_count": 716,
"domain_out_urls_count": 452,
"domain_out_domains_count": 129
},
{
"position": 29,
"url": "https://www.youtube.com/watch?v=0w8YpBjsW6Y",
"url_keywords_count": 99,
"domain": "youtube.com",
"domain_visibility": 22059.88,
"domain_keywords_organic": 480765206,
"domain_keywords_ppc": 4,
"domain_top_10_keywords_count": 106713777,
"domain_sdr": 99,
"domain_in_urls_count": 8774661393,
"domain_in_domains_count": 22344395,
"domain_out_urls_count": 94697,
"domain_out_domains_count": 163
},
{
"position": 65,
"url": "https://www.youtube.com/watch?v=263uoOoWf9c",
"url_keywords_count": 68,
"domain": "youtube.com",
"domain_visibility": 22059.88,
"domain_keywords_organic": 480765206,
"domain_keywords_ppc": 4,
"domain_top_10_keywords_count": 106713777,
"domain_sdr": 99,
"domain_in_urls_count": 8774661393,
"domain_in_domains_count": 22344395,
"domain_out_urls_count": 94697,
"domain_out_domains_count": 163
},
{
"position": 56,
"url": "https://www.yelp.com/search?cflt=pizza&find_loc=Mentone%2C+AL",
"url_keywords_count": 20,
"domain": "yelp.com",
"domain_visibility": 3155.87,
"domain_keywords_organic": 82668431,
"domain_keywords_ppc": 15,
"domain_top_10_keywords_count": 36075286,
"domain_sdr": 82,
"domain_in_urls_count": 71352727,
"domain_in_domains_count": 634321,
"domain_out_urls_count": 13029,
"domain_out_domains_count": 466
},
{
"position": 67,
"url": "https://www.yelp.com/search?cflt=pizza&find_loc=Hopewell%2C+VA",
"url_keywords_count": 15,
"domain": "yelp.com",
"domain_visibility": 3155.87,
"domain_keywords_organic": 82668431,
"domain_keywords_ppc": 15,
"domain_top_10_keywords_count": 36075286,
"domain_sdr": 82,
"domain_in_urls_count": 71352727,
"domain_in_domains_count": 634321,
"domain_out_urls_count": 13029,
"domain_out_domains_count": 466
},
{
"position": 3,
"url": "https://en.wikipedia.org/wiki/Pizza",
"url_keywords_count": 8737,
"domain": "wikipedia.org",
"domain_visibility": 37845.97,
"domain_keywords_organic": 241512021,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 76138842,
"domain_sdr": 94,
"domain_in_urls_count": 1419295195,
"domain_in_domains_count": 6636517,
"domain_out_urls_count": 194046257,
"domain_out_domains_count": 607822
},
{
"position": 61,
"url": "https://www.wfaa.com/article/life/food/donatos-pizza-expansion-dallas-fort-worth/287-a7099672-b807-45e2-b978-904d21be8398",
"url_keywords_count": 41,
"domain": "wfaa.com",
"domain_visibility": 28.87,
"domain_keywords_organic": 975269,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 50721,
"domain_sdr": 66,
"domain_in_urls_count": 558794,
"domain_in_domains_count": 19665,
"domain_out_urls_count": 2,
"domain_out_domains_count": 2
},
{
"position": 34,
"url": "https://www.vpizza.com/",
"url_keywords_count": 4363,
"domain": "vpizza.com",
"domain_visibility": 0.01,
"domain_keywords_organic": 8162,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 422,
"domain_sdr": 38,
"domain_in_urls_count": 599,
"domain_in_domains_count": 236,
"domain_out_urls_count": 526,
"domain_out_domains_count": 26
},
{
"position": 38,
"url": "https://unapizza.com/",
"url_keywords_count": 1530,
"domain": "unapizza.com",
"domain_visibility": 0.08,
"domain_keywords_organic": 2098,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 196,
"domain_sdr": 42,
"domain_in_urls_count": 4744,
"domain_in_domains_count": 408,
"domain_out_urls_count": 206,
"domain_out_domains_count": 40
},
{
"position": 73,
"url": "https://www.tributepizza.com/",
"url_keywords_count": 836,
"domain": "tributepizza.com",
"domain_visibility": 0.01,
"domain_keywords_organic": 1064,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 44,
"domain_sdr": 35,
"domain_in_urls_count": 467,
"domain_in_domains_count": 111,
"domain_out_urls_count": 120,
"domain_out_domains_count": 13
}
],
"summary_info": {
"keywords": 3123661,
"frequency": 6120000,
"cost": 2,
"difficulty": 93,
"concurrency": 10,
"types": [
"related_search",
"kn_graph_card"
],
"sorting": {
"domain": "desc"
},
"left_limits": 999360,
"count_top_results": 100,
"keyword": "pizza",
"se": "g_us"
}
}
}