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

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