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

Domain Top Pages (get_top_urls)

API v3 methods will be unavailable from 03/01/2022. Use a similar API v4 method.

The get_top_urls method returns website pages in hierarchical order. Also, it shows the number of keywords from Google top-100 or Yandex top-50 for each URL, approximate traffic of the page and Facebook shares. The data set is similar to the Top pages report of the Domain Analysis.

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)

Following parameters can be used for sorting:
sort: field that needs to be sorted
order: sorting order (asc - ascending, desc -  descending)

Response parameters
Parameter Description
result Contains the answer
total The total number of the website pages
Contains the answer
url URL of the domain
organic_keywords The number of keywords the URL ranks for in Google top-100 or Yandex top-50 results
facebook_shares The number of Facebook shares of the researched domain's page
potencial_traff The approximate traffic of the page by keywords depending on its volume and position
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:

    "url": "",
    "organic_keywords": 65134,
    "facebook_shares": 701305,
    "potencial_traff": 39481276

Request data:

Response data:

    "result": {
        "total": 147181,
        "hits": [
                "url": "",
                "organic_keywords": 65134,
                "facebook_shares": 701305,
                "potencial_traff": 39481276
                "url": "",
                "organic_keywords": 20392,
                "facebook_shares": 614,
                "potencial_traff": 121679
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 997717

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.




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

Thank you, we have saved your new mailing settings.

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

Open support chat