Войти Регистрация

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

Нажав кнопку "Принять и продолжить", вы соглашаетесь с Политикой конфиденциальности

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

Отменить
806 9
Новости Читать 10 минут 20 июля 2020

Как автоматизировать поиск ошибок на сайте: Аудит сайта теперь доступен в 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}}.
Строка: http://api.serpstat.com/v4/?token={{token}}
Личный кабинет Serpstat
{
    "id":1,
    "method":"AuditSite.start",
    "params":{
        "projectId":669214
    },
    "jsonrpc":"2.0"
}
Хотите узнать, как автоматизировать рутинные SEO-задачи с помощью API Serpstat?

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

Как провести аудит сайта с помощью
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-методов, описанных выше, у нас есть API-Консоль для тех, кто хочет работать с API, но не имеет навыков программирования.

Как использовать 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-бальной шкале

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

Поделитесь статьей с вашими друзьями

Войти Регистрация

Вы исчерпали лимит запросов.

Или email
Забыли пароль?
Или email
Optional
Back To Login

Не волнуйтесь! Напишите свой электронный адрес и мы пришлем вам новый пароль.

Вы уверены?

Awesome!

To complete your registration you need to enter your phone number

Назад

Мы отправили код подтверждения на ваш номер телефона

Your phone Resend code Осталось запросов

Что-то пошло не так.

Свяжитесь с нашей службой поддержки
Или подтвердите регистрацию с помощью Телеграм бота Перейдите по этой ссылке
Выберите один из проектов

Знакомство с сервисом

Ознакомьтесь с основными возможностями Serpstat удобным способом!

Отправьте заявку для ознакомления с сервисом и мы свяжемся с вами в кратчайшие сроки. Наш специалист предложит подходящий вариант, который может включать персональную демонстрацию, пробный период, материалы для обучения и повышения экспертизы, личную консультацию, а также комфортные условия для начала работы с Serpstat.

Имя

Email

Телефон

Будем рады вашему комментарию
Увеличить лимиты

Улучшить тариф

Экспорт недоступен для вашего тарифного плана. Вам необходимо улучшить свой тариф до Lite или выше, чтобы получить доступ к инструменту Подробнее

Зарегистрироваться

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

Пригласить
Просмотр Редактирование

E-mail
Сообщение
необязательно
E-mail
Сообщение
необязательно

У вас закончились лимиты

Вы достигли лимита на количество созданных проектов и больше не можете создавать новые проекты. Увеличьте лимиты или удалите существующие проекты.

Я хочу больше лимитов