Sign in Sign Up

This site uses cookies and other tracking technologies to make possible your usage of the website, assist with navigation and your ability to provide feedback, analyse your use of our products and services, assist with our promotional and marketing efforts, and provide better user experience.

By using the website, you agree to our Privacy policy

Report a bug

Cancel
839 5
News 10 min read July 21, 2020

How To Automate Searching For Technical Issues: Leave All Your Work To Our API

How To Discover A Competitor's Budget For Contextual Advertising: 3 Unusual Methods
Pavel Alekseev
Pavel Alekseev
Product/Project Manager at Serpstat
Following the introduction of the Links Intersection report, we want to please you with another feature that everyone has been waiting for a long time - the ability to use Site Audit via API! This is an important update that will make your work much more comfortable and faster and save tons of time and money. Let's find out how Audit API can help you.
Note! Site Audit is now available in Serpstat API. You can search for technical issues on the site through the API and receive a JSON format response. By the way, the audit documentation is based on Postman, a free program for launching API.

Why do you need API and what are its advantages
API (Application Programming Interface) allows users to access specific functions or components of a tool. The API lets you query the Serpstat server and retrieve data without having to use the tool's interface.

API Serpstat covers Website Analysis, Keyword Analysis, Site Audit, Backlink Analysis. Such businesses as Flatfy, WebXpage, Accesstrade are already using Serpstat API to approach their goals.

You can use the API as part of your plan with the following features:
Key features of using Audit API:
Possibility to upload and analyze a large amount of data.
Automation of routine SEO processes for searching and
fixing errors.
Saving time for the development of additional integrations.
Creation of custom reports and dashboards.
Aggregating audit results and generating your own reports.
Working with data: there is no need to go to the Serpstat interface to view the report, you can use the API method and see the result.
Now, I'll tell you about the methods that allow you to automate the site check for errors.

How to get started with API
I'll show you how to work with the Audit API using one of the reports as an example:
1
Create a request for an entry point using the Postman interface.
2
Then confirm that you are a Serpstat user by entering your token. The key can be found in your personal account.
3
Copy the token and enter the server URL field instead of {{token}}.
Line: http://api.serpstat.com/v4/?token= {{{token}}
Личный кабинет Serpstat
{
    "id":1,
    "method":"AuditSite.start",
    "params":{
        "projectId":669214
    },
    "jsonrpc":"2.0"
}

How to audit a website using Serpstat API
To send a request to the Serpstat servers, you need to specify the method that you want to use. In this example, I'll show you how to use the .getBasicInfo method:
{
 "id":1,
 "method": "auditProjectReport.getBasicInfo",
 "params":{
  "reportId":400696
  },
  "jsonrpc": "2.0"
}
Report details:

Method - shows what data we get in the final report.
ReportId is the ID of the audit report.

This is how the report looks like:
{
    "id": "1",
    "result": {
        "reportId": 400696,
        "date": "2019-03-18 17:58:25",
        "sdo": 79,
        "highCount": 20,
        "mediumCount": 618,
        "lowCount": 124,
        "informationCount": 580,
        "virusesCount": 0,
        "specialStopReason": 3,
        "checkedPageCount": 50,
        "totalCheckedPageCount": 51,
        "redirectCount": 200,
        "captchaDetected": true
    },
    "jsonrpc": "2.0"
}
Where:
reportId(int) — report identifier.
date(string) — start date of the report.
sdo(int) — SDO.
highCount(int) — number of high priority issues.
mediumCount(int) — number of medium priority issues.
lowCount(int) — number of low priority issues.
InformationCount(int) — number of information priority issues.
virusesCount(int) — number of pages with viruses.
specialStopReason(int) — stop reason code.
checkedPageCount(int) — number of pages checked.
totalCheckedPageCount(int) — URLs checked (pages, redirects, images, etc).
redirectCount(int) — the number of pages where redirect was found.
captchaDetected(boolean) — captcha found during crawling.
In the report, you will find information on SDO - Serpstat Domain Rank; the number of High, Medium, Low, Information checks; the number of pages where malware was detected.

What API methods are available for audit
There are currently 14 Site Audit methods available that correspond to the Serpstat interface. Let's take a look at each method.

Start, stop, basic information:
AuditSite.start - starting audit according to the settings saved earlier.
AuditSite.getList - getting a list of audits performed by project ID. Also, for each of the reports, you can get a list of basic data: SDO, the number of scanned pages, the number of checks of different categories.
AuditSite.stop - canceling a running audit.
AuditSite.getBasicInfo - getting basic information on the report.
Settings:
AuditSite.getDefaultSettings - getting a list of all default values for all settings. This procedure is necessary so that when working with an audit, you can select the default settings.
AuditSite.getSettings - getting all settings for a specific project: you can view an array of settings for the specified project.
AuditSite.setSettings - saving all settings at once: you can save an array of settings for a specified project.
AuditSite.getScanUserUrlList - getting a list of imported or manually typed links for scanning. If the crawling type was specified at a given URL, then you can get a list of the URLs that were audited using this procedure.
Processing:
AuditSite.getHistoryByCountError - data on the number of errors for the requested audit from all project reports.
AuditSite.getReportWithoutDetails - list of all error categories for the requested report without error details.
AuditSite.getErrorElements - elements of the requested error.
AuditSite.getSubElementsByCrc - subelements of the requested error.
Statistics:
AuditSite.getCategoriesStatistic - getting statistics by categories.
Export:
AuditSite.export - the procedure for starting the formation of an export file in the Summary report.
Also, in addition to the API methods described above, we have an API Console for those who want to work with the API, but do not have programming skills.

How to use the API via Postman: 5 easy steps for newbies
In conclusion, I want to show you simple instructions for using the API via Postman. It will be useful for those who were inspired by our new tool but have not yet tried working with the API.

Follow these simple steps and upload data at lightning speed:
1
First you need to download Postman. This software is free.
2
Next, run the program and, if necessary, create an account.
3
Create a new request:
профиль serpstat скопировать токен
4
Next, we proceed to configuring the request:
type of request — POST
in the tab body choose raw, then — JSON.
5
Fill in the request address and insert your token.
профиль serpstat скопировать токен
6
Next, fill in the request body.
профиль serpstat скопировать токен
7
Send a request and get the result:
профиль serpstat скопировать токен
Whether you are an advanced API user or no, this start guide will make your SEO tasks a lot easier, especially if you need a quick analysis of the site for errors. Stay tuned for updates to this article to learn more about the capabilities of the Serpstat API.

Learn how to get the most out of Serpstat

Want to get a personal demo, trial period or bunch of successful use cases?

Send a request and our expert will contact you ;)

Rate the article on a five-point scale

The article has already been rated by 1 people on average 5 out of 5
Found an error? Select it and press Ctrl + Enter to tell us

Share this article with your friends

Sign In Free Sign Up

You’ve reached your query limit.

Or email
Forgot password?
Or email
Optional
Back To Login

Don’t worry! Just fill in your email and we’ll send over your password.

Are you sure?

Awesome!

To complete your registration you need to enter your phone number

Back

We sent confirmation code to your phone number

Your phone Resend code Queries left

Something went wrong.

Contact our support team
Or confirm the registration using the Telegram bot Follow this link
Please pick the project to work on

Personal demonstration

Serpstat is all about saving time, and we want to save yours! One of our specialists will contact you and discuss options going forward.

These may include a personal demonstration, a trial period, comprehensive training articles & webinar recordings, and custom advice from a Serpstat specialist. It is our goal to make you feel comfortable while using Serpstat.

Name

Email

Phone

We are glad of your comment
Upgrade your plan

Upgrade your plan

Export is not available for your account. Please upgrade to Lite or higher to get access to the tool. Learn more

Sign Up Free

Спасибо, мы с вами свяжемся в ближайшее время

Invite
View Editing

E-mail
Message
Optional
E-mail
Message
Optional

You have run out of limits

You have reached the limit for the number of created projects. You cannot create new projects unless you increase the limits or delete existing projects.

I want more limits