- Песочница
- Коды ошибок
- Столбцы и сортировка
- Пример приложения
- Анализ конкурентов
- Битва доменов
- Умный подбор слов
- Служебные методы
Песочница
Песочница имитирует API SpyWords и предназначена для тестирования созданных приложений перед переводом в режим полноценной эксплуатации. При вызове методов из песочницы строки с вашего баланса не взимаются.
База данных песочницы полностью повторяет объем реальной БД API SpyWords, что позволяет протестировать приложения в режиме реальной нагрузки и большого объема получаемых данных.
В песочнице доступны все методы, но результирующие данные отличаются от реальных: текстовые данные после 7-го символа скрываются (например, «телевиз** ****** * *****», а числовые данные не отражают реальных показателей.
Адрес песочницы: https://api-sandbox.spywords.ru
После завершения тестирования приложения не забудьте перевести запросы на production сервер API SpyWords.Коды ошибок
Ниже приведены коды и описание возможных ошибок при получении ответа от сервера API
- ERROR 10 - ошибка авторизации, проверьте указанный токен
- ERROR 20 - недостаточно строк на балансе
- ERROR 30 - метод не поддерживается в вашем тарифе
- ERROR 40 - неправильно указан метод
- ERROR 50 - пропущен параметр
- ERROR 60 - неправильно указан параметр
- ERROR 70 - домен не содержится в базе данных или указан с ошибкой
- ERROR 80 - запрос не содержится в базе данных или указан с ошибкой
- ERROR 91 - домен №1 для сравнения не содержится в базе данных
- ERROR 92 - домен №2 для сравнения не содержится в базе данных
- ERROR 93 - домен №3 для сравнения не содержится в базе данных
Описание столбцов и сортировок
Название | Описание |
Keyword * | Ключевое слово |
Volume * | Кол-во показов ключевого слова в месяц, точное соответствие (регион Москва) |
Pos* | Позиция в контексте или органической выдаче |
Domain | Домен |
PosAlt | Изменение позиции (сравнение с предыдущим обновлением данных) |
CPC * | Средняя стоимость клика ключевого слова (регион Москва) |
AdvTot (KeyComp) | Всего рекламодателей по данному ключевому слову |
AdCopy | Текст объявления |
RealURL(AdUrl) | Url посадочной страницы |
YandexVolume * | Кол-во показов ключевого слова в месяц в Яндекс |
GoogleVolume * | Кол-во показов ключевого слова в месяц в Google |
YandexOrgPos * | Позиция в органической выдаче Яндекс |
YandexOrgPos * | Позиция в органической выдаче Google |
KeyOverlap | Кол-во пересекающихся ключевых слов |
SE | Поисковая система |
KeysAdTot | Общее кол-во запросов в контексте |
AvgAdPos | Средняя позиция объявлений рекламодателя |
KeysOrgTot | Общее кол-во запросов в органической выдаче |
AdSpend | Оценка дневного бюджета на контекстную рекламу |
AdTraf | Оценка месячного трафика из контекстной рекламы |
OrgTraf | Оценка месячного трафика из органического поиска |
YandexCPC * | Средняя стоимость клика в Яндекс |
GoogleCPC * | Средняя стоимость клика в Google |
YandexAdvTot * | Кол-во рекламодателей по запросу в Яндекс |
GoogleAdvTot * | Кол-во рекламодателей по запросу в Google |
Snippet | Сниппет |
KeysTot | Общее кол-во запросов домена в контекстной рекламе / поиске |
AdKeys | Всего запросов с этим объявлением |
* Данные столбцы поддерживают возможность сортировки, для этого в запросе метода следует использовать параметр сортировки, например:
• asc=YandexCPC – сортировка стоимости клика в Яндекс по возрастанию
• desc=GoogleAdvTot – сортировка кол-ва рекламодателей в Google по убыванию
• asc=Pos – сортировка позиций в органическом поиске по возрастанию
Пример приложения на PHP
<? //адрес api define("HTTP_API", "https://api.spywords.ru/?"); //////////////////////////////////////////////////////////////////////////////// $p=""; $p["method"] = "DomainOrganic"; $p["site"] = "bitrix24.ru"; $p["se"] = $_GET["se"] ? $_GET["se"] : "yandex"; if( $_GET["asc"] ) $p["asc"] = $_GET["asc"] ? $_GET["asc"] : ""; elseif( $_GET["desc"] ) $p["desc"] = $_GET["desc"] ? $_GET["desc"] : ""; if( $_GET["limit"] ) $p["limit"] = $_GET["limit"]; //авторизация через login/token $p["login"] = "test.api.spywords@spywords.ru"; $p["token"] = "6c812126714083d3f4e2b6d1656d3de5"; //////////////////////////////////////////////////////////////////////////////// //вызов API и разбор результатов //echo "<br>Параметры:<br>"; echo "<div>"; foreach($p as $k=>$v){ echo "<br>$k=<b ".($k=="method" ? "style=\"font-size:20px; color:blue\"":"").">$v</b>"; } echo "</div><br>"; //echo "<br>Результат:<br>"; //вызов API $fH = fopen($uri=HTTP_API.http_build_query($p), "rt"); //первая строка содержит ошибку | заголовки столбцов $r = fgets($fH, 4096); if( substr($r,0,5)=="ERROR"){ //ошибка echo "<br><b style=\"color:red\">$r</b>"; }else{ //заголовки столбцов $r = explode("\t", $r); echo "<div class=row>"; foreach($r as $td){ echo "<div class=th>$td</div>"; //echo "$td "; } echo "</div>"; //данные столбцов while(!feof($fH)) { $r = explode("\t", fgets($fH, 4096)); echo "<div class=row>"; foreach($r as $td){ echo "<div class=td>$td</div>"; //echo "$td "; } echo "</div>"; } }
KeywordOverview
Метод предоставляет сводную информацию о ключевом слове в Яндекс и Google: количество рекламодателей, показы в месяц в формате точного соответствия и среднюю стоимость клика.
Пример запроса:
Обзор запроса «такси»
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | KeywordOverview | название метода |
word | такси | ключевое слово для анализа |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
KeywordAdv
Метод предоставляет информацию о рекламодателях по ключевому слову в Яндекс или Google: домен рекламодателя, текст объявления, url объявления, средняя позиция рекламодателя, общее кол-во запросов рекламодателя в контексте.
Пример запроса:
Рекламодатели по запросу «такси» в Яндекс.Директ
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | KeywordAdv | название метода |
word | такси | ключевое слово для анализа |
se | yandex | google | поисковая система |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
KeywordOrganic
Метод предоставляет информацию о доменах в органическом поиске по ключевому слову в Яндекс или Google: позиция, индекс изменения позиции, домен рекламодателя, сниппет, url сниппета, общее кол-во запросов домена в поиске.
Пример запроса:
Домены в органической выдаче Яндекс по запросу «такси»
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | KeywordOrganic | название метода |
word | такси | ключевое слово для анализа |
se | yandex | google | поисковая система |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
DomainOverview
Метод предоставляет сводную информацию о домене в Яндекс и Google: кол-во запросов в контексте, средняя позиция объявлений, кол-во запросов в поиске, дневной бюджет на контекст, трафик в месяц из контекста, трафик в месяц из поиска.
Пример запроса:
Сводная информация по домену prostoy.ru
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | DomainOverview | название метода |
site | prostoy.ru | домен для анализа |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
DomainOverviewHistory
Метод предоставляет динамику исторических показателей домена в Яндекс и Google: кол-во запросов в контексте, средняя позиция объявлений, кол-во запросов в поиске, дневной бюджет на контекст, трафик в месяц из контекста, трафик в месяц из поиска.
Пример запроса:
Динамика кол-ва запросов в контексте по домену sberbank.ru
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | DomainOverviewHistory | название метода |
site | sberbank.ru | домен для анализа |
data | KeysAdTot
TotUniqAds AvgAdPos AdSpend AdTraf Top50KeysOrgTot Top10KeysOrgTot OrgTraf |
Выбор показателя для получения исторических данных.
Описание показателей доступно в разделе документации "Столбцы и сортировка" |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
DomainAdv
Метод предоставляет информацию о контекстных кампаниях рекламодателя в Яндекс или Google: ключевое слово, текст объявлений, позицию объявлений, url объявлений, кол-во показов данного ключевого слова, среднюю стоимость клика ключевого слова, кол-во конкурентов по данному ключевому слову.
Пример запроса:
Запросы и объявления рекламодателя amocrm.ru в Яндекс.Директ
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | DomainAdv | название метода |
site | amocrm.ru | домен для анализа |
se | yandex | google | поисковая система |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
UniqueAdv
Метод предоставляет информацию об уникальных объявлениях рекламодателя в Яндекс или Google: текст объявлений, url объявлений, кол-во запросов каждого объявления.
Пример запроса:
Рекламодатели по запросу «такси» в Яндекс.Директ
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | UniqueAdv | название метода |
site | amocrm.ru | домен для анализа |
se | yandex | google | поисковая система |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
DomainOrganic
Метод предоставляет информацию о позициях домена в органическом поиске Яндекс или Google: ключевое слово, кол-во показов данного ключевого слова, позиция домена, индекс изменения позиции, сниппет, url сниппета.
Пример запроса:
Запросы и позиции домена bitrix24.ru в органическом поиске Яндекс
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | DomainOrganic | название метода |
site | bitrix24.ru | домен для анализа |
se | yandex | google | поисковая система |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
DomainUrl
Метод предоставляет информацию о видимости страниц (УРЛов) домена в органическом поиске Яндекс или Google: адрес страницы, тайтл страницы, кол-во запросов, доля трафика, id страницы (используется для метода DomainUrlOgranic в параметре `&url=` для идентификации страницы)
Пример запроса:
Страницы домена bitrix24.ru в органическом поиске Яндекc
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | DomainUrl | название метода |
site | bitrix24.ru | домен для анализа |
se | yandex | google | поисковая система |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
DomainUrlOrganic
Метод предоставляет информацию о запросах и позициях страницы (страниц) домена в органическом поиске Яндекс или Google: ключевое слово, кол-во показов данного ключевого слова, позици, индекс изменения позиции, сниппет, url сниппета.
Пример запроса:
Запросы и позиции страницы bitrix24.ru/features/crm.php домена bitrix24.ru в органическом поиске Яндекс
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | DomainUrlOrganic | название метода |
site | bitrix24.ru | домен для анализа |
url | 9071952fcfa3ad2360389e649891541c |
id страницы или нескольких страниц (через запятую) домена
для получения списка id страниц используется метод DomainUrl если не указан ни один id страницы, то в ответе будут данные по всем страницам домена |
se | yandex | google | поисковая система |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
CompareDomainTop10
Метод позволяет сравнить видимость домена в ТОП-10 органической выдачи Яндекс и Google. Доступны три сектора:
- - Уникальные запросы домена в ТОП-10 Яндекс
- - Уникальные запросы домена в ТОП-10 Google
- - Общие запросы домена в ТОП-10 Яндекс и Google
Пример запроса:
Домен bitrix24.ru – уникальные запросы в ТОП-10 Яндекс
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | CompareDomainTop10 | название метода |
site | bitrix24.ru | домен для анализа |
sector | y /g / yg | Выбор сектора значений: y – уникальные запросы в ТОП-10 Яндекс g - уникальные запросы в ТОП-10 Google yg – общие запросы в ТОП-10 Яндекс и Google |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
DomainAdvCompetitors
Метод позволяет получить список конкурентов домена в контекстной рекламе Яндекс или Google, а также кол-во запросов, по которым исходный домен пересекается с конкурентами
Пример запроса:
Конкуренты домена bitrix24.ru в Яндекс.Директ
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | DomainAdvCompetitors | название метода |
site | bitrix24.ru | домен для анализа |
se | yandex | google | поисковая система |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
DomainOrganicCompetitors
Метод позволяет получить список конкурентов домена в органическом поиске Яндекс или Google, а также кол-во запросов, по которым исходный домен пересекается с конкурентами.
Пример запроса:
Конкуренты домена bitrix24.ru в органическом поиске Яндекс
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | DomainOrganicCompetitors | название метода |
site | bitrix24.ru | домен для анализа |
se | yandex | google | поисковая система |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
FightOverview
Метод позволяет сравнить сводную информацию 2-х или 3-х доменов в Яндекс или Google: кол-во запросов в контексте, среднюю позицию объявлений, кол-во запросов в поиске, дневной бюджет на контекст, трафик в месяц из контекста, трафик в месяц из поиска.
Пример запроса:
Сравнить сводные показатели доменов amocrm.ru, prostoy.ru, bitrix24.ru
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | FightOverview | название метода |
site1 | amocrm.ru | домен №1 для сравнения |
site2 | prostoy.ru | домен №2 для сравнения |
site3 | bitrix24.ru | домен №3 для сравнения |
se | yandex | google | поисковая система |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
FightAdv
Метод позволяет сравнить массивы используемых запросов в контекстной рекламе 2-х или 3-х доменов в Яндекс или Google.
Доступны 2 сектора данных: уникальные запросы для каждого из сравниваемых доменов, общие запросы сравниваемых доменов.
Пример запроса:
Сравнить домены amocrm.ru, prostoy.ru, bitrix24.ru в Яндекс.Директ и получить общие запросы
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | FightAdv | название метода |
site1 | amocrm.ru | домен №1 для сравнения |
site2 | prostoy.ru | домен №2 для сравнения |
site3 | bitrix24.ru | домен №3 для сравнения |
se | yandex | google | поисковая система |
sector | 1 | Выбор сектора значений: 1 / 2 / 3 – уникальные запросы доменов 12 / 13 / 23 / 123 - пересекающиеся запросы доменов |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
FightCompareAdv
Метод позволяет сравнить тексты и позиции объявлений 2-х или 3-х рекламодателей по пересекающимся запросам в контекстной рекламе Яндекс или Google.
Пример запроса:
Сравнить домены amocrm.ru, prostoy.ru, bitrix24.ru и получить сравнение объявлений amocrm.ru и prostoy.ru по пересекающимся запросам в Яндекс.Директ
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | FightCompareAdv | название метода |
site1 | amocrm.ru | домен №1 для сравнения |
site2 | prostoy.ru | домен №2 для сравнения |
site3 | bitrix24.ru | домен №3 для сравнения |
se | yandex | google | поисковая система |
sector | 12 | Выбор сектора значений: 12 / 13 / 23 / 123 - варианты множеств пересекающихся запросов |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
FightOrganic
Метод позволяет сравнить массивы запросов 2-х или 3-х доменов в органической выдаче Яндекс или Google.
Доступны 2 сектора данных: уникальные запросы для каждого из сравниваемых доменов, общие запросы сравниваемых доменов.
Пример запроса:
Сравнить домены amocrm.ru, prostoy.ru, bitrix24.ru в органическом поиске Яндекс и получить уникальные запросы amocrm.ru
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | FightOrganic | название метода |
site1 | amocrm.ru | домен №1 для сравнения |
site2 | prostoy.ru | домен №2 для сравнения |
site3 | bitrix24.ru | домен №3 для сравнения |
se | yandex | google | поисковая система |
sector | 1 | Выбор сектора значений: 1 / 2 / 3 – уникальные запросы доменов 12 / 13 / 23 / 123 - пересекающиеся запросы доменов |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
FightCompareOrganic
Метод позволяет сравнить позиции, индексы изменения позиций по общим запросам 2-х или 3-х доменов в органической выдаче Яндекс или Google.
Пример запроса:
Сравнить домены amocrm.ru, prostoy.ru, bitrix24.ru и получить сравнение позиций amocrm.ru и prostoy.ru по пересекающимся запросам в выдаче Яндекс
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | FightCompareOrganic | название метода |
site1 | amocrm.ru | домен №1 для сравнения |
site2 | prostoy.ru | домен №2 для сравнения |
site3 | bitrix24.ru | домен №3 для сравнения |
se | yandex | google | поисковая система |
sector | 12 | Выбор сектора значений: 12 / 13 / 23 / 123 - варианты множеств пересекающихся запросов |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
SmartKeywords
Метод позволяет получить для фразы / группы фраз (до 20 шт.) список дополнительных рекомендованных запросов и их параметры: кол-во показов, среднюю стоимость клика,
кол-во рекламодателей.
Пример запроса:
Умный подбор запросов для ключевого слова «такси»
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | SmartKeywords | название метода |
word | такси | Ключевые слова для подбора рекомендованных запросов, до 20 шт, через запятую |
type (опционально) | phrase | related | question | Выбор типа рекомендованных фраз, если не указан, в ответе содержатся все типы фраз
phrase - фразовое соответствие related - связанные запросы question - вопросы |
minusWord (опционально) | бесплатно | Минус-слова для исключения нерелевантных фраз, до 20 шт, через запятую |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
Balance
Метод позволяет узнать кол-во строк, доступных на балансе аккаунта.
Пример запроса:
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | Balance | название метода |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
History
Метод позволяет получить историю вызовов аккаунта за определенный промежуток времени: дата вызова, url, количество строк в результате.
Пример запроса:
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | History | название метода |
date | 2013-02-20 10:00:00 | начальная дата отчета |
date2 | 2013-02-28 12:00:00 | конечная дата отчета |
limit (опционально) | [offset,] rows | Выбор порядка и кол-ва строк в ответе, offset - начальная позиция (если не указана, считается 0), rows - количество запрашиваемых строк |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |
LastUpdateDB
Метод позволяет узнать дату последнего обновления базы.
Пример запроса:
! Внимание, в примере используется тестовый логин и токенПараметры запроса
Параметр | Значение | Описание |
method | LastUpdateDB | название метода |
region (опционально) | [msk] | spb | ast | kiev | ekb | kdr | nvs | kzn | Выбор региона анализа данных, если не указан - считается Москва |
login | test.api.spywords@spywords.ru | логин пользователя |
token | 6c812126714083d3f4e2b6d1656d3de5 | авторизационный токен |