Мы используем файлы cookie для обеспечения работоспособности сервиса, улучшения навигации и маркетинговых активностей Serpstat. Нажимая "Принять и продолжить", вы соглашаетесь с нашей Политика конфиденциальности

Сообщить об ошибке

Отменить
3994 10
Обновления Serpstat Читать 10 минут

Как автоматизировать поиск ошибок на сайте: Аудит сайта теперь доступен в API Serpstat

+ инструкция по настройке API через Postman для новичков
Как автоматизировать поиск ошибок на сайте: новый Аудита сайта теперь доступен в API Serpstat
Павел Алексеев
Product/Project Manager at Serpstat
Этот год стал очень продуктивным для команды модуля «Аудит сайта»: полностью обновили дизайн инструмента, перевели его на React, добавили новые проверки и в целом ускорили его работу. Однако, это еще не все новости. Недавно мы реализовали новую функцию, о которой просили многие пользователи — возможность пользоваться Аудитом через API.

В этой статье я расскажу, что это за функция и для каких отчетов она доступна. А также научу использовать API, даже если вы новичок в этом деле ;)
Важно! Аудит сайта доступен в API-Serpstat. Теперь искать ошибки на сайте можно не только с помощью интерфейса Serpstat, но также через API и получать ответ в формате JSON. Кстати, документация по аудиту основана на Postman — бесплатной программе для запуска API.

Что такое API и какие преимущества он
дает для SEO?

API (программный интерфейс приложения, интерфейс прикладного программирования) — это способ получения данных, который помогает быстро выгружать крупные объемы информации без использования интерфейса Serpstat. Также он позволяет интегрировать аналитику сервиса в свои внутренние инструменты.


API Serpstat касается модулей «Анализ сайта», «Анализ ключевых фраз», «Анализа ссылок», «Аудит сайта». Среди наших клиентов API используют крупные и малые бизнесы, агентства и независимые SEO-специалисты. В их числе Flatfy (от ЛУН), Netpeak, Inweb, SeoMarket, Ingate, WebX.page, Masgroup.

Предоставляемый нами функционал не только доступен (на тарифе Lite за $69 вы уже получаете API-лимиты), но также позволяет сэкономить целую кучу времени. Более того, в блоге есть множество обучающих материалов, которые помогут разобраться с инструментом даже тем специалистам, которые не умеют программировать, но хорошо гуглят ;)
Как автоматизировать работу интернет-маркетолога: все лайфхаки и фишки API Serpstat
Ключевые фишки использования API аудита:
1
Возможность загрузки и анализа большого количества данных.
2
Автоматизация рутинных SEO-процессов по поиску и
исправлению ошибок.
3
Экономия времени на разработку дополнительных интеграций.
4
Возможность построить дашборд на свой вкус.
5
Возможность агрегировать результаты аудита и формировать свои отчеты.
6
Возможность напрямую работать с данными: нет необходимости заходить в интерфейс Serpstat, чтобы посмотреть отчет, можно просто «дернуть» API-метод и увидеть результат.
Теперь подробнее о методах, которые позволяют автоматизировать проверку сайта на наличие ошибок.

Как начать работать с API?

Я покажу вам, как работать с API Аудита на примере одного из отчетов:
1
Создайте пост запрос на точку входа, используя интерфейс Postman.
2
Затем подтвердите, что вы являетесь пользователем Serpstat, введя свой токен. Ключ можно найти в вашем личном кабинете.
Личный кабинет Serpstat
3
Скопируйте токен и введите поле с URL-адресом сервера вместо {{token}}.
Строка: https://api.serpstat.com/v4/?token={{token}}
Личный кабинет Serpstat
{
    "id":1,
    "method":"AuditSite.start",
    "params":{
        "projectId":669214
    },
    "jsonrpc":"2.0"
}
Хотите узнать, как автоматизировать рутинные SEO-задачи с помощью API Serpstat?

Заказывайте бесплатную персональную демонстрацию сервиса, и наши специалисты вам все расскажут! ;)
Как автоматизировать поиск ошибок на сайте: Аудит сайта теперь доступен в API Serpstat 16261788421382

Как провести аудит сайта с помощью
API Serpstat?

#1

Настройка параметров

Чтобы отправить запрос на серверы Serpstat, нужно указать метод, который вы хотите использовать для работы с аудитом. В этом примере я покажу как применить метод .getBasicInfo:
{
 "id":1,
 "method": "auditProjectReport.getBasicInfo",
 "params":{
  "reportId":400696
  },
  "jsonrpc": "2.0"
}
Детали отчета:
1
Method — показывает, какие данные мы получаем в итоговом отчете.
2
ReportId — это идентификатор отчета аудита.
Так выглядит отчет по методу:
{
    "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"
}
Где:
reportId(int) — идентификатор отчета;
date(string) — дата старта отчета;
sdo(int) — SDO :-)
highCount(int) — количество ошибок высокого приоритета;
mediumCount(int) — количество ошибок среднего приоритета;
lowCount(int) — количество ошибок низкого приоритета;
InformationCount(int) — количество ошибок информационного приоритета;
virusesCount(int) — количество страниц с вирусами;
specialStopReason(int) — код причины остановки;
checkedPageCount(int) — проверено страниц;
totalCheckedPageCount(int) — проверено URL (страницы, редиректы, картинки и т.д);
redirectCount(int) — количество страниц на которых был найден редирект;
captchaDetected(boolean) — была ли капча во время парсинга.
В отчете вы найдете информацию по:
SDO — Serpstat Domain Rank;
количеству High-, Medium-, Low-, Information-проверок;
количеству страниц, где обнаружено вредоносное ПО.

Какие API-методы доступны для Аудита сайта?

В настоящее время доступно 14 методов Аудита сайта, которые соответствуют интерфейсу Serpstat.

Рассмотрим каждый метод:
Запуск, остановка, базовая информация:
1
AuditSite.start — запуск аудита. По настройкам сохраненным ранее.
2
AuditSite.getList — получение списка проведенных аудитов по идентификатору проекта. Так же для каждого из отчетов можно получить список основных данных: SDO, количество просканированых страниц, количество проверок разных категорий.
3
AuditSite.stop — остановка запущенного аудита.
4
AuditSite.getBasicInfo — получение базовой информации по отчету
Настройки:
5
AuditSite.getDefaultSettings — получение списка всех дефолтных значений по всем настройкам. Это процедура необходима для того, чтоб при работе с настройками аудита, можно было в любой момент взять настройки по умолчанию.
6
AuditSite.getSettings — получаем все настройки по конкретному проекту. С помощью нее можно просматривать массив настроек по указанному проекту.
7
AuditSite.setSettings — сохранение всех настроек Аудита за раз. С помощью нее можно сохранять массив настроек по указанному проекту.
8
AuditSite.getScanUserUrlList — список импортированных или набранных вручную линков на сканирование. Если тип сканирования указывался по заданным URL, то с помощью этой процедуры можно получить список URL, по которому был проведен аудит.
Получение и работа с отчетом:
9
AuditSite.getHistoryByCountError — данные о количестве ошибок по запрашиваемой проверке из всех отчетов проекта.
10
AuditSite.getReportWithoutDetails — список всех категорий ошибок по запрашиваемому отчету без деталей ошибок.
11
AuditSite.getErrorElements — получение элементов запрашиваемой ошибки.
12
AuditSite.getSubElementsByCrc — получение подэлементов запрашиваемой ошибки.
Статистика:
13
AuditSite.getCategoriesStatistic — получение статистики по категориям.
Экспорт:
14
AuditSite.export — процедура запуска формирования экспортного файла в Суммарном отчете.
Подробнее о методах читайте в документации.
Хотите узнать, как с помощью API Serpstat автоматизировать работу по
поиску ошибок на сайте?

Заказывайте бесплатную персональную демонстрацию сервиса, и наши специалисты вам все расскажут! ;)
Как автоматизировать поиск ошибок на сайте: Аудит сайта теперь доступен в API Serpstat 16261788421382
Также помимо API-методов, описанных выше, у нас есть API-Консоль для тех, кто хочет работать с API, но не имеет навыков программирования. Еще в Serpstat можно провести аудит одной страницы сайта.

Как использовать API через Postman:
5 простых шагов для новичков

И в заключение хочу предоставить простую инструкцию по использованию API через Postman. Она будет полезна для тех, кто вдохновился нашим новым инструментом, но еще не пробовал работать с API.

Пройдите 5 простых шагов и выгружайте данные с молниеносной скоростью:
1
Для начала нужно скачать Postman по ссылке. Это обеспечение бесплатно.
2
Далее, запускаем программу и, если есть необходимость, создаем аккаунт (создание учетной записи не обязательно).
3
Создаем новый запрос:
профиль serpstat скопировать токен
4
Далее приступаем к настройке самого запроса:
4.1
Тип запроса — POST.
4.2
Во вкладке body выбираем raw, и далее — JSON.
4.3
Заполняем адрес запроса и вставляем наш токен. Эту информацию можно подсмотреть в документации по API аудита.
профиль serpstat скопировать токен
4.4
Далее заполняем тело запроса. Посмотреть примеры других методов можно в документации по аудиту.
профиль serpstat скопировать токен
5
Отправляем запрос и получаем результат:
профиль serpstat скопировать токен
Независимо от того, являетесь ли вы опытным пользователем API, это краткое руководство значительно облегчит ваши SEO-задачи. Особенно, если вам нужен быстрый анализ сайта на ошибки. Следите за обновлениями этой статьи, чтобы узнать больше о возможностях API Serpstat.

Сэкономьте время на изучении Serpstat

Хотите получить персональную демонстрацию сервиса, тестовый период или эффективные кейсы использования Serpstat?

Оставьте заявку и мы свяжемся с вами ;)

Мнение авторов гостевого поста может не совпадать с позицией редакции и специалистов компании Serpstat.

Оцените статью по 5-бальной шкале

4.88 из 5 на основе 17 оценок
Нашли ошибку? Выделите её и нажмите Ctrl + Enter, чтобы сообщить нам.