Как автоматизировать и ускорить SEO-задачи с помощью API Serpstat — пошаговая инструкция
от Flatfy

Если пару лет назад можно было решать все вопросы через excel, то сейчас стоит обратить внимание на изучение JS, Python и базовых знаний HTML, CSS, командной строки, работы HTTP. В своей работе мы все чаще пытаемся автоматизировать:

Меня зовут Влад Моргун, я SEO Team-Lead в Flatfy. Платформа помогает миллионам пользователей из 30 стран мира найти себе жилье. Основной вектор развития — это вторичная жилая недвижимость в мегаполисах, а потому мы работаем над созданием быстрой поисковой системы с учетом всех пожеланий пользователей для выдачи релевантного им ответа.

Для того, чтобы работать эффективно над всеми нашими проектами — команда постоянно тестирует различные инструменты для digital-маркетинга, а особенно те, у которых есть API. С Serpstat познакомились еще в начале его существования, когда сервис работал только на СНГ-рынок под брендом Prodvigator. Олег Саламаха и его команда помогли по-настоящему «распробовать» продукт и «подсадить» на его использование.

Сейчас у Serpstat огромная база по ключам и ссылкам, но главное — одно из самых удобных API. Это важно, поскольку при работе с большим количеством сайтов нужно постоянно хранить в одном месте много данных и анализировать их, а без API нам пришлось бы нанимать школьника-фрилансера, чтобы он тыкал на кнопки «сохранить отчет» :)

В данной статье, ориентированной больше на Junior SEO, я покажу на примере проектов в сфере недвижимости как можно достаточно просто использовать API Serpstat, а также постараюсь доказать, что даже с начальными знаниями по разработке и умением Google-ить, StackOverflow-ить и Copy-Paste-ить можно упрощать себе ежедневную работу и получить преимущество перед конкурентами.

SEO-специалист должен постоянно самосовершенствоваться, поскольку это достаточно динамичная сфера деятельности, которая требует многосторонних знаний, зачастую сильно завязана на анализе данных и опыте. Чем больше и быстрее вы будете получать опыт — тем лучше, а потому очень важно уметь автоматизировать процессы, чтобы освободить время.

Далее в этом разделе будем делать все так, как, если бы у меня не было знаний в разработке, но было умение искать в Google. Хочу вдохновить новичков на развитие и обучение. И так, поехали.

Идем разбираться в том что это такое прямо в Wikipedia:

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

А что любят больше всего SEO-шники? Правильно! Таблицы. Но вместо excel, в данной статье, будем использовать Google Spreadsheet.

Чтобы работать с данными в таблицах, мы постоянно используем функции, но в основном наборе функция «=serpstat(дай мне данные)» отсутствует, а потому создаем свою.

При первом же и самом простом запросе в Google: «google sheets custom function» — находим на первом месте мануал, в котором рассказывается об App Script.

Можно больше почитать и узнать основы работы в этом мануале.

Далее переходим к понятию endpoint API.

В нашем случае это просто ссылка с get-параметрами. Например, api.serpstat.com/v3/domain_info?query=example.com&token=XXX&se=XXX, где:

Обращаясь по этому URL можно получить ответ с нужными данными в формате JSON.

Возьмем готовый скрипт для работы с JSON в Google Spreadsheet (а точнее погуглим «google spreadsheet json import»):

Код «формула 1»:

Или более простой код «формула 2»:

Для добавления формулы =ImportJSON. Я специально беру чьи-то готовые скрипты, чтобы показать, что при большом желании можно автоматизировать SEO-задачи и с минимальными знаниями программирования, используя чужие наработки.

Переносим теоретические знания в практику.

Каждый SEO-шник должен знать, что делают его конкуренты и как развивается ниша в целом. Если не держать «руку на пульсе», то можно упустить момент, когда правила в нише изменятся и придется в горячке много чего менять. Потому чем раньше вы заметите изменения в топах, на сайтах конкурентов и т.п. — тем лучше. Иначе из большого падения можно выходить месяцами.

Самый простой вариант использования API — создание различных отчетов. Создадим достаточно простой Dashboard на примере кода «формула 2» для анализа конкурентов с такими параметрами:

Даже такие простые показатели могут показать нам насколько наш проект отличается от конкурентов по «мощности», а если сохранять данные, например, по месяцам, то можно проследить динамику развития проекта.

Вот так выглядит мини-отчет с количеством ключевых слов, трафика и объявлениями в контекстной рекламе по конкурентам в сфере недвижимости.

Далее собираем в столбике F URL, к которым будем обращаться с помощью формулы =CONCATENATE("https://api.serpstat.com/v3/domain_info?query=",A2,"&token=",G$2,"&se=",H$2). Значок $ перед цифрой ячейки значит — не менять цифру при протягивании формулы.

Теперь нам осталось сделать запросы к одному из атрибутов из JSON-массива. JSON имеет вложенность (древовидную структуру), которую будем разделять слэшами.

Например, нужно получить количество ключевых фраз по сайту. Для этого будем использовать формулу =IMPORTJSON(F2,"result/keywords") (ячейка B1). Если хотим достать трафик, то поменяем наш запрос на =IMPORTJSON(F2,"result/traff").

Для решения своих задач вы можете посмотреть в справке Serpstat возможные ключи (в нашем примере keywords, traff, ads) из ответов на запросы и узнать какие значения можете получить.

Теперь давайте рассмотрим задачу когда вам нужно быстро получить данные, но не использовать интерфейс. Например, достать топы по запросам или частотность определенных ключей.

Для примера возьмем код «формула 1».

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

Важная для нас особенность — возможность выводить сразу несколько ключей (json keys) и получать данные по ним.

Мы хотим очень быстро узнать топ-100 по нескольким запросам. Например, я очень часто это делаю для быстрой проверки кластеризации запросов. Есть хороший запрос и я не знаю, к какой странице он точно подойдет лучше. Получаю топы по нескольким запросам и прямо в spreadsheet и сравниваю их пересечение. Таким образом, не нужно запускать KeyAssort для кластеризации нескольких запросов и не нужно тратить время на открытие нескольких вкладок с Google и сравнение топов в них.

Для этого обращаемся к https://api.serpstat.com/v3/keyword_top и делаем формулу =ImportJSON(F2,"/result/top/position,/result/top/url") — обратите внимание на то, что мы использовали два ключа через запятую: /result/top/position и /result/top/url.

Таким образом получаем два столбика с данными: позиции из топ-100 и сами URL.

Возможно, вы хотите быстро проверить частотность запросов. Тут все аналогично, но используем запрос https://api.serpstat.com/v3/keyword_info и формулу =ImportJSON(F2,"/result/region_queries_count","noHeaders").

В данном примере есть еще одна особенность — дополнительные параметры. noHeaders позволяет убрать нам лишние заголовки и получить просто данные. Выписываем в столбик А нужные нам ключи для проверки, и «протягиваем» дальше формулу в столбике B.