– Читать 8 минут –

17 мая 2019

Serpstat JavaScript SDK:
программирование прямо в браузере

Андрей Белоусов

Growth Hacking Specialist в Serpstat

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

Недавно мы опубликовали нашу первую хак-статью, в которой рассказали, как использовать скрипт Serpstat для анализа конкурентов. Мы объяснили, как использовать API Serpstat для кодирования непосредственно в браузере, чтобы анализировать большие объемы данных и систематизировать их в соответствии с вашими потребностями.

Хакни контент-план своих конкурентов: как найти самые трафиковые темы статей?

Содержание

1. Зачем вам API?
2. Новые возможности с Javascript SDK
2.1 Запуск инструмента
2.2 Async/Await или Then?
3. Применение Serpstat API Console
3.1 Интерфейс и примеры
3.2 Варианты применения

Зачем вам API?

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

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

Важно! Вам не нужны навыки программирования для работы с API. Вы можете найти больше информации о применении интерфейса в руководстве.

Вот несколько примеров задач, которые API может решить:

API Serpstat + Google Таблицы

Анализ позиций и видимости вашего сайта и сайтов ваших конкурентов.

Оценка эффективности SEO по регионам.

Глубинный анализ конкурентов.

Исследование ключевых фраз и анализ URL.

Поиск тематически связанных форумов, блогов и веб-сайтов .

Новые возможности с JavaScript SDK

В дополнение к API-консоли недавно стал доступен JavaScript SDK от Serpstat. Этот интерфейс позволяет получить прямой доступ к браузеру, а также к платформе Node.js. Для этого не требуется настройка веб-сервера, что делает приложение API быстрее и проще, чем когда-либо. Чтобы начать работу, просто откройте наш код в браузере.

Потестить JavaScript SDK

Настройка инструмента

Создайте HTML-файл.

Откройте его в любом текстовом редакторе.

Добавьте этот код:

<script src="https://cdn.jsdelivr.net/npm/serpstat-api-3/serpstat-api.js"></script>
<pre id="res"></pre>
<script>
    var api = SerpstatAPI.init({
         token   : "ENTER TOKEN HERE" 
    });
   api.databases_info().then(function(bases){
      document.getElementById("res").innerHTML = JSON.stringify(bases,null,"  ");
   })
</script>

Введите API-токен из своего профиля Serpstat в строку «ENTER TOKEN HERE».

Сохраните файл.

Откройте его в своем браузере.

Как видите, вы можете легко это повторить. А теперь рассмотрим некоторые детали в коде:

Добавление SDK:

<script src="https://cdn.jsdelivr.net/npm/serpstat-api-3/serpstat-api.js"></script>

Результаты перечислены здесь:

<pre id="res"></pre>
<script>

Ввод токена:

 var api = SerpstatAPI.init({
         token   : "ENTER TOKEN HERE" 
    });

Выбор API-метода:

api.databases_info()

После этого код выполняется ниже:

.then(function(bases){

Результаты публикуются в теге с идентификатором res:

document.getElementById("res").innerHTML = JSON.stringify(bases,null,"  ");

Async/Await или Then?

Далее мы будем использовать ключевые слова async / await в коде. Хотя они облегчают программирование, у них есть один недостаток: устаревшие браузеры не могут их поддерживать. Если вы создаете общедоступную утилиту, лучше использовать:

async/await

async function someFun(){
    var res1 = await(api.someMethod1(...));
    …
    var res2 = await(api.someMethod2(...));
    ….
}

then

function someFun(){
    api.someMethod1(...).then(function(res1){
             ...
             api.someMethod2(...).then(function(res2){
                ...
              });
    });
}

Так выглядит код с async/await:

<script src="https://cdn.jsdelivr.net/npm/serpstat-api-3/serpstat-api.js"></script>
<pre id="res"></pre>
<script> (async function(){
    var api = SerpstatAPI.init({
         token   : "ENTER TOKEN HERE" 
    });
   var bases = await(api.databases_info());
   document.getElementById("res").innerHTML = JSON.stringify(bases,null,"  ");
})();</script>

Применение Serpstat API Console

Интерфейс и примеры

Другой способ для начала работы с API — запустить код JS в консоли API. Для этого выберите метод Misc. и опцию → Run Javascript Code.

К примеру, чтобы увидеть все регионы, доступные для анализа с помощью Serpstat:

Введите токен.

Выберите метод Run Javascript Code.

Введите код.

var bases = await (api.databases_info());
return bases;

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

//get databases
var bases   = await (api.databases_info());

//leave an array of database codes
var se = [];
for(var i = 0; i<bases .length; i++){
    se.push(bases [i].db_name);      
}

//get domain data by region
var res = await(api.domain_info({
   query: 'serpstat.com',
   se: se   
}));
return res;

Выполнение кода займет несколько минут. Затем вы получите отчет по анализируемому домену, где в строках показаны параметры домена (видимость, трафик и т. д.), а в столбцах — регионы.

Если вы хотите по-разному отображать данные, переключать столбцы и строки отчета, можно использовать следующий код:

//get database
var bases   = await (api.databases_info());

//leave an array of database codes
var se = [];
for(var i = 0; i<bases.length; i++){
    if(bases [i].db_name[0]==='y'){
         se.push(bases [i].db_name);   
    }   
}

//get domain data by region
var res = await(api.domain_info({
   query: 'serpstat.com',
   se: se   
}));

//turn the table
var transope = [];
var rowNames = Object.keys(res[0]) 

for(var i=0; i<rowNames.length; i++){
    var rowName = rowNames[i];
    var row     = {name: rowName};
    for(var j=0;j<res.length;j++){
        row['se_'+res[j]._se] = res[j][rowName];
    }
    transope.push(row);
}
return transope;

Важно! Прежде чем запускать код, вы должны отключить удаление дубликатов.

API консоль имеет собственный интерфейс, который предлагает различные функции для отображения и редактирования данных: таблицы, фильтры, SQL и экспорт в форматы CSV и XLSX.

Иными словами, можно прочитать собственный код, экспортировать его в файл XLSX или CSV и открыть в MS Excel или Google Spreadsheets.

Использование опций в коде

Когда в поле ввода кода активен параметр «Show options», можно использовать в коде опции, которые введены в консоль. Они находятся в переменной opts. Например, opts.query или opts.se.

var res = await(api.domain_info({
   query: opts.query,
   se: opts.se  
}));
return res;

Или:

var res = await(api.domain_info(opts));
return res;

Как видите, API Serpstat открывает новые горизонты для SEO. Особенно, когда речь идет о крупных агентствах и внутренних командах, для которых автоматизация задач SEO является обязательной. Это проще, чем когда-либо, с Serpstat API Console, поскольку он не требует настройки сервера, а инициализация занимает не более 10 минут.

Serpstat — набор инструментов для поискового маркетинга!

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

Набор инструментов для экономии времени на выполнение SEO-задач.

7 дней бесплатно

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

4.75 из 5 на основе 8 оценок

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

Используйте лучшие SEO инструменты

Проверка обратных ссылок

Быстрая проверка обратных ссылок вашего сайта и конкурентов

API для SEO

Получите быстро большие объемы данных используя SЕО API

Анализ конкурентов

Сделайте полный анализ сайтов конкурентов для SEO и PPC

Мониторинг позиций

Отслеживайте изменение ранжирования запросов используя мониторинг позиций ключей

Serpstat JavaScript SDK: программирование прямо в браузере