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) "position": 1; — Keyword position "concurrency": 7; — Competition ( how hard is it to promote a keyword to the top from 1-100 ) "keyword_length": 1; — Number of words in the keyword (any number value) "difficulty": 3; — The difficulty of the keyword (any number value) "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_wide": 1000; — Volume of the keyword in broad match (any number value) "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); | |
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 |
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) |
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
},
{
"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"
}
}
{
"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
}
}
}