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

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

By using the website, you agree to our Privacy policy

Sign in Sign Up

Obtaining the list of pages and their positions by domain (getUrlsSerpResultsHistory)

getUrlsSerpResultsHistory method returns links and their positions for domain by region.

Request parameters
Pararmeter Value Description
id any number or string Request ID
method RtApiSerpResultsProcedure.getUrlsSerpResultsHistory API method name
params {...} Array of parameters
projectId number Project ID
projectRegionId number Region ID
page number Page number. 1 by default
pageSize (optional) number (20,50,100,200,500) Number of results per page. 100 by default
dateFrom (optional) date (yyyy-mm-dd) Start date of the period for which the data is required
dateTo (optional) date (yyyy-mm-dd) End date of the period for which the data is required
sort (optional) string (date  by date,
keyword  alphabetically)
Sorting by parameters
order (optional) string (desc  descending,
asc  ascending)

Sorting order. Descending order by default

keywords (optional) array:[“string”]

Keywords for which pages and positions are required. The maximum number of keywords that can be filtered is 1000.

domain (optional) string (domain.com  domain,
https://domain.com/  page)
Domain or page for which the data is required. By project domain by default

Response parameters
Parameter Description
id Request ID
result Contains the answer
projectId Project ID
projectRegionId Region ID
domain Domain or page for which the search results are requested
keywords Array of keywords
keyword Keyword with data
history Array of dates with search results by keyword
date Search results date
positions Array of positions with domain or page
position Position
url Page
summary info Summary data block
page Current page
page_total Number of pages with the results for the selected parameter page size
count Number of results per page
total Total number of results
sort Sorting by parameters
order Sorting order

Example PHP Python
Request data:
{
    "id": 1,
    "method": "RtApiSerpResultsProcedure.getUrlsSerpResultsHistory",
    "params": {
        "projectId": 704912,
        "projectRegionId": 259628,
        "page": 1,
        "pageSize": 500,
        "dateFrom": "2020-05-07",
        "dateTo": "2020-05-08",
        "sort": "date",
        "order": "desc",
        "keywords": [],
        "domain": "https://www.avito.ru/rsmarket24/rossiya/bytovaya_tehnika/dlya_kuhni/holodilniki_i_morozilnye_kamery?s_trg=7&s=1&utm_source=yandex&utm_medium=cpc&utm_campaign=holodilniki_avito_poisk&utm_term=авито холодильник&roistat=direct2_search_7016883518_авито холодильник&roistat_referrer=none&roistat_pos=premium_1&yclid=2444208711193363538"
    }
}

Response data:
{
    "id": "1",
    "result": {
        "projectId": 650046,
        "projectRegionId": 248789,
        "domain": "seasonvar.ru",
        "keywords": [
            {
                "keyword": "пастор сизонвар",
                "history": [
                    {
                        "date": "2020-08-14",
                        "positions": [
                            {
                                "position": 1,
                                "url": "http://seasonvar.ru/serial-8836-Prepodobnyj-2-season.html"
                            },
                            {
                                "position": 2,
                                "url": "http://seasonvar.ru/serial-8835-Prepodobnyj-1-season.html"
                            },
                            {
                                "position": 3,
                                "url": "http://seasonvar.ru/serial-11928-Samozvanetc.html"
                            },
                            {
                                "position": 4,
                                "url": "http://seasonvar.ru/serial-23967-Svyatoj_Majk.html"
                            },
                            {
                                "position": 5,
                                "url": "http://seasonvar.ru/serial-21103-Otetc_Braun_2013-7-season.html"
                            },
                            {
                                "position": 6,
                                "url": "http://seasonvar.ru/serial-6241-Otetc_Braun_2013.html"
                            },
                            {
                                "position": 7,
                                "url": "http://seasonvar.ru/serial-11145-Otetc_Braun_2013-3-season.html"
                            },
                            {
                                "position": 8,
                                "url": "http://seasonvar.ru/serial-24215-Svyatoj_Majk-2-season.html"
                            },
                            {
                                "position": 9,
                                "url": "http://seasonvar.ru/serial-24504-Otetc_Braun_2013-8-season.html"
                            },
                            {
                                "position": 10,
                                "url": "http://seasonvar.ru/serial-22219-Neporochnyj-2-season.html"
                            }
                        ]
                    },
                 "summary_info": {
                    "page": 1,
                    "page_total" : 150, 
                    "count" : 100, 
                    "total": 100, 
                    "sort": null, 
                    "order": null 
                   }
               }
           }

Share this article with your friends

Sign In Free Sign Up

You’ve reached your query limit.

Or email
Forgot password?
Or email
Optional
Back To Login

Don’t worry! Just fill in your email and we’ll send over your password.

Are you sure?

Awesome!

To complete your registration you need to enter your phone number

Back

We sent confirmation code to your phone number

Your phone Resend code Queries left

Something went wrong.

Contact our support team
Or confirm the registration using the Telegram bot Follow this link
Please pick the project to work on

Personal demonstration

Serpstat is all about saving time, and we want to save yours! One of our specialists will contact you and discuss options going forward.

These may include a personal demonstration, a trial period, comprehensive training articles & webinar recordings, and custom advice from a Serpstat specialist. It is our goal to make you feel comfortable while using Serpstat.

Name

Email

Phone

We are glad of your comment
Upgrade your plan

Upgrade your plan

Export is not available for your account. Please upgrade to Lite or higher to get access to the tool. Learn more

Sign Up Free

Спасибо, мы с вами свяжемся в ближайшее время

Invite
View Editing

E-mail
Message
Optional
E-mail
Message
Optional

You have run out of limits

You have reached the limit for the number of created projects. You cannot create new projects unless you increase the limits or delete existing projects.

I want more limits