URL keywords
The SerpstatUrlProcedure.getUrlKeywords method returns a list of keywords for which the specified URL ranks in the top-100 Google and top-50 Bing search results. It provides insights into the organic search performance of a page and is ideal for keyword research, content optimization, and competitor analysis. The data set is similar to the URL analysis — SEO research — Keywords report.
Use Case: Expand Your Keyword List with Ease
1. Analyze a Competitor: Identify a relevant competitor's page.
2. Extract Keywords: Use SerpstatUrlProcedure.getUrlKeywords to extract keywords.
3. Filter for Quality: Apply filters to select the best keywords.
4. Expand Your List: Incorporate these keywords into your existing list.
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. | int/string | yes | any text or number value | |
| method | API method name | string | yes | SerpstatUrlProcedure.getUrlKeywords | |
| params | The object with parameters {...}, it lists all the following parameters and arrays [...] | array | yes |
| |
| se | ID of the search base to be searched | string | yes | g_us (search databases list) | |
| url | Analyzed page URL | string | yes | URL-address of the page | |
| withIntents | Keyword intent | boolean | no | false | true | false |
| filters | Filter conditions | array | no | no filtration | filter conditions are listed in the next table |
| sort | Sort by data (ascending and descending) | array | no | "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 | no | "desc" | asc or desc |
| page | Page number in response | int | no | 1 | any number value |
| size | Number of results per page in response | int | no | 100 | number value in the range of 1-1000 |
| Filter conditions parameters | |||
| Parameter | Description | Type | Value Options |
| cost | Cost per click (in US $; exact match) | float | any number value |
| cost_from | Cost per click (in US $; exact match) from | float | any number value |
| cost_to | Cost per click (in US $; exact match) to | float | any number value |
| position | URL's position in Google`s top-100 results for this keyword. | int | any whole number in the range of 1-100 |
| position_from | Keyword position from | int | any whole number in the range of 1-100 |
| position_to | Keyword position to | int | any whole number in the range of 1-100 |
| concurrency | PPC Competition. Shows how difficult it would be to compete for this keyword. Max 100. The more domains use this keyword in their ads campaigns, the higher level of competition is. | int | any whole number in the range of 1-100 |
| concurrency_from | PPC Competition from | int | any whole number in the range of 1-100 |
| concurrency_to | PPC Competition to | int | any whole number in the range of 1-100 |
| keyword_length | Number of words in the keyword | int | any number value |
| difficulty | The assessment of the level of competition for a keyword to advance in organic search in the top-10. It is measured on a scale from 0 to 100, where: 0-20 easy; 21-40 - medium; 41-60 - difficult; 61-100 - very difficult. More info adout difficulty of the keyword. | float | any number value in the range of 1-100 |
| difficulty_from | The difficulty of the keyword from | float | any number value in the range of 1-100 |
| difficulty_to | The difficulty of the keyword to | float | any number value in the range of 1-100 |
| traff | Approximate traffic by keyword depending on its volume and position | int | any whole number |
| region_queries_count | Volume of the keyword by the selected region | int | any whole number |
| region_queries_count_from | Volume of the keyword by the selected region from | int | any whole number |
| region_queries_count_to | Volume of the keyword by the selected region to | int | any whole number |
| region_queries_count_wide | Volume of the keyword in broad match | int | any whole number |
| region_queries_count_wide_from | Volume of the keyword in broad match from | int | any whole number |
| region_queries_count_wide_to | Volume of the keyword in broad match to | int | any whole number |
| url_contains | The exact website pages ranking for the keywords | string | any text value |
| right_spelling | Display or not to display misspelled keywords | boolean | true or false |
| keyword_contain | Contains all keywords(exact matching) | string | any text value |
| keyword_not_contain | Does not contain all keywords (exact matching) | string | any text value |
| keyword_contain_one_of | Contains one of the keywords (exact matching) | string | any text value |
| keyword_not_contain_one_of | Does not contain one of the keywords (exact matching) | string | any text value |
| keyword_contain_broad_match | Contains all keywords (broad match) | string | any text value |
| keyword_not_contain_broad_match | Does not contain all keywords (broad match) | string | any text value |
| keyword_contain_one_of_broad_match | Contains one of the keywords (broad match) | string | any text value |
| keyword_not_contain_one_of_broad_match | Does not contain one of the keywords (broad match) | string | any text value |
| intents_contain | Contains one or several of intents | array | informational, navigational, commercial, transactional |
| intents_not_contain | Does not contain one of the intents | array | informational, navigational, commercial, transactional |
| 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)) |
| intents | Intents of the analyzed keyword |
| summary_info | Object with data |
| page | Page number |
| total | Number of found keywords ranking the given domain in top |
| left_lines | API credits remaining |
| Possible errors in response | |
| Error's code | Description |
| 400 | JSON RPC 2.0 Request invalid payload. Oops! Something went wrong with your search. Please double-check your spelling and make sure you're using the correct format for each field |
| 32017 | Data not found. Please verify your search terms or try a different query. |
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",
"withIntents": true,
"filters": {
"cost_from": 1,
"cost_to": 1000,
"intents_contain": ["commercial"],
"intents_not_contain":["navigational"]
},
"sort": {"position": "asc"},
"page": "1",
"size": "10"
}
}{
"id": "1",
"result": {
"data": [
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike men usa",
"keyword_length": 3,
"url": "https://www.nike.com/men",
"position": 1,
"types": [
"related_search",
"pic",
"ads_top",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 102000000,
"cost": 2.3199999999999998,
"concurrency": 100,
"region_queries_count": 90,
"region_queries_count_wide": null,
"geo_names": [
"usa"
],
"traff": 13,
"difficulty": 75,
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "online purchase of nike shoes",
"keyword_length": 5,
"url": "https://www.nike.com/men",
"position": 1,
"types": [
"pic",
"related_search",
"video",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 30800000,
"cost": 1.3600000000000001,
"concurrency": 51,
"region_queries_count": 1600,
"region_queries_count_wide": null,
"geo_names": [],
"traff": 239,
"difficulty": 7,
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike men's store",
"keyword_length": 3,
"url": "https://www.nike.com/men",
"position": 3,
"types": [
"pic",
"local_pack",
"related_search",
"snip_breadcrumbs",
"snip_image_thumbnail",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 156000000,
"cost": 2.29,
"concurrency": 79,
"region_queries_count": 40,
"region_queries_count_wide": null,
"geo_names": [],
"traff": 5,
"difficulty": 55,
"first_position": 1,
"first_url": "https://www.nike.com/w/mens-clothing-6ymx6znik1",
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "us shop nike",
"keyword_length": 3,
"url": "https://www.nike.com/men",
"position": 3,
"types": [
"pic",
"ads_top",
"related_search",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 396,
"cost": 2.4300000000000002,
"concurrency": 76,
"region_queries_count": 390,
"region_queries_count_wide": null,
"geo_names": [],
"traff": 55,
"difficulty": 26,
"first_position": 1,
"first_url": "https://www.nike.com/w/usa-10ciy",
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike usa men",
"keyword_length": 3,
"url": "https://www.nike.com/men",
"position": 3,
"types": [
"pic",
"ads_top",
"related_search",
"snip_breadcrumbs",
"snip_image_thumbnail",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 92900000,
"cost": 1.6300000000000001,
"concurrency": 100,
"region_queries_count": 90,
"region_queries_count_wide": null,
"geo_names": [
"usa"
],
"traff": 12,
"difficulty": 3,
"first_position": 1,
"first_url": "https://www.nike.com/w/mens-usa-10ciyznik1",
"dynamic": null,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike store l",
"keyword_length": 3,
"url": "https://www.nike.com/men",
"position": 3,
"types": [
"also_asks",
"local_pack",
"related_search",
"pic",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 175000000,
"cost": 1.3300000000000001,
"concurrency": 82,
"region_queries_count": 10,
"region_queries_count_wide": null,
"geo_names": [],
"traff": 1,
"difficulty": 59,
"first_position": 1,
"first_url": "https://www.nike.com/",
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike store n",
"keyword_length": 3,
"url": "https://www.nike.com/men",
"position": 3,
"types": [
"video",
"also_asks",
"local_pack",
"pic",
"related_search",
"snip_breadcrumbs"
],
"found_results": 130000000,
"cost": 4.25,
"concurrency": 68,
"region_queries_count": 10,
"region_queries_count_wide": null,
"geo_names": [],
"traff": 1,
"difficulty": 36,
"first_position": 1,
"first_url": "https://www.nike.com/",
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike store com us",
"keyword_length": 4,
"url": "https://www.nike.com/men",
"position": 4,
"types": [
"related_search",
"ads_bot",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 441000000,
"cost": 1.4399999999999999,
"concurrency": 96,
"region_queries_count": 1900,
"region_queries_count_wide": null,
"geo_names": [],
"traff": 242,
"difficulty": 60,
"first_position": 1,
"first_url": "https://www.nike.com/w/usa-10ciy",
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "https www nike com usa",
"keyword_length": 5,
"url": "https://www.nike.com/men",
"position": 4,
"types": [
"pic",
"ads_top",
"related_search",
"also_asks",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 82,
"cost": 2.71,
"concurrency": 92,
"region_queries_count": 30,
"region_queries_count_wide": null,
"geo_names": [
"usa"
],
"traff": 3,
"difficulty": null,
"first_position": 1,
"first_url": "https://www.nike.com/w/usa-10ciy",
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "buy nike usa",
"keyword_length": 3,
"url": "https://www.nike.com/men",
"position": 4,
"types": [
"related_search",
"ads_bot",
"pic",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 89600000,
"cost": 2.3700000000000001,
"concurrency": 100,
"region_queries_count": 20,
"region_queries_count_wide": null,
"geo_names": [
"usa"
],
"traff": 2,
"difficulty": null,
"first_position": 1,
"first_url": "https://www.nike.com/w/usa-10ciy",
"dynamic": null,
"intents": [
"commercial"
]
}
],
"summary_info": {
"page": 1,
"total": 39,
"left_lines": 499514
}
}
}