В сегодняшней статье мы разберем, что такое API, в чем преимущества использования API SpyWords и сделаем ваш первый API запрос.
1. Что такое API
API (application programming interface) — это набор функций, позволяющих пользователям получать доступ к данным или компонентам SpyWords.
SpyWords API позволяет интегрировать данные и уникальный функционал нашего сервиса в ваши собственные внутренние или публичные приложения. Он идеально подходит для enterprise рекламодателей, агентств контекстной рекламы и seo-компаний, желающих автоматизировать и усовершенствовать процессы анализа конкурентов и подбора ключевых слов.Когда вы делаете запрос в SpyWords, сервис берёт данные из своих баз данных и показывает их вам через наш веб интерфейс.
API позволяет вам получать такие же данные, не находясь при этом в веб интерфейсе SpyWords.Например, когда вы хотите при помощи API получить запросы и объявления рекламодателя amocrm.ru в Яндекс.Директ, то ответ с данными будет такой: 2. Преимущества API SpyWords
Вы спросите, а зачем же API, если он даёт те же результаты только в трудно читаемой форме?
Все очень просто. У API есть ряд преимуществ, которых нет у веб интерфейса:
- Скорость работы. Любой из доступных API тарифов в SpyWords позволит вам делать до 50 запросов в секунду, что не может не радовать.
- Нет лимитов по запросам. При работе с API, нет лимитов по запросам как при работе с веб интерфейсом. Вы можете сделать сколько угодно запросов и получить больше данных, но только если позволяет остаток строк на балансе.
- Можно собрать индивидуальный отчет с необходимыми данными. Используя API, вы можете совместить несколько отчётов в один и сортировать полученные данные всего одной командой для автоматизации ваших задач. Вы можете создавать индивидуальные скрипты, встраивать их в собственный интерфейс и получать только важные для вас данные всего в один клик.
Используя API SpyWords, вы платите только за выгруженные строки, а не за использование лимитов вашего тарифного плана.
3. Доступ к API SpyWords
Прежде всего, чтобы воспользоваться API вы должны написать нам по контактам на странице: https://spywords.ru/contact_us.php, запросить в письме API токен и сразу прикрепить свою почту аккаунта в письме.
После этого необходимо выбрать тарифный план на странице: https://spywords.ru/api_pricing.php Тарифы отличаются в основном доступным количеством строк для выгрузки ну и ценой. Есть небольшие отличия по доступным методам тарифов, подробнее можете ознакомиться на странице: https://spywords.ru/api_pricing.php
4. Ваш первый API запрос
Давайте теперь сделаем наш первый API запрос. В SpyWords есть песочница, в которой мы можем попрактиковаться перед работой с полнофункциональным API.
Песочница имитирует API SpyWords и предназначена для тестирования созданных приложений перед переводом в режим полноценной эксплуатации. При вызове методов из песочницы строки с вашего баланса не взимаются.
База данных песочницы полностью повторяет объем реальной БД API SpyWords, что позволяет протестировать приложения в режиме реальной нагрузки и большого объема получаемых данных.
В песочнице доступны все методы, но результирующие данные отличаются от реальных: текстовые данные после 7-го символа скрываются (например, «телевиз** ****** * *****», а числовые данные не отражают реальных показателей.
Итак, перейдем на страницу с методами и примерами кода: https://spywords.ru/api_docs.php и выберем к примеру метод "KeywordOrganic".Метод предоставляет информацию о доменах в органическом поиске по ключевому слову в Яндекс или Google: позиция, индекс изменения позиции, домен рекламодателя, сниппет, url сниппета, общее кол-во запросов домена в поиске.
За основу берем адрес нашей песочницы: https://api-sandbox.spywords.ru
Далее вам надо указать, какие данные вы хотите получить. После адреса песочницы указываем параметр ?method= + значение (имя метода), будет выглядеть вот так: ?method=KeywordOrganic
Чтобы указать остальные параметры, после каждого параметра необходимо ставить амперсанд: &. Все параметры метода указаны в таблице метода.