Останні звіти

Метод SerpstatReportsProcedure.getLatestReports дозволяє отримати інформацію про згенеровані звіти користувача та завантажити їх. Дані аналогічні до звіту «‎Останні звіти».

Загальні параметри запиту

Параметри запиту
Параметр	Опис	Тип даних	Опціональний	Значення за замовчуванням	Варіанти значень
id	Идентифікатор запиту: відповідь містить цей самий ідентифікатор.	int/string	ні		Текстове або числове значення
method	Назва методу API	string	ні		SerpstatReportsProcedure.getLatestReports
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]		так
filters	Умови фільтрації	array	так		"query" – фільтр за вмістом запиту у назві звіту. Наприклад: "query": "some string value"
sort	Порядок сортування результатів	array	так	"date": "desc"	"date" – сортування за датою, "se" – за пошуковою базою, "status" – статусом звіту, "query" – за назвою, "format" – за форматом (asc — за зростанням, desc — за спаданням)
page	Номер сторінки у відповіді	int	так	1	"page": 1 (будь-яке числове значення)
size	Кількість результатів на сторінці у відповіді	int	так	20	"size": 10 (будь-яке числове значення) min: 1, max: 100

Параметри відповіді
Параметр	Опис
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	Кількість результатів на сторінці у відповіді

Ліміти за цей метод не знімаються.

Example

Request data:

{
    "id": 1,
    "method": "SerpstatReportsProcedure.getLatestReports",
    "params": {
                "filters": {"query": ""},
                "sort": {"status": "desc"},
                "page": 1,
                "size": 20
    }
}

Response data:

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