Як автоматизувати 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. Хочу надихнути новачків на розвиток та навчання. Поїхали!

Йдемо розбиратися в тому, що таке API прямо в Wikipedia:

З визначення ми вже починаємо уявляти, що взаємодіятимемо з сервісом Serpstat без інтерфейсу через якусь іншу програму. Це дозволить не витрачати час на те, щоб зайти до Serpstat, вибрати потрібні звіти та фільтри, вивантажити їх і лише потім почати з ними працювати.

А що найбільше люблять SEO-шники? Правильно! Таблиці. Але замість Excel, у цій статті, будемо використовувати Google Spreadsheet.

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

При першому і найпростішому запиті в Google: «google sheets custom function» — знаходимо на першому місці мануал, в якому розповідається про App Script.

Можна більше почитати та дізнатися про основи роботи в цьому мануалі.

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

У нашому випадку це https://api.serpstat.com/v4/?token={token}, де:

Звертаючись за цим URL можна отримати відповідь з потрібними даними у форматі JSON.

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

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

Або простіший код «формула 2»:

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

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

Кожен SEO-шник повинен знати, що роблять його конкуренти і як розвивається ніша загалом. Якщо не тримати «руку на пульсі», то можна втратити момент, коли правила в ніші зміняться та доведеться швидко адаптуватись. Тому чим раніше ви помітите зміни у топах, на сайтах конкурентів — тим краще. Інакше, з падіння позицій можна виходити місяцями.

Найпростіший варіант використання API — створення звітів. Створимо досить простий дашборд на прикладі коду з Формули 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 параметри відповіді API-методу, (у нашому прикладі keywords, traff, ads) з відповідей API та дізнатися, які значення можна отримати.

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

Для приклада візьмемо код з «формули 1». У ньому є кілька цікавих особливостей, які нам будуть потрібні. Всі ці особливості можна побачити у довідці, що спливає, при введенні формули в коментарях розробника коду.

Важлива для нас особливість — можливість виводити відразу кілька ключів (json keys) та отримувати дані щодо них.

Ми хочемо дуже швидко дізнатися топ-100 за кількома запитами. Наприклад, я дуже часто роблю це для швидкої перевірки кластеризації запитів. Є хороший запит і я не знаю, до якої сторінки він точно підійде краще. Отримую топи за декількома запитами й просто в Spreadsheet і порівнюю їх перетин. Таким чином, не потрібно запускати додаткові звіти для кластеризації кількох запитів та витрачати час на відкриття кількох вкладок з 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.

Таким чином, за допомогою Google, мінімальних знань у розробці, детальної довідки від Serpstat і, найголовніше, бажання — можна діставати будь-які дані дуже швидко.

У Flatfy є правило — якщо якась задача виникає кілька разів і вона може бути автоматизована — автоматизуємо. Багато фірм купують співробітникам нову техніку, щоб підвищити продуктивність, але мало хто вважає скільки часу співробітник може витратити на простий збір даних, замість його аналізу та перемикання вкладок, можна реалізувати перегляд всіх даних в одному дашборді.

Автоматизуючи процеси збору та обробки даних, ми покращуємо якість виконання завдань, отримуємо більше часу для пріоритетних завдань та розвитку проєктів.

Використання API Serpstat – економія годинника робочого часу. За допомогою таких простих автоматизацій можна економити щонайменше одну робочу годину на день для SEO-фахівця, що на місяць виходить: 23 робочих дні * 1 година * (1000/23/8)$/година = 125$ в місяць (12,5% від зарплати).