URL keywords

The SerpstatUrlProcedure.getUrlKeywords method returns keywords that URL ranks for in Google top-100 search results. The data set is similar to the URL analysis — SEO research — Keywords report.

General request parameters and instructions for using Serpstat API

Search databases available

Request parameters
Parameter	Description	Type	Optional	Default value	Value Options
id	A request id: the response contains the same id.	int/string	no		Any text or number value
method	API method name	string	no		SerpstatUrlProcedure.getUrlKeywords
params	The object with parameters {...}, it lists all the following parameters and arrays [...]	array	no
se	ID of the search base to be searched	string	no		g_us (search databases list)
url	Page URL	string	no		URL-address of the page (For example "https://www.nike.com")
filters	Filter conditions	array	yes		"cost": 10; — Cost per click ( in US $) (any number value) "cost_to": 10; — Cost per click (in US $) to (any number value) "cost_from": 1; — Cost per click (in US $) from (any number value) "position": 1; — Keyword position "position_from": 2; — Position from "position_to": 10; — Position to "concurrency": 7; — Competition ( how hard is it to promote a keyword to the top from 1-100 ) "concurrency_to": 7; — Competition to "concurrency_from": 1; — Competition from "keyword_length": 1; — Number of words in the keyword (any number value) "difficulty": 3; — The difficulty of the keyword (any number value) "difficulty_from": 5; — difficulty from "difficulty_to": 10; — difficulty to "traff": 3; — Traffic by the keyword (any number value) "region_queries_count": 1000; — Volume of the keyword by the selected region (any number value) "region_queries_count_to": 2000; — Volume to "region_queries_count_from": 300; — Volume from "region_queries_count_wide": 1000; — Volume of the keyword in broad match (any number value) "region_queries_count_wide_to": 1500; — Volume to "region_queries_count_wide_from": 100; — Volume from "url_contains": "https://serpstat.com/" — Contains URL "right_spelling": true; "right_spelling": false — Misspelled keywords ( Contains / Does not contain ) "keyword_contain" — Contains all (exact matching); "keyword_not_contain" — Does not contain all (exact matching); "keyword_contain_one_of" — Contains one of (exact matching); "keyword_not_contain_one_of" — Does not contain one of (exact matching); "keyword_contain_broad_match" — Contains all (broad match); "keyword_not_contain_broad_match" — Does not contain all (broad match); "keyword_contain_one_of_broad_match" — Contains one of (broad match); "keyword_not_contain_one_of_broad_match" — Does not contain one of (broad match);
sort	Sort by data (ascending and descending)	array	yes	"traff"	"difficulty" - Sort the results by the level of keywords competition level to advance in organic search in the top-10 "cost" - Sort the results by cost per click (in USD) "position" - Sort the results by position
order	sort direction	array	yes	"desc"	Sort direction (asc — ascending, desc — descending)
page	Page number in response	int	yes	1	"page": 5 (Any number value)
size	Number of results per page in response	int	yes	100	"size": 10 (Any number value) min: 1, max: 1000

Response parameters
Parameter	Description
id	Response id: corresponds the request id
result	Contains the answer
data	Array with data
domain	Domain by which the information was received
subdomain	Subdomain which ranks for the keyword
keyword	Keyword which the URL ranks for
keyword_length	Number of words divided by space in a keyword
url	URL appeared in the search result for the query
position	URL's position for a keyword
types	List of special elements shown in SERP (for example, video, carousel or map)
found_results	Number of results found for keyword
cost	Cost per click, $ (the indicator is updated every month)
concurrency	Keyword competition in the PPC (0-100)
region_queries_count	Search volume in selected region
region_queries_count_wide	Search volume (broad match)
geo_names	List of toponyms in the array (if toponyms are present in the keywords)
traff	Approximate traffic by keyword depending on its volume and position
difficulty	The assessment of the level of competition for a keyword to advance in organic search in the top-10 (from 0 to 100%)
first_position	The domain position of which is better than the one you are looking for was found by the keyword.
first_url	The url position of which is better than the one you are looking for was found by the keyword.
dynamic	How the position of this keyword has changed (New position — null, Position did not change — 0, Position dropped — negative value (e.g. -20), Position increased — positive value (e.g. 20))
summary_info	Object with data
page	Page number
total	Number of found keywords ranking the given domain in top
left_lines	API credits remaining

Credits: the number of charged credits corresponds to the number of results obtained upon request. With the Serpstat API, you can only get the first 60,000 results, regardless of the number and size of the queries themselves. For more data - use the export option in the Domain Analysis, Keyword Analysis, or URL Analysis sections, or contact the manager for a personal upload of the results. Part of the API response, for which 1 credit is charged:

{
    "domain": "nike.com",
    "subdomain": "www.nike.com",
    "keyword": "man nike",
    "keyword_length": 2,
    "url": "https://www.nike.com/men",
    "position": 1,
    "types": [
        "snip_breadcrumbs"
        ],
    "found_results": 656000000,
    "cost": 0.38,
    "concurrency": 100,
    "region_queries_count": 40500,
    "region_queries_count_wide": 0,
    "geo_names": [],
    "traff": 6071,
    "difficulty": null,
    "dynamic": 0
},

Example

Request data:

{
    "id": "1",
    "method": "SerpstatUrlProcedure.getUrlKeywords",
    "params": {
        "se": "g_us",
        "url": "https://www.nike.com/men",
        "filters": {"cost_from": 1, "cost_to": 1000},
        "sort": {"position": "asc"},
        "page": "1",
        "size": "10"
    }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "nike shoes online purchase",
                "keyword_length": 4,
                "url": "https://www.nike.com/men",
                "position": 2,
                "types": [
                    "twitter",
                    "carousel",
                    "shopping_rhs",
                    "pic",
                    "also_asks",
                    "snippet_breadcrumbs"
                ],
                "found_results": 66200000,
                "cost": 1.3799999999999999,
                "concurrency": 92,
                "region_queries_count": 10,
                "region_queries_count_wide": null,
                "geo_names": [],
                "traff": 1,
                "difficulty": 90.036638012173825,
                "first_position": 1,
                "first_url": "https://www.nike.com/",
                "dynamic": 0
            },
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "shoes for men us",
                "keyword_length": 4,
                "url": "https://www.nike.com/men",
                "position": 2,
                "types": [
                    "kn_graph_carousel_list",
                    "a_box_card",
                    "snip_breadcrumbs"
                ],
                "found_results": 1660000000,
                "cost": 2.0435020000000002,
                "concurrency": 100,
                "region_queries_count": 110,
                "region_queries_count_wide": null,
                "geo_names": [],
                "traff": 15,
                "difficulty": 65.138039166735581,
                "dynamic": 3
            }
        ],
        "summary_info": {
            "page": 3,
            "total": 217,
            "left_lines": 999998
        }
    }
}