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

no filtration

Filter conditions are listed in the next table

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


Filter conditions parameters

Parameter

Description

Type

Value Options

cost

Cost per click ( in US $) float "cost": 10; 
(any number value)

cost_from

Cost per click (in US $) from float "cost_from": 1;
(any number value)
cost_to Cost per click (in US $) to float "cost_to": 10;
(any number value)

position

Keyword position int "position": 1;
(whole number, 1-100)

position_from

Keyword position from int "position_from": 2;
(whole number, 1-100)
position_to Keyword position to int "position_to": 10;
(whole number, 1-100)

concurrency

Competition ( how hard is it to promote a keyword to the top from 1-100 ) int "concurrency": 7;
(whole number, 1-100)

concurrency_from

Competition from int "concurrency_from": 1;
(whole number, 1-100)
concurrency_to Competition to int "concurrency_to": 7;
(whole number, 1-100)

keyword_length

Number of words in the keyword int "keyword_length": 1;
(any number value)

difficulty

The difficulty of the keyword float "difficulty": 3;
(any number value)

difficulty_from

Difficulty from float "difficulty_from": 5;
(any number value)
difficulty_to Difficulty to float "difficulty_to": 10;
(any number value)

traff

Traffic by the keyword int "traff": 3; 
(any whole number value)

region_queries_count

Volume of the keyword by the selected region int "region_queries_count": 1000; 
(whole number, any number value)

region_queries_count_from

Volume of the keyword by the selected region from int "region_queries_count_from": 300;
(whole number, any number value)
region_queries_count_to Volume of the keyword by the selected region to int "region_queries_count_to": 2000;
(whole number, any number value)

region_queries_count_wide

Volume of the keyword in broad match  int "region_queries_count_wide": 1000;
(whole number, any number value)

region_queries_count_wide_from

Volume of the keyword in broad match from int "region_queries_count_wide_from": 100;
(whole number, any number value)
region_queries_count_wide_to Volume of the keyword in broad match to int "region_queries_count_wide_to": 1500;
(whole number, any number value)
url_contains Contains URL string "url_contains": "https://serpstat.com/" 
(any text value)
right_spelling Misspelled keywords  boolean "right_spelling": true;
"right_spelling": false;
(Contains / Does not contain)
keyword_contain Contains all (exact matching) string "keyword_contain" — serpstat;
(any text value)
keyword_not_contain Does not contain all (exact matching) string "keyword_not_contain" — serpstat;
(any text value)
keyword_contain_one_of Contains one of (exact matching) string "keyword_contain_one_of" — serpstat;
(any text value)
keyword_not_contain_one_of Does not contain one of (exact matching) string "keyword_not_contain_one_of" — serpstat;
(any text value)
keyword_contain_broad_match Contains all (broad match) string "keyword_contain_broad_match" — serpstat;
(any text value)
keyword_not_contain_broad_match Does not contain all (broad match) string "keyword_not_contain_broad_match" — serpstat;
(any text value)
keyword_contain_one_of_broad_match Contains one of (broad match) string "keyword_contain_one_of_broad_match" — serpstat;
(any text value)
keyword_not_contain_one_of_broad_match Does not contain one of (broad match) string "keyword_not_contain_one_of_broad_match" — serpstat;
(any text 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
},

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
        }
    }
}

Share this article with your friends

Are you sure?

Introducing Serpstat

Find out about the main features of the service in a convenient way for you!

Please send a request, and our specialist will offer you education options: a personal demonstration, a trial period, or materials for self-study and increasing expertise — everything for a comfortable start to work with Serpstat.

Name

Email

Phone

We are glad of your comment
I agree to Serpstat`s Privacy Policy.

Thank you, we have saved your new mailing settings.

Open support chat