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

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

Отменить
3721 39
SEO Читать 8 минут

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

Serpstat JavaScript SDK: программирование прямо в браузере
Андрей Белоусов
Андрей Белоусов
Growth Hacking Specialist в Serpstat
Снова и снова возникает вопрос о том, должен ли хороший SEO-специалист иметь навыки программирования? Однако ясно только одно — знание программирования помогает повысить эффективность вашей работы и выйти за рамки стандартных возможностей SEO-инструментов.
Недавно мы опубликовали нашу первую хак-статью, в которой рассказали, как использовать скрипт Serpstat для анализа конкурентов. Мы объяснили, как использовать API Serpstat для кодирования непосредственно в браузере, чтобы анализировать большие объемы данных и систематизировать их в соответствии с вашими потребностями.

Зачем вам API?

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

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

Вот несколько примеров задач, которые API может решить:
Анализ позиций и видимости вашего сайта и сайтов ваших конкурентов.
Оценка эффективности SEO по регионам.
Глубинный анализ конкурентов.
Исследование ключевых фраз и анализ URL.
Поиск тематически связанных форумов, блогов и веб-сайтов .
 

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

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

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

1
Создайте HTML-файл.
2
Откройте его в любом текстовом редакторе.
3
Добавьте этот код:
<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>
4
Введите API-токен из своего профиля Serpstat в строку «ENTER TOKEN HERE».
5
Сохраните файл.
6
Откройте его в своем браузере.
Как видите, вы можете легко это повторить. А теперь рассмотрим некоторые детали в коде:
Добавление 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:
1
Введите токен.
2
Выберите метод Run Javascript Code.
3
Введите код.
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

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

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

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

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