List of carried out audits (getList)

getList — method provides you with a list of audits carried out by project id.

Request parameters
Parameters	Value	Description
id	any number or string	Request id
method	getList	API method name
params	{...}	Array of parameters
projectId (important)	number	Audit project id
limit (important)	number	Limit of chosen data
offset (important)	number	Offset of chosen data

Response parameters
Parameters	Description
id	Request id
result	Contains the answer
data	Array of data
reportId	Report id
date	Data
sdo	Serpstat Domain Optimization score
pagesLimit	What scan limit was set
pagesScanned	Number of checked pages (charged limits)
criticalCount	Number of critical errors
nonCriticalCount	Number of non-critical errors
virusesCount	Number of pages with viruses

Reports are set in order from the newest to the latest: recently carried out audit tops the list.

Example PHP Python

Request data:

{
 "id":1,
 "method": "AuditSite.getList",
 "params":{
  "projectId": {{projectId}},
  "limit":3,
  "offset":0
    
  },
  "jsonrpc": "2.0"
}

Response data:

{
    "id": "1",
    "result": [
        {
            "reportId": 400926,
            "date": "2019-04-05 12:58:08",
            "sdo": 0,
            "pagesLimit": 54321,
            "pagesScanned": 282,
            "criticalCount": 0,
            "nonCriticalCount": 0,
            "virusesCount": 0
        },
        {
            "reportId": 400925,
            "date": "2019-04-05 12:53:31",
            "sdo": 100,
            "pagesLimit": 54321,
            "pagesScanned": 0,
            "criticalCount": 0,
            "nonCriticalCount": 0,
            "virusesCount": 0
        },
        {
            "reportId": 400924,
            "date": "2019-04-05 12:49:30",
            "sdo": 98,
            "pagesLimit": 54321,
            "pagesScanned": 0,
            "criticalCount": 1,
            "nonCriticalCount": 0,
            "virusesCount": 0
        }
    ],
    "jsonrpc": "2.0"
}

<?php
$client = new http\Client;
$request = new http\Client\Request;
$request->setRequestUrl('http://api.serpstat.com/v4/?token={{token}}');
$request->setRequestMethod('POST');
$body = new http\Message\Body;
$body->append('{
 "id": "",
 "method": "AuditSite.getList",
 "params": {
     "projectId":38212,
     "limit":3,
     "offset":0
  }
}');
$request->setBody($body);
$request->setOptions(array());
$request->setHeaders(array(
  'Content-Type' => 'application/json'
));
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();