Obtaining the search results history in region by keywords (getKeywordsSerpResultsHistory)

getKeywordsSerpResultsHistory method returns top 100 search results in Google and top 50 search results in Yandex by region and project keywords.

Request parameters
Parameter	Value	Description
id	any number or string	Request ID
method	RtApiSerpResultsProcedure.getKeywordsSerpResultsHistory	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. Alphabetically by default
order (optional)	string (desc — descending, asc — ascendibg)	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.

Response parameters
Parameter	Description
id	Request ID
result	Contains the answer
projectId	Project ID
projectRegionId	Region ID
keywords	Array of keywords
keyword	Keywords with data
history	Array of dates with search results for keyword
date	Search results date
positions	Array of positions with domain or page
position	Position
url	URL
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.getKeywordsSerpResultsHistory",
    "params": {
        "projectId": 715910,
        "projectRegionId": 262189,
        "page": 1,
        "pageSize": 500,
        "dateFrom": "2020-05-19",
        "dateTo": "2020-05-21",
        "sort": "date",
        "order": "asc",
        "keywords": ["1"]
    }
}

Response data:

{
    "id": "1",
    "result": {
        "projectId": 650046,
        "projectRegionId": 248789,
        "keywords": [
            {
                "keyword": "игра восхождение героя",
                "history": [
                    {
                        "date": "2020-07-15",
                        "positions": [
                            {
                                "position": 1,
                                "url": "https://kanobu.ru/news/poanime-voshozhdenie-geroya-schita-vyijdet-igra-novyiglyadit-ona-neochen-417202/"
                            },
                            {
                                "position": 2,
                                "url": "https://www.youtube.com/watch?v=0gaU_4VFI4g"
                            },
                            {
                                "position": 3,
                                "url": "https://www.youtube.com/watch?v=1Pf5cdsN_d8"
                            },
                            {
                                "position": 4,
                                "url": "https://news.myseldon.com/ru/news/index/216589541"
                            },
                            {
                                "position": 5,
                                "url": "https://pdalife.ru/the-rising-of-the-shield-hero-relive-the-animation-android-a39161.html"
                            },
                            {
                                "position": 6,
                                "url": "https://ru.wikipedia.org/wiki/Восхождение_Героя_Щита"
                            },
                            {
                                "position": 7,
                                "url": "https://pikabu.ru/story/v_seti_prosyat_zapretit_voskhozhdenie_geroya_shchita_6419730"
                            },
                            {
                                "position": 8,
                                "url": "https://shield-hero.fandom.com/ru/wiki/Кизуна_Казаяма"
                            },
                            {
                                "position": 9,
                                "url": "https://vk.com/wall-51830040_46170"
                            },
                            {
                                "position": 10,
                                "url": "https://dtf.ru/anime/67365-podtverzhdeno-proizvodstvo-2-i-3-sezona-anime-voshozhdenie-geroya-shchita-tate-no-yuusha-no-nariagari"
                            }
                        ]
                    },
                 "summary_info": {
                    "page": 1,
                    "page_total" : 150, 
                    "count" : 100, 
                    "total": 100, 
                    "sort": null, 
                    "order": null 
                   }
               }
           }