Audit

Audit status

Request format

GET /audit/{site_id}

Result

If successful, the server returns the status of the audit.

Example

{
    "status": "finished",
    "start_time": "2018-06-15 12:41:13",
    "audit_time": "2018-09-11 16:13:41",
    "total_pages": 10,
    "total_warnings": 71,
    "total_errors": 21,
    "total_passed": 810
}

Response parameters

Name Description
status cancelled; expired – the last audit was conducted more than 3 months ago; queued; processing – the audit is in progress; finished – the audit has been completed.
start_time Audit start time
audit_time Audit end time
total_pages Total number of scanned pages
total_warnings Total number of warnings
total_errors Total number of critical errors
total_passed Total number of passed checks

Audit report

Data is available only if the audit has been completed ("is_finished": true)

Request format

GET /audit/{site_id}/report

Result

  • "is_finished": true – available data for the audit report.
  • "is_finished": false – if the audit is not completed.

Example

{
    "is_finished": false
}
{
    "is_finished": true,
    "domain_props": {
        "archiveOrg": "2003-02-26",
        "backlinks": "4",
        ….
    },
    "sections": [
        {
            "uid": "tech_audit",
            "name": "Section name",
            "props": [
                {
                    "code": "_images_500_count",
                    "status": "passed",
                    "name": "Image with 5xx status",
                    "value": "0"
                },
        …],
    ...
    ],
    "score_percent": 79,
    "total_pages": 10,
    "total_warnings": 71,
    "total_errors": 21,
    "total_passed": 810,
    "screenshot": "http://host/screenshots/147683.jpg",
    "audit_time": "2018-09-11 16:13:41"
}

Response parameters

Name Description
is_finished Audit status
domain_props Domain information. Possible parameters
Name Description
avgLoadSpeed Average page load speed
archiveOrg Age in archive.org
expdate Domain expiration date
IpCountry Country
ip IP
yandex_x Yandex X
mozDomainAuthority Moz DA
AlexaRank Alexa Rank
backlinks Backlinks
index_google Pages in Google
index_bing Pages in Bing
index_yahoo Pages in Yahoo
index_yandex Pages in Yandex
score_percent Rating in %
screenshot Screenshot link
audit_time Audit end time
total_pages Total number of scanned pages
total_warnings Total number of warnings
total_errors Total number of critical errors
total_passed Total number of passed checks
sections Audit sections
uid Section ID
name Section name
props List of section checks
Name Description
status warning | error | passed
code Check code (only in the following sections: uid = props_*)
value Check value (only in the following sections: uid = props_*)

List of pages

The method allows to get a list of pages for the specified check.

Request format

GET /audit/{site_id}/links?code={code}&limit=100&offset=10

Request parameters

Name Required Description
code Yes Refer to GET /audit/{site_id}/report
limit No Total number of links. Max number of links – 100
offset No Offset value

Result

If successful, the server returns the list of pages for the specified check.

Example

{
    "total_urls": 10,
    "urls": [
        {
            "id": 1248462,
            "url": "https://seranking.com/"
        },
        ...
    ],
    "urls_type": "urls_and_sources"
}
"total_urls": 10,
"urls": [
    "https://seranking.com/keyword-suggestion-tool.html",
    ...
],
"urls_type": "simple_urls_array"
{
    "total_urls": 2,
    "urls": {
        "Online SEO Tools by SE Ranking": {
        "found_on_urls": [
            {
                "url": "https://seranking.com/position-tracking.html",
                "id": "1248466",
                "cnt": "10"
            },
            ...
        ],
    }

    ,
    "urls_type": "duplicate_props"
}

Response parameters

Name Description
total_urls Total number of URLs
urls List of URLs. The format of the list depends on the type of check
urls_type List type simple_urls_array duplicate_props urls_and_single_source urls_and_sources

Errors

HTTP code Error message
400 Invalid code

Audit history

Request format

GET /audit/{site_id}/history?date=2018-06-01

Request parameters

Name Required Description
date Yes Audit date

Example

{
    "audit_time": "2018-06-01 13:25:29",
        "domain_data": {
        "age": "1",
        "AlexaRank": "22",
        "archiveOrg": "ew",
        "AvoidInterstitials": "1",
        "AvoidInterstitials_mobile": "1",
        "AvoidLandingPageRedirects": "1",
        "AvoidLandingPageRedirects_mobile": "1",
        "AvoidPlugins": "1",
        "AvoidPlugins_mobile": "1",
        "commonHomepageVars": "0",
        "ConfigureViewport": "1",
        "ConfigureViewport_mobile": "1",
        "Correct404Pages": "1",
        "EnableGzipCompression": "0",
        "EnableGzipCompression_mobile": "1",
        "expdate": "2018-10-10",
        "HasFavicon": "1",
        "hasFlash": "0",
        "hasHttps": "0",
        "hasRobotsTxt": "1",
        "HasSeofriendlyUrls": "1",
        "hasXmlSitemap": "1",
        "index_yahoo": "1",
        "index_yandex": "9",
        "ip": "148.251.49.8",
        "IpCountry": "Germany",
        "IsSafeBrowsing": "1",
        "LeverageBrowserCaching": "0",
        "LeverageBrowserCaching_mobile": "0",
        "MainResourceServerResponseTime": "1",
        "MainResourceServerResponseTime_mobile": "1",
        "MinifyCss": "1",
        "MinifyCss_mobile": "1",
        "MinifyHTML": "0",
        "MinifyHTML_mobile": "1",
        "MinifyJavaScript": "0",
        "MinifyJavaScript_mobile": "1",
        "MinimizeRenderBlockingResources": "0",
        "MinimizeRenderBlockingResources_mobile": "0",
        "mozDomainAuthority": null,
        "mozLinks": null,
        "mozPageAuthority": null,
        "MozRank": null,
        "OnYandexCatalog": "0",
        "OptimizeImages": "0",
        "OptimizeImages_mobile": "0",
        "PrioritizeVisibleContent": "1",
        "PrioritizeVisibleContent_mobile": "1",
        "SizeContentToViewport": "1",
        "SizeContentToViewport_mobile": "1",
        "SizeTapTargetsAppropriately": "1",
        "SizeTapTargetsAppropriately_mobile": "1",
        "UseLegibleFontSizes": "1",
        "UseLegibleFontSizes_mobile": "1",
        "WwwRedir": "0",
        "avgLoadSpeed": "117.4000"
    },
        "settings": {
        "schedule_type": "manual",
        "schedule_day": 1,
        "schedule_hour": 1,
        "schedule_wday": 1,
        "source_site": 1,
        "source_subdomain": 0,
        "source_sitemap": "0",
        "source_file": 0,
        "check_robots": "1",
        "ignore_params": 0,
        "custom_params": "utm_source, utm_medium, cid, PHPSESSID",
        "user_agent": 0,
        "login": "",
        "password": "",
        "max_depth": 10,
        "max_req": "5",
        "min_title_len": 10,
        "max_title_len": 70,
        "min_description_len": 50,
        "max_description_len": 320,
        "max_h1_len": 60,
        "max_h2_len": 60,
        "min_words": "500",
        "max_links": "10",
        "max_size": "10",
        "max_redirects": "3",
        "max_pages": "10"
    },
        "pages_data": {
        "_2xx_pagesCount": 10,
        "_3xx_pagesCount": 0,
        "_4xx_pagesCount": 0,
        "_5xx_pagesCount": 0,
        "_too_big_pagesCount": 10,
        "_too_long_url_pagesCount": 0,
        "_blocked_by_robotstxt_pagesCount": 0,
        "_blocked_by_xrobots_pagesCount": "0",
        "_blocked_by_nofollow_pagesCount": 0,
        "_meta_refresh_pagesCount": 0,
        "_rel_canonical_pagesCount": 8,
        "_no_rel_canonical_pagesCount": 2,
        "_duplicate_canonical_pagesCount": 0,
        "_duplicate_canonical_tag": 0,
        "_rel_alternate_pagesCount": 10,
        "_hreflang_pagesCount": 10,
        "_no_hreflang_pagesCount": 0,
        "_error_hreflang_pagesCount": 0,
        "_duplicate_title_pagesCount": 0,
        "_no_title_pagesCount": 0,
        "_long_title_pagesCount": 0,
        "_short_title_pagesCount": 0,
        "_no_descr_pagesCount": 0,
        "_duplicate_descr_pagesCount": 0,
        "_short_descr_pagesCount": 0,
        "_long_descr_pagesCount": 0,
        "_duplicate_content_pagesCount": 0,
        "_low_word_count_pagesCount": 0,
        "_h1_empty_pagesCount": 0,
        "_no_h1_pagesCount": 0,
        "_long_h1_pagesCount": 1,
        "_duplicate_h1_pagesCount": 0,
        "_h2_empty_pagesCount": 0,
        "_no_h2_pagesCount": 0,
        "_long_h2_pagesCount": 2,
        "_many_ext_links_pagesCount": 10,
        "_many_redirects_links": 0,
        "_int_links_no_title_count": 0,
        "_ext_links_no_title_count": 40,
        "_int_links_nofollow_count": 343,
        "_ext_links_nofollow_count": 101,
        "_no_intlinks_pagesCount": 0,
        "_ext_links_dofollow_count": 68,
        "_ext_links_400_count": 0,
        "_ext_links_500_count": 0,
        "_ext_links_all_count": 169,
        "_sitemap_links_all_count": 44,
        "_images_no_alt_count": 18,
        "_images_400_count": "0",
        "_images_500_count": "0",
        "_trailing_slashes": 0,
        "_frames_count": 0,
        "_flash_pages_count": 0
    },
    "totals": {
        "total_pages": 10,
        "total_warnings": 70,
        "total_errors": 22,
        "total_passed": 830
    }

Response parameters

Name Description
audit_time Audit end time
domain_data Parameters related to the domain and to the site as a whole
settings Settings (the parameter may be missing if the site settings were not set separately)
pages_data Page check parameters
totals Refer to GET /audit/{site_id}
By continuing to use this site you consent to the use of cookies in accordance with our Cookie policy. close notification