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 |
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
}
}
}