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 |
{
"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"]
}
}
{
"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
}
}
}