Останні звіти
Метод SerpstatReportsProcedure.getLatestReports дозволяє отримати інформацію про згенеровані звіти користувача та завантажити їх. Дані аналогічні до звіту «Останні звіти».
Параметри запиту | |||||
Параметр | Опис | Тип даних | Опціональний | Значення за замовчуванням | Варіанти значень |
id | Идентифікатор запиту: відповідь містить цей самий ідентифікатор. | int/string | ні | Текстове або числове значення | |
method | Назва методу API | string | ні | SerpstatReportsProcedure.getLatestReports | |
params | Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] | так |
| ||
filters | Умови фільтрації | array | так |
| "query" – фільтр за вмістом запиту у назві звіту. Наприклад: "query": "some string value" |
sort | Порядок сортування результатів | array | так | "date": "desc" | "date" – сортування за датою, |
page | Номер сторінки у відповіді | int | так | 1 | "page": 1 (будь-яке числове значення) |
size | Кількість результатів на сторінці у відповіді | int | так | 20 | "size": 10 (будь-яке числове значення) |
Параметри відповіді | |
Параметр | Опис |
id | Ідентифікатор відповіді: відповідає id в запиті |
result | Містить у собі відповідь |
data | Масив з даними відповіді |
format | Формат звіту. Можливі варіанти: csv – формат файлу даних з розділювачами-комами, csv_cp1251 – формат файлу даних з розділювачами-комами та з кодуванням cp1251, gdrive – формат файлу який зберігається на Google Drive, kv_xls – формат експорту списку помилок валідації у кластеризації Serpstat, відповідає формату xls, mgxlsx_mfiles – формат експорту аудиту Serpstat, відповідає формату xlsx, mgxlsx – формат експорту аудиту Serpstat, відповідає формату xlsx, pdf – універсальний файловий формат переносимих документів, pupetter_pdf – формат файлу, який генерує pdf з html сторінки, xlsx – XML-формат файлу Microsoft Excel, xls – формат файлу Microsoft Excel. |
status | Статус звіту -1 – помилка генерації 0 – генерація в процесі 1 – згенерований, але не скачаний 2 – згенерований та скачаний 3 – перевищена кількість лімітів 4 – видалений користувачем |
created | Дата створення звіту |
query | Назва звіту |
request | Назва запиту, за яким згенеровано звіт. Наприклад Audit_Dashboard, backlink_top_pages та інші. |
se | Пошукова база, за якою був згенерований звіт |
file | Посилання на завантаження звіту |
summary_info | Об'єкт з даними відповіді |
left_lines | Кількість API рядків, що залишилися |
total_reports | Кількість звітів на акаунті користувача |
sort | Застосоване сортування |
page | Номер сторінки у відповіді |
size | Кількість результатів на сторінці у відповіді |
Ліміти за цей метод не знімаються.
{
"id": 1,
"method": "SerpstatReportsProcedure.getLatestReports",
"params": {
"filters": {"query": ""},
"sort": {"status": "desc"},
"page": 1,
"size": 20
}
}
{
"id": "1",
"result": {
"data": [
{
"format": "csv",
"status": "1",
"created": "2022-11-16 06:44:28",
"query": "premierleague.com",
"request": "positions",
"se": "Google.UK",
"file": "https://docs.serpstat.com/files/reports/5/positions_premierleague_com-2022-11-16_06-44-32_Google_UK.63746ab0a8707.csv"
},
{
"format": "csv",
"status": "1",
"created": "2022-11-16 06:46:52",
"query": "manutd.com",
"request": "urls_with_shares",
"se": "Google.UK",
"file": "https://docs.serpstat.com/files/reports/52/urls_with_shares_manutd_com-2022-11-16_06-46-53_Google_UK.63746b3d25c83.csv"
},
{
"format": "mgxlsx",
"status": "1",
"created": "2022-11-17 01:30:46",
"query": "teepublic.com-2022-11-17-00-03_report",
"request": "Audit_Dashboard",
"se": "",
"file": "https://docs.serpstat.com/files/reports/81/Audit_Dashboard_teepublic_com-2022-11-17-00-03_report-2022-11-17_01-30-47_Google_UA.637572a76043a.xlsx"
},
{
"format": "gdrive",
"status": "1",
"created": "2022-11-21 06:56:23",
"query": "twitter.com",
"request": "positions",
"se": "Google.UA",
"file": "https://drive.google.com/open?id=1e-XxOPi9qkd2HOXbvF4jwtvNndrdO9gVDJ5afmBg02s"
}
],
"summary_info": {
"left_lines": 1000000,
"total_reports": 4,
"sort": {
"status": "desc"
},
"page": 1,
"size": 20
}
}
}