Get access to 30+ marketing and SEO tools. analyze competitors, keywords, and backlinks for free..
Sign in Sign Up

We use cookies to make Serpstat better. By clicking "Accept cookies", you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts. Learn more

URL Organic Keywords (url_keywords)

API v3 methods will be unavailable from 12/31/2021. Use a similar API v4 method.

The url_keywords method returns keywords that URL ranks for in Google top-100 or Yandex top-50 search results. The data set is similar to the URL analysis — SEO research  Keywords report. You can get up to 60 000 results in this report.

General request parameters and instructions for using Serpstat API

Following parameters can be used for pagination:
page_size: number of results per page (default: 100, max: 1000);
page: page number (set to the 1st page by default).

You can use the following parameters to filter the results:

Parameter Description Possible settings
position_from min position for a keyword  1-100
position_to max position for a keyword  1-100
queries_from min number of monthly searches  0-100,000,000
queries_to max number of monthly searches  0-100,000,000
cost_from min CPC  0-200
cost_to max CPC  0-200
concurrency_from min level of competition  1-100
concurrency_to max level of competition  1-100
right_spelling filtering by misspelled keywords 

not_contains - contains misspelled keywords;

contains - does not contain misspelled keywords

To sort the results apply following parameters:
sort: field that needs to be sorted;
order: sorting order (asc - ascending, desc -  descending).

Response parameters
Parameter Description
result Contains the answer
total Number of keywords for which the page ranks in top-100
hits Contains the answer
domain Domain
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 of a page which appears in SERP for the keyword
position URL's position for a keyword
types A list of special elements shown in SERP (for example, video, carousel or map)
found_results The number of results found for keyword
cost Cost per click, $
concurrency Keyword competition in PPC (0-100%)
region_queries_count Search volume in selected search engine database
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%)
dynamic How the position of this keyword has changed
status_msg Response "Ok" or "Error" report on a successful or unsuccessful request
status_code Response code 200 — successful request. Errors occur when credits are exceeded (number of simultaneous requests or account credits)
left_lines API credits remaining

Part of the API response for which you spend 1 credit:

{
    "domain": "nike.com",
    "subdomain": "www.nike.com",
    "keyword": "man nike",
    "keyword_length": 2,
    "keyword_id": "136766933",
    "keyword_crc": -686015656,
    "url": "https://www.nike.com/men",
    "position": 1,
    "types": [
        "snip_breadcrumbs"
        ],
    "found_results": 564000000,
    "cost": 0.38,
    "concurrency": 100,
    "region_queries_count": 40500,
    "region_queries_count_wide": 0,
    "url_crc": 866156381,
    "geo_names": [],
    "traff": 6071,
    "difficulty": null,
    "dynamic": 0,
    "modified_date": "2021-07-06",
    "_id": "136766933-1"
},

Example PHP
Request data:

api.serpstat.com/v3/url_keywords?query=https://nike.com/men&token=XXX&se=g_us

Response data:
{
    "result": {
        "total": 2805,
        "hits": [
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "man nike",
                "keyword_length": 2,
                "keyword_id": "136766933",
                "keyword_crc": -686015656,
                "url": "https://www.nike.com/men",
                "position": 1,
                "types": [
                    "snip_breadcrumbs"
                ],
                "found_results": 564000000,
                "cost": 0.38,
                "concurrency": 100,
                "region_queries_count": 40500,
                "region_queries_count_wide": 0,
                "url_crc": 866156381,
                "geo_names": [],
                "traff": 6071,
                "difficulty": null,
                "dynamic": 0,
                "modified_date": "2021-07-06",
                "_id": "136766933-1"
            },
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "mens nike",
                "keyword_length": 2,
                "keyword_id": "24277413",
                "keyword_crc": 1677651061,
                "url": "https://www.nike.com/men",
                "position": 1,
                "types": [
                    "snip_breadcrumbs"
                ],
                "found_results": 82,
                "cost": 0.38,
                "concurrency": 100,
                "region_queries_count": 40500,
                "region_queries_count_wide": 0,
                "url_crc": 866156381,
                "geo_names": [],
                "traff": 6071,
                "difficulty": 81.587239436767788,
                "dynamic": 0,
                "modified_date": "2021-07-06",
                "_id": "24277413-1"
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 998847
}