Sape.ru Xml-Rpc

Наш xml-rpc интерфейс доступен по адресу http://api.sape.ru/xmlrpc/. Обращаться нужно по 80-му порту, тело xml-запроса класть в POST_DATA. Всё общение происходит полностью в кодировке UTF-8. Кроме того, можно работать по https по адресу https://api.sape.ru/xmlrpc/.

Если Вы ещё ничего не знаете про XML-RPC, то рекомендуем почитать на сайте www.xmlrpc.com:

  1. Реализация протокола для Вашего любимого языка программирования.
  2. Для любителей PHP рекомендуем Zend Framework

Фильтр по категориям Скрыть фильтр
Выберите роль:
Выбрать категорию
(int) sape.login( (string) login, (string) token )
Оптимизатор
Вебмастер
Авторизация и параметры аккаунта

Авторизация в системе, необходимо вызывать в начале каждой сессии. Далее при каждом следующем запросе нужно передавать все вернувшиеся cookie. Результатом выполнения функции является id пользователя. Для генерации токена для своегоаккаунта перейдите на эту страницу: http://passport.sape.ru/security/token/

Имя Тип Обязательно По умолчанию Описание
login string Да - логин
token string Да - токен
Тип Описание
int ID пользователя
(array) sape.get_user()
Оптимизатор
Вебмастер
Авторизация и параметры аккаунта

Получение информации о текущем пользователе.

Тип Описание
array Содержит следующие значения:
  • (string) login - login
  • (string) email - e-mail
  • (float) balance - баланс
  • (string) hash - хэш
  • (string) seo_nof_links_ok - число купленных ссылок в статусе ОК
  • (string) seo_nof_links - число купленных ссылок
  • (float) seo_budget_monthly - месячный бюджет
  • (float) seo_budget_monthly_real - месячный бюджет по статусу ОК
  • (int) amount_spent_today - расход сутки
  • (int) amount_spent_week - расход неделя
  • (int) amount_earned_today - доход сутки
  • (int) amount_earned_week - доход неделя
  • (int) amount_pc_today - партнёрка сутки
  • (int) amount_pc_week - партнёрка неделя
  • (int) amount_result_today - результат сутки
  • (int) amount_result_week - результат неделя.
(float) sape.get_balance()
Оптимизатор
Вебмастер
Баланс

Получение текущего баланса пользователя, включая заблокированные средства.

Тип Описание
float баланс пользователя
(float) sape.get_balance_real()
Оптимизатор
Вебмастер
Баланс

Получение доступного баланса пользователя.

Тип Описание
float баланс пользователя
(array) sape.get_balance_locks()
Оптимизатор
Вебмастер
Баланс

Получение текущего баланса пользователя с детализацией блокировок.

Тип Описание
array Содержит следующие значения:
  • (float) available - Доступно к тратам ВСЕГО
  • (float) total - Баланс с блокировками ОБЩИЙ
  • (array) earned - Заработанные средства:
    • (float) total - всего заработано
    • (boolean) autoTransfer - разрешены ли траты заработанных средств
  • (array) blocked = null - Блокировки:
    • (float) promo - на промо-акции
    • (float) bonus - спонсорство
    • (float) dox - непредоставление документов
    • (float) out - заявки на вывод
    • (array) subsys - блокировки по подсистемам
    • (float) total - всего заблокировано
  • (float) bonus - Бонусы
  • (float) blockedAndBudget - Блокировки и бюджеты
  • (array) bonusMask = null Список, каждый элемент которого содержит:
    • (float) available
    • (float) oneBuy
    • (float) reserved
  • (array) bonusMaskBySubsys = null Список, каждый элемент которого содержит:
    • (float) available
    • (float) oneBuy
    • (float) reserved
  • (array) budget = null - Бюджеты:
    • (array) subsys - бюджеты по подсистемам
    • (float) total - общая сумма бюджетов
(array) sape.get_bills( (int) dateYear[, (int) dateMonth = null[, (int) dateDay = null[, (int) userId = null]]] )
Оптимизатор
Вебмастер
Ввод-вывод средств

Получение данных по датам зачисления/поступления денег в разрезе каждого счета. По умолчанию выводятся счета аккаунтов привязанных к юрлицу, если такая связь есть, если нужно получить счета по конкретному аккаунту, то необходимо установить параметр userId, если userId == true, то выводится информация по текущему пользователю.

Имя Тип Обязательно По умолчанию Описание
dateYear int Да - Год выборки
dateMonth int Нет null Месяц выборки
dateDay int Нет null День выборки
userId int Нет null ID пользователя
Тип Описание
array Список, каждый элемент которого содержит:
  • (int) id - ID счета
  • (int) doc_num - номер документа
  • (date) ctime - дата создания
  • (float) amount - сумма
  • (date) date_payed - дата поступления
  • (date) date_update - дата зачисления
(array) sape.get_bills_unpayed()
Оптимизатор
Вебмастер
Ввод-вывод средств

Получение списка неоплаченных счетов пользователя.

Тип Описание
array Список, каждый элемент которого содержит:
  • (int) id - ID счета
  • (int) doc_num - номер документа
  • (date) ctime - дата создания
  • (float) amount - сумма
(array) sape.get_domains()
Оптимизатор
Проекты

Получение списка доменов пользователя.

Тип Описание
array Список, каждый элемент которого содержит:
  • (int) id - ID домена
  • (string) domain - домен
(array) sape.get_domains_placed()
Вебмастер
Ссылки

Получение списка ID доменов площадок, на которых есть размещенные ссылки.

Тип Описание
array список ID доменов
(boolean) sape.domain_get_status( (string) domain )
Вебмастер
Ссылки

Проверка домена на наличие ссылок в статусе ОК.

Имя Тип Обязательно По умолчанию Описание
domain string Да - домен
Тип Описание
boolean Возможные значения:
  • true - есть активные ссылки
  • false - нет активных ссылок
(array) sape.get_project( (int) projectId )
Оптимизатор
Проекты

Получение параметров проекта пользователя.

Имя Тип Обязательно По умолчанию Описание
projectId int Да - ID проекта
Тип Описание
array Содержит следующие значения:
  • (int) id - ID проекта
  • (string) name - название
  • (int) flag_cancel_links_yabl - автоматически снимать ссылки с сайтов, отсутствующих в ПС Яндекс
  • (int) nof_ext_links_max_l1 - автоматически снимать ссылки для главных страниц, количество ВС на которых превысило указанное значение
  • (int) nof_ext_links_max_l2 - автоматически снимать ссылки для страниц второго УВ, количество ВС на которых превысило указанное значение
  • (int) nof_ext_links_max_l3 - автоматически снимать ссылки для страниц третьего УВ, количество ВС на которых превысило указанное значение
  • (int) nof_pls - количество ссылок в статусе OK
  • (int) nof_urls - количество урлов проекта
  • (int) flag_ext_links_max_no_wl - не распространять ограничение на число ВС на избранные сайты
  • (int) nof_days_to_keep_errors - автоматически снимать ссылки, имеющие статус ERROR столько дней подряд
  • (date) date_created - дата создания
  • (date) date_deleted - дата удаления
  • (int) wizard_id - ID SEO-аггрегатора (0 - нет, 1 - Seowizard)
  • (float) amount_today - потрачено за сегодня
  • (float) amount_yesterday - потрачено за вчера
  • (float) amount_total - потрачено всего
  • (int) yandex_region_id - код региона Яндекс для проверки ключевых слов
  • (int) type - тип проекта
  • (int) sitewide_draft_create_strategy_id - стратегия подбора ссылок
(array) sape.get_projects( [(array) options = null[, (int) pn[, (int) ps = 10000]]] )
Оптимизатор
Проекты

Получения списока проектов пользователя.

Имя Тип Обязательно По умолчанию Описание
options array Нет null Содержит следующие значения:
  • (boolean) show_deleted = false - показывать удаленные
  • (boolean) show_count = false - показывать количество урлов и ссылок в статусе ОК
pn int Нет 0 Номер страницы (для пагинации).
ps int Нет 10000 Количество элементов для вывода на странице (для пагинации).
Тип Описание
array Список, каждый элемент которого содержит:
  • (int) id - ID проекта
  • (string) name - название
  • (int) flag_cancel_links_yabl - автоматически снимать ссылки с сайтов, отсутствующих в ПС Яндекс
  • (int) nof_ext_links_max_l1 - автоматически снимать ссылки для главных страниц, количество ВС на которых превысило указанное значение
  • (int) nof_ext_links_max_l2 - автоматически снимать ссылки для страниц второго УВ, количество ВС на которых превысило указанное значение
  • (int) nof_ext_links_max_l3 - автоматически снимать ссылки для страниц третьего УВ, количество ВС на которых превысило указанное значение
  • (int) * nof_pls - количество ссылок в статусе OK
  • (int) * nof_urls - количество урлов проекта
  • (int) flag_ext_links_max_no_wl - не распространять ограничение на число ВС на избранные сайты
  • (int) nof_days_to_keep_errors - автоматически снимать ссылки, имеющие статус ERROR столько дней подряд
  • (date) date_created - дата создания
  • (date) date_deleted - дата удаления
  • (int) wizard_id - ID SEO-аггрегатора (0 - нет, 1 - Seowizard)
  • (float) amount_today - потрачено за сегодня
  • (float) amount_yesterday - потрачено за вчера
  • (float) amount_total - потрачено всего
  • (int) yandex_region_id - код региона Яндекс для проверки ключевых слов
  • (int) type - тип проекта
  • (int) sitewide_draft_create_strategy_id - стратегия подбора ссылок
(int) sape.project_add( (string) name[, (array) options = array()] )
Оптимизатор
Проекты

Создание нового проекта.

Имя Тип Обязательно По умолчанию Описание
name string Да - имя проекта
options array Нет array() Содержит следующие значения:
  • (string) domain - домен
  • (int) nof_days_to_keep_errors - автоматически снимать ссылки, имеющие статус ERROR, столько дней подряд
  • (int) folder_id - ID папки
  • (int) yandex_region_id - ID региона
  • (boolean) sitewide - признак проекта для сквозных ссылок
  • (int) sitewide_draft_create_strategy_id - ID стратегии подбора ссылок
Тип Описание
int ID созданного проекта
(boolean) sape.project_update( (int) projectId, (array) options )
Оптимизатор
Проекты

Изменение настроек проекта в соответствии с переданными параметрами.

Имя Тип Обязательно По умолчанию Описание
projectId int Да - ID проекта
options array Да - Содержит следующие значения:
  • (string) name - название
  • (boolean) flag_cancel_links_yabl - автоматически снимать ссылки с сайтов, отсутствующих в ПС Яндекс
  • (boolean) flag_ext_links_max_no_wl - не распространять ограничение на число ВС на избранные сайты
  • (int) nof_ext_links_max_l1 - автоматически снимать ссылки для главных страниц, количество ВС на которых превысило указанное значение
  • (int) nof_ext_links_max_l2 - автоматически снимать ссылки для страниц второго УВ, количество ВС на которых превысило указанное значение
  • (int) nof_ext_links_max_l3 - автоматически снимать ссылки для страниц третьего УВ, количество ВС на которых превысило указанное значение
  • (int) nof_days_to_keep_errors - автоматически снимать ссылки, имеющие статус ERROR, столько дней подряд
  • (int) yandex_region_id - код региона Яндекс для проверки позиций ключевых слов проекта. -1 - не проверять позиции про проекту
  • (int) * sitewide_draft_create_strategy_id - ID стратегии подбора ссылок
Тип Описание
boolean результат операции
(array) sape.get_project_sites( (int) projectId )
Оптимизатор
Проекты

Получение списка ID площадок, на размещены ссылки.

Имя Тип Обязательно По умолчанию Описание
projectId int Да - ID проекта
Тип Описание
array cписок ID площадок
(array) sape.get_project_info( (int|array) projectIds )
Оптимизатор
Проекты

Получение статистики по проектам.

Имя Тип Обязательно По умолчанию Описание
projectIds int|array Да - ID проектов
Тип Описание
array Список, каждый элемент которого содержит:
  • (int) project_id - ID проекта
  • (float) budget_monthly - Бюджет за месяц
  • (float) budget_monthly_real - Бюджет за месяц (фактический)
  • (float) budget_monthly_wo_sleep - Бюджет за месяц (без sleep'ов)
  • (int) nof_links - Количество ссылок всего
  • (int) nof_ok_links - Количество ссылок в статусе OK
  • (int) nof_error_links - Количество ссылок в статусе ERROR
  • (int) nof_wait_links - Количество ссылок в статусе WAIT
  • (int) nof_sleep_links - Количество ссылок в статусе SLEEP
(array) sape.get_projects_folders()
Оптимизатор
Проекты

Получение списка разделов проектов.

Тип Описание
array Список, каждый элемент которого содержит:
  • (int) project_id - ID проекта
  • (int) folder_id - ID раздела
  • (string) folder_name - название раздела
(boolean) sape.project_move_to_folder( (int) projectId, (int) folderId )
Оптимизатор
Проекты

Перенос проекта в другой раздел.

Имя Тип Обязательно По умолчанию Описание
projectId int Да - ID проекта
folderId int Да - ID директории
Тип Описание
boolean результат операции
(boolean) sape.project_delete( (int) projectId )
Оптимизатор
Проекты

Удаление проекта.

Имя Тип Обязательно По умолчанию Описание
projectId int Да - ID проекта
Тип Описание
boolean результат операции
(array) sape.get_url( (int) urlId[, (boolean) showDeleted = false] )
Оптимизатор
URL-ы

Получение информация о УРЛе (включая удалённые).

Имя Тип Обязательно По умолчанию Описание
urlId int Да - ID урла
showDeleted boolean Нет false показываеть удаленные
Тип Описание
array Содержит следующие значения:
  • (int) id - ID УРЛа
  • (int) project_id - ID проекта
  • (string) url - УРЛ
  • (string) name - название
  • (boolean) flag_auto - режим модерации
  • (boolean) flag_require_confirm - полуавтоматический режим
  • (date) date_created - дата создания
  • (float) amount_today - сумма за сегодня
  • (float) amount_yesterday - сумма за вчера
  • (float) amount_total - сумма всего
  • (int) nof_links - общее количество ссылок
  • (int) auto_activity_period - период запуска авторежима
  • (int) flag_hide_links_from_se
  • (string) keyword - ключевое слово
  • (date) date_trial_stop
  • (boolean) trial_is_active
  • (int) position_yandex - позиция в yandex
  • (int) position_yandex_diff - изменение позиции в yandex
  • (date) position_yandex_date_log - дата изменения позиции в yandex
(array) sape.get_urls( (int) projectId[, (boolean) showDeleted = false[, (array) options = array()]] )
Оптимизатор
URL-ы

Получение списка УРЛов проекта (включая удалённые).

Имя Тип Обязательно По умолчанию Описание
projectId int Да - ID проекта
showDeleted boolean Нет false показываеть удаленные
options array Нет array() Содержит следующие значения:
  • (boolean) tiny = false - выводить краткую информацю
  • (int) pn = 0 - номер страницы (для пагинации)
  • (int) ps = 0 - количество элементов для вывода на странице (для пагинации)
Тип Описание
array Список, каждый элемент которого содержит:
  • (int) id - ID УРЛа
  • (int) * project_id - ID проекта
  • (string) url - УРЛ
  • (string) name - название
  • (boolean) * flag_auto - режим модерации
  • (boolean) * flag_require_confirm - полуавтоматический режим
  • (date) * date_created - дата создания
  • (float) * amount_today - сумма за сегодня
  • (float) * amount_yesterday - сумма за вчера
  • (float) * amount_total - сумма всего
  • (int) * nof_links - общее количество ссылок
  • (int) * auto_activity_period - период запуска авторежима
  • (int) * flag_hide_links_from_se
  • (string) keyword - ключевое слово
  • (date) * date_trial_stop
  • (boolean) * trial_is_active
  • (int) * position_yandex - позиция в yandex
  • (int) * position_yandex_diff - изменение позиции в yandex
  • (date) * position_yandex_date_log - дата изменения позиции в yandex
(int) sape.url_add( (int) projectId, (string) url[, (string) name[, (int|string) keyword]] )
Оптимизатор
URL-ы

Добавление в проект нового УРЛа.

Имя Тип Обязательно По умолчанию Описание
projectId int Да - ID проекта
url string Да - УРЛ
name string Нет - Имя УРЛа
keyword int|string Нет - Ключевое слово
Тип Описание
int ID созданного УРЛа
(boolean) sape.url_update( (int) urlId, (array) params )
Оптимизатор
URL-ы

Изменение настроек УРЛа в соответствии с переданными параметрами.

Имя Тип Обязательно По умолчанию Описание
urlId int Да - ID УРЛа
params array Да - Содержит следующие значения:
  • (int) project_id - ID проекта
  • (string) url - урл
  • (string) name - название
  • (string) keyword - ключевое слово
  • (int) auto_activity_period - период запуска авторежима
  • (int) flag_hide_links_from_se_v2 - видимость урла для поисковиков (можно менять только раз в сутки):
    • 0 - ни от кого не скрывать
    • 1 - скрыть от Яндекса тегом noindex
    • 2 - скрыть от Google атрибутом rel="nofollow"
Тип Описание
boolean результат операции
(array) sape.get_url_anchors( (int) urlId )
Оптимизатор
URL-ы

Получение списока анкоров УРЛа.

Имя Тип Обязательно По умолчанию Описание
urlId int Да - ID УРЛа
Тип Описание
array Список, каждый элемент которого содержит:
  • (string) id - ID анкора
  • (string) anchor - анкор
  • (int) nof - количество использованных раз
  • (int) limit - максимальное использование
  • (int) * folder_id - ID папки
(int) sape.get_url_anchors_count( (int) urlId )
Оптимизатор
URL-ы

Получение количества анкоров УРЛа.

Имя Тип Обязательно По умолчанию Описание
urlId int Да - ID УРЛа
Тип Описание
int количества анкоров УРЛа
(array) sape.get_urls_anchors_count( [(array) params = null] )
Оптимизатор
URL-ы

Получение количества анкоров по списку УРЛов.

Имя Тип Обязательно По умолчанию Описание
params array Нет null Содержит следующие значения:
  • (int|array) project_id - ID проекта/проектов,
  • (int|array) url_id - ID урла/урлов
Тип Описание
array Список, каждый элемент которого содержит:
  • (int) url_id - ID УРЛа
  • (int) nof - количество анкоров
(boolean) sape.url_set_autoseo( (int) urlId, (boolean) flagAuto, (boolean) flagRequireConfirm )
Оптимизатор
URL-ы
Фильтры и автофильтры

Изменение режима модерации УРЛа.

Имя Тип Обязательно По умолчанию Описание
urlId int Да - ID УРЛа
flagAuto boolean Да - покупать сссылки автоматически
flagRequireConfirm boolean Да - необходимо подтверждение размещения ссылки
Тип Описание
boolean результат операции
(boolean) sape.url_delete( (int) urlId )

Удаление УРЛа.

Имя Тип Обязательно По умолчанию Описание
urlId int Да - ID УРЛа
Тип Описание
boolean результат операции
(array) sape.get_sites( [(array) options = null] )
Вебмастер
Сайты

Получение списока сайтов пользователя.

Имя Тип Обязательно По умолчанию Описание
options array Нет null Содержит следующие значения:
  • (boolean) show_days_to_recheck = false - показать количество дней до возможности запустить переиндексацию
  • (boolean) show_block_display_params = false - показать параметры блочного отображения ссылок
  • (boolean) show_traf_pages = false - показать количество трафиковых страниц
  • (int) pn = 0
  • (int) ps = 0
Тип Описание
array Список, каждый элемент которого содержит:
  • (int) id - ID сайта
  • (string) url - УРЛ
  • (int) cy - тИЦ
  • (int) sqi - ИКС
  • (int) pr - PR главной страницы
  • (int) moz_domain_authority - MOZ Domain Authority
  • (int) mj_cf - Majestic Citation Flow
  • (int) mj_tf - Majestic Trust Flow
  • (date) date_created - дата регистрации
  • (date) date_last_mpp_changed - дата последнего изменения максимума ссылок для площадки
  • (date) * date_blocked_in_yandex
  • (string) status = null - статус:
    • NEW - новый
    • IND - проиндексирован
    • OK - работает
    • IND_NOW - в процессе индексации
    • FAIL - не прошёл модерацию
    • IND_WAIT - ожидает индексацию
    • REIND_NOW - в процессе переиндексации
    • REIND_WAIT - ожидает переиндексацию
  • (int) category_id_v2 - ID категории
  • (int) comment_admin - комментарий модератора
  • (int) domain_level - уровень домена
  • (boolean) flag_auto - флаг авторежима
  • (int) mpp_1 - максимальное количество ссылок на 1-ом уровне
  • (int) mpp_2 - максимальное количество ссылок на 2-ом уровне
  • (int) mpp_3 - максимальное количество ссылок на 3-ем уровне
  • (boolean) flag_blocked_in_yandex - флаг забаненности в Yandex
  • (boolean) flag_hide_url - скрывать УРЛ
  • (string) links_delimiter - разделитель ссылок
  • (string) links_css_class - класс ссылок
  • (string) links_css_class_context - класс контекстных ссылок
  • (boolean) flag_use_unprintable_words_stop_list - использование стоп-слов adult-тематики
  • (boolean) flag_use_adult_words_stop_list - использование стоп-слов ненормативной лексики
  • (boolean) flag_use_ambiguous_words_stop_list - использование списка сомнительных слов-стоп
  • (boolean) flag_not_for_sale - флаг приостановки продажи ссылок
  • (float) amount_today - сумма за сегодня
  • (float) amount_yesterday - сумма за вчера
  • (float) amount_total - сумма всего
  • (int) nof_pages - количество страниц
  • (boolean) in_yaca - наличие сайта в Yandex каталоге
  • (boolean) in_dmoz - наличие сайта в DMOZ
  • (int) nof_yandex - количество страниц в Yandex
  • (int) nof_google - количество страниц в Google
  • (int) * days_to_recheck - количество страниц в Google
  • (boolean) show_only_block - флаг блочного отображения ссылок
  • (int) * nof_traf_pages - количество трафиковых страниц
  • (int) auto_set_prices - автоматически устанавливать новые цены на страницах
  • (array) * block_links_control = null - параметры блочного отображения ссылок:
    • (string) background_color - цвет фона
    • (string) border_color - цвет рамки
    • (string) header_color - цвет заголовка
    • (string) text_color - цвет текста
    • (string) url_color - цвет url-а
    • (string) sign_color - цвет подписи
    • (int) header_size - размер заголовка
    • (int) text_size - размер текста
    • (int) url_size - размер урла
    • (int) sign_size - размер подписи
    • (int) border_width - ширина рамки
    • (boolean) border_use_radius - закруглять урлы
    • (string) text_align - выравнивание текста внутри блока
    • (string) text_sign - текст подписи
    • (int) block_orientation - ориентация текста внутри блока (0 вертикальная, 1 - горизонтальная)
    • (boolean) show_header - флаг показа заголовка
    • (boolean) show_url - флаг показа урла
    • (string) block_width_custom - ширина блока
    • (string) css_class_prefix - префикс названий классов css
    • (boolean) block_no_css - (0 - генерировать автоматически и внедрять в код страницы, 1 - использовать свою таблицу стилей)
    • (string) block_width - ширина блока ссылок
    • (string) block_width_unit - тип измерения ширины (px или %)
    • (string) * header_text_decoration
    • (string) * text_text_decoration
    • (string) * url_text_decoration
    • (string) * sign_text_decoration
  • (float) traf_factor - количество дней до возможности запустить переиндексацию
(int) sape.site_add( (string) url, (int) categoryId[, (string) urlCode = null] )
Вебмастер
Сайты

Добавление площадки в систему.

Имя Тип Обязательно По умолчанию Описание
url string Да - УРЛ
categoryId int Да - ID категории
urlCode string Нет null УРЛ страницы, на которой размещен клиентский код
Тип Описание
int ID сайта
(boolean) sape.site_update( (int) siteId, (array) params )
Вебмастер
Сайты

Изменение настроек сайта в соответствии с переданными параметрами.

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID сайта
params array Да - Содержит следующие значения:
  • (boolean) auto - автоматический режим
  • (boolean) flag_hide_url - скрывать урл
  • (boolean) flag_use_unprintable_words_stop_list - использовать списки слов-стоп ненормативной лексики
  • (boolean) flag_use_adult_words_stop_list - использовать списки слов-стоп adult-тематики
  • (boolean) flag_use_ambiguous_words_stop_list - использовать списки сомнительных слов-стоп
  • (boolean) flag_reject_foreign_words - не принимать ссылки полностью на латинице
  • (boolean) auto_activate_pages - автоматически активировать новые страницы
  • (boolean) flag_not_for_sale - не принимать новые заявки на сайт
  • (boolean) flag_no_dispenser_check - на этом сайте ссылки размещаются «вручную»
  • (boolean) auto_set_prices - автоматически устанавливать новые цены
  • (int) nof_placements_autostop - количество ссылок в статусе OK после которого следует останавливать прием заявок
  • (float) price_context_factor_l1 - установка множителя цены для контекстных ссылок с главной страницы
  • (float) price_context_factor_l2 - установка множителя цены для контекстных ссылок для страниц второго уровня
  • (float) price_context_factor_l3 - установка множителя цены для контекстных ссылок для страниц третьего уровня
  • (float) traf_factor - установка множителя цены для траффиковых страниц, цены обновляются сразу
  • (boolean) show_only_block - режим отображения ссылок (0 - смешанный, 1 - только в формате блоков)
  • (array) block_links_control = null - параметры блочного отображения ссылок:
    • (string) background_color - цвет фона
    • (string) border_color - цвет рамки
    • (string) header_color - цвет заголовка
    • (string) text_color - цвет текста
    • (string) url_color - цвет url-а
    • (string) sign_color - цвет подписи
    • (int) header_size - размер заголовка
    • (int) text_size - размер текста
    • (int) url_size - размер урла
    • (int) sign_size - размер подписи
    • (int) border_width - ширина рамки
    • (boolean) border_use_radius - закруглять урлы
    • (string) text_align - выравнивание текста внутри блока
    • (string) text_sign - текст подписи
    • (int) block_orientation - ориентация текста внутри блока (0 вертикальная, 1 - горизонтальная)
    • (boolean) show_header - флаг показа заголовка
    • (boolean) show_url - флаг показа урла
    • (string) block_width_custom - ширина блока
    • (string) css_class_prefix - префикс названий классов css
    • (boolean) block_no_css - (0 - генерировать автоматически и внедрять в код страницы, 1 - использовать свою таблицу стилей)
    • (string) block_width - ширина блока ссылок
    • (string) block_width_unit - тип измерения ширины (px или %)
    • (string) * header_text_decoration
    • (string) * text_text_decoration
    • (string) * url_text_decoration
    • (string) * sign_text_decoration
  • (int) sitewide_nof_extra - максимальное кол-во сквозных размещений на страницe
  • (float) sitewide_placement_price - цена размещения для сквозных ссылок
  • (boolean) sitewide_packet_auto_accept - автоакцепт пакетов сквозных ссылок
  • (int) discount_1_persent_sitewide - дисконт сквозного размещения
  • (int) discount_2_persent_sitewide - дисконт сквозного размещения
  • (int) discount_3_persent_sitewide - дисконт сквозного размещения
  • (int) discount_4_persent_sitewide - дисконт сквозного размещения
  • (int) discount_5_persent_sitewide - дисконт сквозного размещения
  • (int) discount_6_persent_sitewide - дисконт сквозного размещения
  • (int) discount_7_persent_sitewide - дисконт сквозного размещения
  • (int) discount_8_persent_sitewide - дисконт сквозного размещения
  • (int) discount_9_persent_sitewide - дисконт сквозного размещения
  • (int) discount_10_persent_sitewide - дисконт сквозного размещения
  • (int) discount_11_persent_sitewide - дисконт сквозного размещения
  • (int) discount_12_persent_sitewide - дисконт сквозного размещения
  • (int) discount_13_persent_sitewide - дисконт сквозного размещения
  • (int) discount_14_persent_sitewide - дисконт сквозного размещения
  • (int) discount_15_persent_sitewide - дисконт сквозного размещения
  • (int) discount_16_persent_sitewide - дисконт сквозного размещения
  • (int) discount_17_persent_sitewide - дисконт сквозного размещения
  • (int) discount_18_persent_sitewide - дисконт сквозного размещения
  • (int) discount_19_persent_sitewide - дисконт сквозного размещения
  • (int) discount_20_persent_sitewide - дисконт сквозного размещения
  • (int) discount_21_persent_sitewide - дисконт сквозного размещения
  • (int) discount_22_persent_sitewide - дисконт сквозного размещения
  • (int) discount_23_persent_sitewide - дисконт сквозного размещения
  • (int) discount_24_persent_sitewide - дисконт сквозного размещения
  • (int) discount_25_persent_sitewide - дисконт сквозного размещения
  • (int) discount_26_persent_sitewide - дисконт сквозного размещения
  • (int) discount_27_persent_sitewide - дисконт сквозного размещения
  • (int) discount_28_persent_sitewide - дисконт сквозного размещения
  • (int) discount_29_persent_sitewide - дисконт сквозного размещения
  • (int) discount_30_persent_sitewide - дисконт сквозного размещения
  • (int) discount_31_persent_sitewide - дисконт сквозного размещения
  • (int) discount_32_persent_sitewide - дисконт сквозного размещения
  • (int) discount_33_persent_sitewide - дисконт сквозного размещения
  • (int) discount_34_persent_sitewide - дисконт сквозного размещения
  • (int) discount_35_persent_sitewide - дисконт сквозного размещения
  • (int) discount_36_persent_sitewide - дисконт сквозного размещения
  • (int) discount_37_persent_sitewide - дисконт сквозного размещения
  • (int) discount_38_persent_sitewide - дисконт сквозного размещения
  • (int) discount_39_persent_sitewide - дисконт сквозного размещения
  • (int) discount_40_persent_sitewide - дисконт сквозного размещения
  • (int) discount_41_persent_sitewide - дисконт сквозного размещения
  • (int) discount_42_persent_sitewide - дисконт сквозного размещения
  • (int) discount_43_persent_sitewide - дисконт сквозного размещения
  • (int) discount_44_persent_sitewide - дисконт сквозного размещения
  • (int) discount_45_persent_sitewide - дисконт сквозного размещения
  • (int) discount_46_persent_sitewide - дисконт сквозного размещения
  • (int) discount_47_persent_sitewide - дисконт сквозного размещения
  • (int) discount_48_persent_sitewide - дисконт сквозного размещения
  • (int) discount_49_persent_sitewide - дисконт сквозного размещения
  • (int) discount_50_persent_sitewide - дисконт сквозного размещения
  • (int) discount_51_persent_sitewide - дисконт сквозного размещения
  • (int) discount_52_persent_sitewide - дисконт сквозного размещения
  • (int) discount_53_persent_sitewide - дисконт сквозного размещения
  • (int) discount_54_persent_sitewide - дисконт сквозного размещения
  • (int) discount_55_persent_sitewide - дисконт сквозного размещения
  • (int) discount_56_persent_sitewide - дисконт сквозного размещения
  • (int) discount_57_persent_sitewide - дисконт сквозного размещения
  • (int) discount_58_persent_sitewide - дисконт сквозного размещения
  • (int) discount_59_persent_sitewide - дисконт сквозного размещения
  • (int) discount_60_persent_sitewide - дисконт сквозного размещения
  • (int) discount_61_persent_sitewide - дисконт сквозного размещения
  • (int) discount_62_persent_sitewide - дисконт сквозного размещения
  • (int) discount_63_persent_sitewide - дисконт сквозного размещения
  • (int) discount_64_persent_sitewide - дисконт сквозного размещения
  • (int) discount_65_persent_sitewide - дисконт сквозного размещения
  • (int) discount_66_persent_sitewide - дисконт сквозного размещения
  • (int) discount_67_persent_sitewide - дисконт сквозного размещения
  • (int) discount_68_persent_sitewide - дисконт сквозного размещения
  • (int) discount_69_persent_sitewide - дисконт сквозного размещения
  • (int) discount_70_persent_sitewide - дисконт сквозного размещения
  • (int) discount_71_persent_sitewide - дисконт сквозного размещения
  • (int) discount_72_persent_sitewide - дисконт сквозного размещения
  • (int) discount_73_persent_sitewide - дисконт сквозного размещения
  • (int) discount_74_persent_sitewide - дисконт сквозного размещения
  • (int) discount_75_persent_sitewide - дисконт сквозного размещения
  • (int) discount_76_persent_sitewide - дисконт сквозного размещения
  • (int) discount_77_persent_sitewide - дисконт сквозного размещения
  • (int) discount_78_persent_sitewide - дисконт сквозного размещения
  • (int) discount_79_persent_sitewide - дисконт сквозного размещения
  • (int) discount_80_persent_sitewide - дисконт сквозного размещения
  • (int) discount_81_persent_sitewide - дисконт сквозного размещения
  • (int) discount_82_persent_sitewide - дисконт сквозного размещения
  • (int) discount_83_persent_sitewide - дисконт сквозного размещения
  • (int) discount_84_persent_sitewide - дисконт сквозного размещения
  • (int) discount_85_persent_sitewide - дисконт сквозного размещения
  • (int) discount_86_persent_sitewide - дисконт сквозного размещения
  • (int) discount_87_persent_sitewide - дисконт сквозного размещения
  • (int) discount_88_persent_sitewide - дисконт сквозного размещения
  • (int) discount_89_persent_sitewide - дисконт сквозного размещения
  • (int) discount_90_persent_sitewide - дисконт сквозного размещения
  • (int) discount_91_persent_sitewide - дисконт сквозного размещения
  • (int) discount_92_persent_sitewide - дисконт сквозного размещения
  • (int) discount_93_persent_sitewide - дисконт сквозного размещения
  • (int) discount_94_persent_sitewide - дисконт сквозного размещения
  • (int) discount_95_persent_sitewide - дисконт сквозного размещения
  • (int) discount_96_persent_sitewide - дисконт сквозного размещения
  • (int) discount_97_persent_sitewide - дисконт сквозного размещения
  • (int) discount_98_persent_sitewide - дисконт сквозного размещения
  • (int) discount_99_persent_sitewide - дисконт сквозного размещения
  • (int) discount_100_persent_sitewide - дисконт сквозного размещения
Тип Описание
boolean результат операции
(int) sape.get_site_pages_count( (int) siteId[, (string) status = null] )
Вебмастер
Сайты
Страницы

Количество страниц по одному сайту.

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID сайта
status string Нет null статус страницы:
  • NEW - новая
  • OK - активная
  • DEL - удалена
  • NO_CODE - код не найден
Тип Описание
int количество страниц по одному сайту
(int) sape.get_site_pages_context_count( (int) siteId[, (string) status = null] )
Вебмастер
Сайты
Страницы

Количество контекстных страниц по одному сайту.

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID сайта
status string Нет null статус страницы:
  • NEW - новая
  • OK - активная
  • DEL - удалена
  • NO_CODE - код не найден
Тип Описание
int количество контекстных страниц по одному сайту
(array) sape.get_sites_folders()
Вебмастер
Сайты

Получение списка разделов для сайтов.

Тип Описание
array Список, каждый элемент которого содержит:
  • (int) site_id - ID сайта
  • (int) folder_id - ID раздела
  • (string) folder_name - название раздела
(boolean) sape.site_move_to_folder( (int) siteId, (int) folderId )
Вебмастер
Сайты

Перенос cайта в другой раздел.

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID сайта
folderId int Да - ID директории
Тип Описание
boolean результат операции
(array) sape.get_site_regions( (int) siteId )
Вебмастер
Сайты

Получение списка регионов сайта.

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID сайта
Тип Описание
array Список регионов сайта
(boolean) sape.site_set_max_per_page( (int) siteId[, (array) params = null] )
Вебмастер
Сайты

Установка максимального количества ссылок. Увеличивать максимальное количество ссылок можно не чаще чем 1 раз в 2 недели.

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID сайта
params array Нет null Содержит следующие значения:
  • (int) mpp_1 - максимальное количество ссылок для главной
  • (int) mpp_2 - максимальное количество ссылок для страниц второго уровня
  • (int) mpp_3 - максимальное количество ссылок для страниц третьего уровня
Тип Описание
boolean результат операции
(boolean) sape.site_reindex( (int) siteId )
Вебмастер
Сайты

Отправка сайта на переиндексацию страниц.

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID сайта
Тип Описание
boolean результат операции
(boolean) sape.site_delete( (int) siteId )
Вебмастер
Сайты

Удаление площадки из системы.

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID сайта
Тип Описание
boolean результат операции
(array) sape.get_site_page( (int) siteId, (int) pageId )
Вебмастер
Сайты
Страницы

Получение свойств страницы сайта.

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID сайта
pageId int Да - ID страницы
Тип Описание
array Содержит следующие значения:
  • (int) id - ID страницы
  • (string) status - стату
  • (string) status_context - контекстный стату
  • (string) uri - УРЛ страницы
  • (int) pr - PR
  • (int) level - уровень вложенности
  • (int) ext_links - количество внешних ссылок
  • (float) price - цена
  • (int) nof_placements - количество ссылок
  • (int) sape_rank - Sape Rank
  • (int) page_authority - MOZ Authority
  • (int) page_mozrank - MOZ Rank
(array) sape.get_site_pages( (int) siteId[, (array) filter = null] )
Вебмастер
Сайты
Страницы

Получение списка страниц сайта.

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID сайта
filter array Нет null Содержит следующие значения:
  • (int) level
  • (int) pr
  • (int) only_ext_links
  • (int) only_indexed_in_yandex
  • (int) pn = 0
  • (int) ps = 0
Тип Описание
array Список, каждый элемент которого содержит:
  • (int) id - ID страницы
  • (string) status - стату
  • (string) status_context - контекстный стату
  • (string) uri - УРЛ страницы
  • (int) pr - PR
  • (int) level - уровень вложенности
  • (int) ext_links - количество внешних ссылок
  • (float) price - цена
  • (int) nof_placements - количество ссылок
  • (int) sape_rank - Sape Rank
  • (int) page_authority - MOZ Authority
  • (int) page_mozrank - MOZ Rank
(int) sape.site_pages_activate( [(int) siteId = null[, (int|array) pageIds = null[, (boolean) flagContext = false]]] )
Вебмастер
Сайты
Страницы

Активация страниц сайта.

Имя Тип Обязательно По умолчанию Описание
siteId int Нет null ID сайта
pageIds int|array Нет null ID страниц
flagContext boolean Нет false если указано true, то будет активирована контекстная страница, в противном случае - обычная
Тип Описание
int количество активированных страниц
(int) sape.site_pages_exclude( [(int) siteId = null[, (int|array) pageIds = null[, (boolean) flagContext = false]]] )
Вебмастер
Сайты
Страницы

Исключение страниц сайта.

Имя Тип Обязательно По умолчанию Описание
siteId int Нет null ID сайта
pageIds int|array Нет null ID страниц
flagContext boolean Нет false если указано true, то будет исключена контекстная страница, в противном случае - обычная
Тип Описание
int количество исключенных страниц
(int) sape.site_pages_purge( [(int) siteId = null[, (int|array) pageIds = null[, (boolean) flagContext = false]]] )
Вебмастер
Сайты
Страницы

Удаление страниц сайта.

Имя Тип Обязательно По умолчанию Описание
siteId int Нет null ID сайта
pageIds int|array Нет null ID страниц
flagContext boolean Нет false если указано true, то будет удалена контекстная страница, в противном случае - обычная
Тип Описание
int количество удаленных страниц
(array) sape.get_sites_pages_count( [(string) status = null] )
Вебмастер
Сайты
Страницы

Получение количества страниц по сайтам.

Имя Тип Обязательно По умолчанию Описание
status string Нет null статус страницы:
  • NEW - новая
  • OK - активная
  • DEL - удалена
  • NO_CODE - код не найден
Тип Описание
array Список, каждый элемент которого содержит:
  • (int) site_id - ID сайта
  • (int) nof - количество страниц
(array) sape.get_sites_pages_context_count( [(string) status = null] )
Вебмастер
Сайты
Страницы

Получение количества контекстных страниц по сайтам.

Имя Тип Обязательно По умолчанию Описание
status string Нет null статус страницы:
  • NEW - новая
  • OK - активная
  • DEL - удалена
  • NO_CODE - код не найден
Тип Описание
array Список, каждый элемент которого содержит:
  • (int) site_id - ID сайта
  • (int) nof - количество страниц
(boolean) sape.page_update_price( (int) siteId, (int) pageId, (float) priceNew[, (boolean) changePlaced = false] )
Вебмастер
Страницы

Изменение цены страницы.

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID сайта
pageId int Да - ID страницы
priceNew float Да - цена
changePlaced boolean Нет false обновятся цены на проданные ссылки
Тип Описание
boolean результат операции
(boolean) sape.pages_update_price( (int) siteId, (int) level, (int) pr, (float) priceNew[, (boolean) changePlaced = false] )
Вебмастер
Страницы

Изменение цены страниц.

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID сайта
level int Да - уровень вложенности (от 1 до 3)
pr int Да - PageRank (от 0 до 9), может принимать значение 'all', если необходимо установить одну цену для определенного уровня вложенности
priceNew float Да - цена
changePlaced boolean Нет false обновятся цены на проданные ссылки
Тип Описание
boolean результат операции
(array) sape.get_project_money_stats( (int) projectId[, (int) year = null[, (int) month = null[, (int) day = null]]] )
Оптимизатор
Проекты

Получение статистики расходов по проекту.

Имя Тип Обязательно По умолчанию Описание
projectId int Да - ID проекта
year int Нет null год выборки
month int Нет null месяц выборки
day int Нет null день выборки
Тип Описание
array Список, каждый элемент которого содержит:
  • (date) date_logged - дата
  • (float) sum - сумма
(array) sape.get_projects_money_stats( [(int) year = null[, (int) month = null[, (int) day = null]]] )
Оптимизатор
Проекты

Получение статистики расходов по всем проектам.

Имя Тип Обязательно По умолчанию Описание
year int Нет null год выборки
month int Нет null месяц выборки
day int Нет null день выборки
Тип Описание
array Список, каждый элемент которого содержит:
  • (date) date_logged - дата
  • (int) project_id - ID проекта
  • (float) sum - сумма
(array) sape.get_url_money_stats( (int) urlId[, (int) year = null[, (int) month = null[, (int) day = null]]] )
Оптимизатор
URL-ы

Получение статистики расходов по УРЛу.

Имя Тип Обязательно По умолчанию Описание
urlId int Да - ID УРЛа
year int Нет null год выборки
month int Нет null месяц выборки
day int Нет null день выборки
Тип Описание
array Список, каждый элемент которого содержит:
  • (date) date_logged - дата
  • (float) sum - сумма
(array) sape.get_urls_money_stats( (array) urlIds, (int) year[, (int) month = null[, (int) day = null]] )

Получение статистики расходов для списка УРЛов.

Имя Тип Обязательно По умолчанию Описание
urlIds array Да - список ID УРЛов
year int Да - год выборки
month int Нет null месяц выборки
day int Нет null день выборки
Тип Описание
array Список, каждый элемент которого содержит:
  • (int) id - ID УРЛа
  • (date) date_logged - дата
  • (float) sum - сумма
(array) sape.get_site_money_stats( (int) siteId[, (int) year = null[, (int) month = null[, (int) day = null]]] )
Вебмастер
Сайты

Получение статистики расходов по сайту.

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID сайта
year int Нет null год выборки
month int Нет null месяц выборки
day int Нет null день выборки
Тип Описание
array Список, каждый элемент которого содержит:
  • (date) date_logged - дата
  • (float) sum - сумма
(array) sape.get_balance_money_stats( [(int) year = null[, (int) month = null[, (int) day = null]]] )
Оптимизатор
Вебмастер
Баланс

Получение статистики изменений баланса.

Имя Тип Обязательно По умолчанию Описание
year int Нет null Год выборки
month int Нет null Месяц выборки
day int Нет null День выборки
Тип Описание
array Список, каждый элемент которого содержит:
  • (date) date_logged - дата
  • (string) description - описание
  • (float) amount - сумма
  • (float) balance - баланс
(array) sape.get_partners_money_stats( [(int) year = null[, (int) month = null[, (int) day = null]]] )
Оптимизатор
Вебмастер
Баланс

Получение статистики по партнерской программе.

Имя Тип Обязательно По умолчанию Описание
year int Нет null Год выборки
month int Нет null Месяц выборки
day int Нет null День выборки
Тип Описание
array Список, каждый элемент которого содержит:
  • (date) date_logged - дата
  • (int) partner_id - ID партнера
  • (float) sum - сумма
(array) sape.get_filters( [(array) options = null] )
Оптимизатор
Фильтры и автофильтры

Получение списка фильтров.

Имя Тип Обязательно По умолчанию Описание
options array Нет null Содержит следующие значения:
  • (boolean) show_params = false - показать значение фильтров виде хэша
  • (boolean) show_extended = false - показать значение дополнительных параметров фильтра
  • (boolean) show_auto_list = true - показать список автофильтров
  • (array) filter_id - список ID фильтров
Тип Описание
array Список, каждый элемент которого содержит:
  • (int) id - ID фильтра
  • (string) name - название фильтра
  • (array) * params = null Содержит следующие значения:
    • (int) ext_links - максимальное число внешних ссылок
    • (int) ext_links_forecast - прогнозируемое число внешних ссылок
    • (int) cy_from - минимальное знаение тИЦ
    • (int) cy_2 - максимальное значение тИЦ
    • (int) sqi_1 - минимальное знаение ИКС
    • (int) sqi_2 - максимальное значение ИКС
    • (int) pr_from - минимальное значение PR
    • (int) pr_2 - максимальное значение PR
    • (int) tr_1 - минимальное значение SapeRank
    • (int) tr_2 - максимальное значение SapeRank
    • (float) price_from - минимальная цена страницы
    • (float) price_2 - максимальная цена страницы
    • (int) level_from - минимальный уровень вложенности страницы
    • (int) level_2 - максимальный уровень вложенности страницы
    • (int) in_yaca = null - сайты из YACA:
      • 0 - только не в YACA
      • 1 - только в YACA
    • (int) in_dmoz = null - сайты из DMOZ:
      • 0 - только не в DMOZ
      • 1 - только в DMOZ
    • (int) domain_level - уровень домена
    • (int) no_double_in_project - не отображать сайты, уже купленные в рамках других URL текущего проекта
    • (int) flag_blocked_in_yandex = null - наличие в Yandex:
      • 0 - есть (по умолчанию)
      • 1 - нет
      • 2 - не важно
    • (int) flag_blocked_in_google = null - наличие в Google:
      • 0 - есть
      • 1 - нет
      • 2 - не важно (по умолчанию)
    • (string) words - ключевые слова
    • (int) words_type = null - где искать ключевые слова:
      • 0 - в тексте страниц (по-умолчанию)
      • 1 - в title страниц
    • (int) links_display_mode = null - форма вывода ссылок, если не передан, то не важно:
      • 0 - стандартный
      • 1 - блочный
      • 2 - стандартный + блочный
    • (int) nogood = null - область поиска:
      • 0 - все сайты
      • 1 - основная база
      • 2 - сайты сомнительного содержания
    • (int) date_added - количество дней, которые прошли с момента регистрации сайта в системе
    • (string) domain_zones - список ID доменных зон
    • (int) days_old_whois - количество дней, которые прошли с момента регистрации сайта
    • (string) categories_v2 - список ID категорий
    • (string) whitelists - список ID списков избранного
    • (string) regions - список ID регионов
    • (string) yaca_categories - список ID категорий YACA
    • (string) page_languages - массив идентификаторов языков страниц сайта (sape.get_languages — список допустимых значений)
    • (string) site_languages - массив идентификаторов преобладающих языков сайта (sape.get_languages — список допустимых значений)
    • (float) int_rank_1 - минимальное значение Sape IntRank
    • (float) int_rank_2 - максимальное значение Sape IntRank
    • (int) mj_cf_1 - минимальное значение Majestic Citation Flow
    • (int) mj_cf_2 - максимальное значение Majestic Citation Flow
    • (int) mj_tf_1 - минимальное значение Majestic Trust Flow
    • (int) mj_tf_2 - максимальное значение Majestic Trust Flow
    • (int) moz_domain_authority_1 - минимальное значение MOZ Domain Authority
    • (int) moz_domain_authority_2 - максимальное значение MOZ Domain Authority
    • (string) url_stop_words
    • (int) no_double_in_system - отображать площадки с размещенными ссылками
    • (array) url_ids - УРЛы с автовильтром
(int) sape.filter_create( (string) filterName, (array) filter )
Оптимизатор
Фильтры и автофильтры

Добавление фильтра с указанными параметрами.

Имя Тип Обязательно По умолчанию Описание
filterName string Да - имя фильтра
filter array Да - Содержит следующие значения:
  • (int) cy_from - минимальное знаение тИЦ
  • (int) cy_2 - максимальное значение тИЦ
  • (int) sqi_1 - минимальное знаение ИКС
  • (int) sqi_2 - максимальное значение ИКС
  • (int) domain_level = 0 - уровень домена:
    • 0 - все уровни
    • 2 - второго уровня
    • 3 - третьего уровня
  • (array) domain_zones - массив с ID доменных зон
  • (array) categories_v2 - массив с ID категорий
  • (array) regions - массив с ID регионов
  • (array) yaca_categories - массив с ID категорий YACA
  • (array) whitelists - массив с ID списков избранного
  • (int) flag_blocked_in_yandex = null - наличие в Yandex:
    • 0 - есть (по умолчанию)
    • 1 - нет
    • 2 - не важно
  • (int) flag_blocked_in_google = null - наличие в Google:
    • 0 - есть
    • 1 - нет
    • 2 - не важно (по умолчанию)
  • (int) in_yaca = null - сайты из YACA:
    • 0 - только не в YACA
    • 1 - только в YACA
  • (int) in_dmoz = null - сайты из DMOZ:
    • 0 - только не в DMOZ
    • 1 - только в DMOZ
  • (int) days_old_whois - количество дней, которые прошли с момента регистрации сайта
  • (int) date_added - количество дней, которые прошли с момента регистрации сайта в системе
  • (int) nogood = null - область поиска:
    • 0 - все сайты
    • 1 - основная база
    • 2 - сайты сомнительного содержания
  • (boolean) double - отображать площадки с размещенными ссылками
  • (boolean) no_double_in_project - не отображать сайты, уже купленные в рамках других URL текущего проекта
  • (boolean) no_double_in_system - не отображать сайты, уже купленные в рамках других URL других проектов
  • (boolean) no_double_in_folder - не отображать сайты, уже купленные в рамках других URL текущего раздела
  • (float) price_from - минимальная цена страницы
  • (float) price_2 - максимальная цена страницы
  • (int) pr_from - минимальное значение PR
  • (int) pr_2 - максимальное значение PR
  • (int) site_pr_1 - минимальное значение PR главной
  • (int) site_pr_2 - максимальное значение PR главной
  • (int) tr_1 - минимальное значение SapeRank
  • (int) tr_2 - максимальное значение SapeRank
  • (int) mj_cf_1 - минимальное значение Majestic Citation Flow
  • (int) mj_cf_2 - максимальное значение Majestic Citation Flow
  • (int) mj_tf_1 - минимальное значение Majestic Trust Flow
  • (int) mj_tf_2 - максимальное значение Majestic Trust Flow
  • (int) moz_domain_authority_1 - минимальное значение MOZ Domain Authority
  • (int) moz_domain_authority_2 - максимальное значение MOZ Domain Authority
  • (int) page_mozrank_1 - минимальное значение MOZ Page Rank
  • (int) page_mozrank_2 - максимальное значение MOZ Page Rank
  • (int) page_authority_1 - минимальное значение MOZ Page Authority
  • (int) page_authority_2 - максимальное значение MOZ Page Authority
  • (int) level_from - минимальный уровень вложенности страницы
  • (int) level_2 - максимальный уровень вложенности страницы
  • (int) ext_links - максимальное число внешних ссылок
  • (int) ext_links_forecast - прогнозируемое число внешних ссылок
  • (array) page_languages - массив идентификаторов языков страниц сайта (sape.get_languages — список допустимых значений)
  • (array) site_languages - массив идентификаторов преобладающих языков сайта (sape.get_languages — список допустимых значений)
  • (string) words - ключевые слова
  • (int) words_type = null - где искать ключевые слова:
    • 0 - в тексте страниц (по-умолчанию)
    • 1 - в title страниц
  • (int) links_display_mode = null - форма вывода ссылок, если не передан, то не важно:
    • 0 - стандартный
    • 1 - блочный
    • 2 - стандартный + блочный
  • (int) schemas_access = null - схемы сайта, если не передан, то не важно:
    • 1 - только http
    • 2 - только https
    • 3 - http и https
  • (float) int_rank_1 - минимальное значение Sape IntRank
  • (float) int_rank_2 - максимальное значение Sape IntRank
Тип Описание
int ID нового фильтра
(boolean) sape.filter_update( (int) filterId, (array) filter )
Оптимизатор
Фильтры и автофильтры

Изменение параметров фильтра.

Имя Тип Обязательно По умолчанию Описание
filterId int Да - ID фильтра
filter array Да - Содержит следующие значения:
  • (string) filter_name - название фильтра
  • (int) cy_from - минимальное знаение тИЦ
  • (int) cy_2 - максимальное значение тИЦ
  • (int) sqi_1 - минимальное знаение ИКС
  • (int) sqi_2 - максимальное значение ИКС
  • (int) domain_level = 0 - уровень домена:
    • 0 - все уровни
    • 2 - второго уровня
    • 3 - третьего уровня
  • (array) domain_zones - массив с ID доменных зон
  • (array) categories_v2 - массив с ID категорий
  • (array) regions - массив с ID регионов
  • (array) yaca_categories - массив с ID категорий YACA
  • (array) whitelists - массив с ID списков избранного
  • (int) flag_blocked_in_yandex = null - наличие в Yandex:
    • 0 - есть (по умолчанию)
    • 1 - нет
    • 2 - не важно
  • (int) flag_blocked_in_google = null - наличие в Google:
    • 0 - есть
    • 1 - нет
    • 2 - не важно (по умолчанию)
  • (int) in_yaca = null - сайты из YACA:
    • 0 - только не в YACA
    • 1 - только в YACA
  • (int) in_dmoz = null - сайты из DMOZ:
    • 0 - только не в DMOZ
    • 1 - только в DMOZ
  • (int) days_old_whois - количество дней, которые прошли с момента регистрации сайта
  • (int) date_added - количество дней, которые прошли с момента регистрации сайта в системе
  • (int) nogood = null - область поиска:
    • 0 - все сайты
    • 1 - основная база
    • 2 - сайты сомнительного содержания
  • (boolean) double - отображать площадки с размещенными ссылками
  • (boolean) no_double_in_project - не отображать сайты, уже купленные в рамках других URL текущего проекта
  • (boolean) no_double_in_system - не отображать сайты, уже купленные в рамках других URL других проектов
  • (boolean) no_double_in_folder - не отображать сайты, уже купленные в рамках других URL текущего раздела
  • (float) price_from - минимальная цена страницы
  • (float) price_2 - максимальная цена страницы
  • (int) pr_from - минимальное значение PR
  • (int) pr_2 - максимальное значение PR
  • (int) site_pr_1 - минимальное значение PR главной
  • (int) site_pr_2 - максимальное значение PR главной
  • (int) tr_1 - минимальное значение SapeRank
  • (int) tr_2 - максимальное значение SapeRank
  • (int) mj_cf_1 - минимальное значение Majestic Citation Flow
  • (int) mj_cf_2 - максимальное значение Majestic Citation Flow
  • (int) mj_tf_1 - минимальное значение Majestic Trust Flow
  • (int) mj_tf_2 - максимальное значение Majestic Trust Flow
  • (int) moz_domain_authority_1 - минимальное значение MOZ Domain Authority
  • (int) moz_domain_authority_2 - максимальное значение MOZ Domain Authority
  • (int) page_mozrank_1 - минимальное значение MOZ Page Rank
  • (int) page_mozrank_2 - максимальное значение MOZ Page Rank
  • (int) page_authority_1 - минимальное значение MOZ Page Authority
  • (int) page_authority_2 - максимальное значение MOZ Page Authority
  • (int) level_from - минимальный уровень вложенности страницы
  • (int) level_2 - максимальный уровень вложенности страницы
  • (int) ext_links - максимальное число внешних ссылок
  • (int) ext_links_forecast - прогнозируемое число внешних ссылок
  • (array) page_languages - массив идентификаторов языков страниц сайта (sape.get_languages — список допустимых значений)
  • (array) site_languages - массив идентификаторов преобладающих языков сайта (sape.get_languages — список допустимых значений)
  • (string) words - ключевые слова
  • (int) words_type = null - где искать ключевые слова:
    • 0 - в тексте страниц (по-умолчанию)
    • 1 - в title страниц
  • (int) links_display_mode = null - форма вывода ссылок, если не передан, то не важно:
    • 0 - стандартный
    • 1 - блочный
    • 2 - стандартный + блочный
  • (int) schemas_access = null - схемы сайта, если не передан, то не важно:
    • 1 - только http
    • 2 - только https
    • 3 - http и https
  • (float) int_rank_1 - минимальное значение Sape IntRank
  • (float) int_rank_2 - максимальное значение Sape IntRank
Тип Описание
boolean результат операции
(array) sape.get_filters_auto( (array) urlIds[, (boolean) showParams = false] )
Оптимизатор
Фильтры и автофильтры

Получение списка автофильтров для списка УРЛов.

Имя Тип Обязательно По умолчанию Описание
urlIds array Да - список УРЛов
showParams boolean Нет false если равно true, то добавляются следующие поля: current_quant, current_price
Тип Описание
array Список, каждый элемент которого содержит:
  • (int) filter_auto_id - ID автофильтра
  • (int) filter_id - ID фильтра
  • (int) url_id - ID урла
  • (int) quant - общая квота по ссылкам
  • (float) price - бюджет автофильтра
  • (int) daily_quota - дневная квота по ссылкам
  • (int) * anchor_group_id
  • (int) * current_quant - количество купленных ссылок
  • (float) * current_price - стоимость купленных ссылок
(int) sape.filter_auto_create( (int) filterId, (int) urlId, (int) quant, (float) price, (int) dailyQuota )
Оптимизатор
Фильтры и автофильтры

Создание авто-фильтра для урла.

Имя Тип Обязательно По умолчанию Описание
filterId int Да - ID фильтра
urlId int Да - ID УРЛа
quant int Да - количество
price float Да - цена
dailyQuota int Да - дневная квота
Тип Описание
int ID авто-фильтра
(boolean) sape.filter_auto_update( (int) filterAutoId, (int) quant, (float) price, (int) dailyQuota )
Оптимизатор
Фильтры и автофильтры

Изменение авто-фильтра для УРЛа.

Имя Тип Обязательно По умолчанию Описание
filterAutoId int Да - ID авто-фильтра
quant int Да - количество
price float Да - цена
dailyQuota int Да - дневная квота
Тип Описание
boolean результат операции
(boolean) sape.filter_auto_delete( (int) filterAutoId )
Оптимизатор
Фильтры и автофильтры

Удаление авто-фильтра.

Имя Тип Обязательно По умолчанию Описание
filterAutoId int Да - ID авто-фильтра
Тип Описание
boolean результат операции
(boolean) sape.filter_delete( (int) filterId[, (boolean) forceDelete = false] )
Оптимизатор
Фильтры и автофильтры

Удаление фильтра.

Имя Тип Обязательно По умолчанию Описание
filterId int Да - ID фильтра
forceDelete boolean Нет false если параметр true, то удаляет все автофильтры которые привязаны к фильтру, в противном случае выполняет проверку есть ли автофильтры и если есть, то не будет удалять фильтр
Тип Описание
boolean результат операции
(array) sape.search( (int) urlId, (array) filter[, (int) pn[, (int) ps = 100]] )
Оптимизатор
Поиск площадок

Поиск сайтов и страниц для УРЛа urlId по параметрам.

Имя Тип Обязательно По умолчанию Описание
urlId int Да - ID УРЛа
filter array Да - фильтр:
  • (string) site_id - ID сайта, можно через запятую
  • (string) page_id - ID страницы, можно через запятую
  • (int) cy_from - минимальное знаение тИЦ
  • (int) cy_2 - максимальное значение тИЦ
  • (int) sqi_1 - минимальное знаение ИКС
  • (int) sqi_2 - максимальное значение ИКС
  • (int) domain_level = 0 - уровень домена:
    • 0 - все уровни
    • 2 - второго уровня
    • 3 - третьего уровня
  • (array) domain_zones - массив с ID доменных зон
  • (array) categories_v2 - массив с ID категорий
  • (array) regions - массив с ID регионов
  • (array) yaca_categories - массив с ID категорий YACA
  • (array) whitelists - массив с ID списков избранного
  • (int) flag_blocked_in_yandex = null - наличие в Yandex:
    • 0 - есть (по умолчанию)
    • 1 - нет
    • 2 - не важно
  • (int) flag_blocked_in_google = null - наличие в Google:
    • 0 - есть
    • 1 - нет
    • 2 - не важно (по умолчанию)
  • (int) in_yaca = null - сайты из YACA:
    • 0 - только не в YACA
    • 1 - только в YACA
  • (int) in_dmoz = null - сайты из DMOZ:
    • 0 - только не в DMOZ
    • 1 - только в DMOZ
  • (int) days_old_whois - количество дней, которые прошли с момента регистрации сайта
  • (int) date_added - количество дней, которые прошли с момента регистрации сайта в системе
  • (int) nogood = null - область поиска:
    • 0 - все сайты
    • 1 - основная база
    • 2 - сайты сомнительного содержания
  • (boolean) double - отображать площадки с размещенными ссылками
  • (boolean) no_double_in_project - не отображать сайты, уже купленные в рамках других URL текущего проекта
  • (boolean) no_double_in_system - не отображать сайты, уже купленные в рамках других URL других проектов
  • (boolean) no_double_in_folder - не отображать сайты, уже купленные в рамках других URL текущего раздела
  • (float) price_from - минимальная цена страницы
  • (float) price_2 - максимальная цена страницы
  • (int) pr_from - минимальное значение PR
  • (int) pr_2 - максимальное значение PR
  • (int) site_pr_1 - минимальное значение PR главной
  • (int) site_pr_2 - максимальное значение PR главной
  • (int) tr_1 - минимальное значение SapeRank
  • (int) tr_2 - максимальное значение SapeRank
  • (int) mj_cf_1 - минимальное значение Majestic Citation Flow
  • (int) mj_cf_2 - максимальное значение Majestic Citation Flow
  • (int) mj_tf_1 - минимальное значение Majestic Trust Flow
  • (int) mj_tf_2 - максимальное значение Majestic Trust Flow
  • (int) moz_domain_authority_1 - минимальное значение MOZ Domain Authority
  • (int) moz_domain_authority_2 - максимальное значение MOZ Domain Authority
  • (int) page_mozrank_1 - минимальное значение MOZ Page Rank
  • (int) page_mozrank_2 - максимальное значение MOZ Page Rank
  • (int) page_authority_1 - минимальное значение MOZ Page Authority
  • (int) page_authority_2 - максимальное значение MOZ Page Authority
  • (int) level_from - минимальный уровень вложенности страницы
  • (int) level_2 - максимальный уровень вложенности страницы
  • (int) ext_links - максимальное число внешних ссылок
  • (int) ext_links_forecast - прогнозируемое число внешних ссылок
  • (array) page_languages - массив идентификаторов языков страниц сайта (sape.get_languages — список допустимых значений)
  • (array) site_languages - массив идентификаторов преобладающих языков сайта (sape.get_languages — список допустимых значений)
  • (string) words - ключевые слова
  • (int) words_type = null - где искать ключевые слова:
    • 0 - в тексте страниц (по-умолчанию)
    • 1 - в title страниц
  • (int) links_display_mode = null - форма вывода ссылок, если не передан, то не важно:
    • 0 - стандартный
    • 1 - блочный
    • 2 - стандартный + блочный
  • (int) schemas_access = null - схемы сайта, если не передан, то не важно:
    • 1 - только http
    • 2 - только https
    • 3 - http и https
  • (float) int_rank_1 - минимальное значение Sape IntRank
  • (float) int_rank_2 - максимальное значение Sape IntRank
  • (boolean) only_open_url - только сайты с открытыми УРЛами
  • (string) pages_per_site = null - флаг "all" доступен если поиск осуществляется по конкретному сайту (т.е. задан один site_id):
    • preferred - только оптимальные (по умолчанию)
    • one - одна
    • all - все страницы
  • (int) order = null - сортировка:
    • 1 - ID сайта ↓
    • 11 - ID сайта ↑
    • 2 - Домен ↓
    • 12 - Домен ↑
    • 3 - ТиЦ ↓
    • 13 - ТиЦ ↑
    • 4 - Категория ↓
    • 14 - Категория ↑
    • 5 - ID страницы ↓
    • 15 - ID страницы ↑
    • 6 - PR ↓
    • 16 - PR ↑
    • 7 - УВ ↓
    • 17 - УВ ↑
    • 8 - ВС ↓
    • 18 - ВС ↑
    • 9 - Цена ↓
    • 19 - Цена ↑
    • 102 - IntRank ↓
    • 1002 - IntRank ↑
    • 103 - PageMozRank ↓
    • 1003 - PageMozRank ↑
    • 104 - PageAuthority ↓
    • 1004 - PageAuthority ↑
  • (boolean) show_title - Показывать тайтлы для страницы
pn int Нет 0 номер страницы (для пагинации)
ps int Нет 100 кол-во сообщений на странице
Тип Описание
array Результат поиска:
  • (int) id - ID сайта
  • (string) url - УРЛ сайта
  • (boolean) in_dmoz - есть ли в DMOZ
  • (boolean) in_yaca - есть ли в YACA
  • (int) category_id_v2 - ID категории
  • (string) region_id - ID регионов
  • (string) yaca_category_ids - ID категорий YACA
  • (int) cy - тИЦ
  • (int) sqi - ИКС
  • (int) domain_level - уровень домана
  • (int) pr - PR
  • (int) mj_cf - Majestic Citation Flow
  • (int) mj_tf - Majestic Trust Flow
  • (int) flag_blocked_in_yandex - наличие в Яндекс
  • (int) flag_blocked_in_google - наличие в Google
  • (int) nof_pages - количество страниц
  • (int) nof_pages_in_yandex - количество страниц в индексе Яндекс
  • (int) nof_pages_in_google - количество страниц в индексе Google
  • (int) schemas_access - схемы сайта
  • (int) lang_id - язык страницы
  • (int) moz_domain_authority - MOZ Domain Authority
  • (array) pages = null - страницы сайта:
    • (int) id - ID страницы
    • (string) uri - URI
    • (int) pr - PR
    • (int) tr - уровень вложенности
    • (string) * title - заголовок страницы
    • (int) level - уровень домана
    • (int) ext_links - количество внешних ссылок
    • (float) price - цена
    • (int) free_places - количество свободных мест
    • (int) lang_id - язык страницы
    • (float) int_rank - Sape IntRank
    • (int) page_authority - MOZ Page Authority
    • (int) page_mozrank - MOZ Page Rank
(array) sape.search_pages( (int) urlId, (array) filter[, (int) pn[, (int) ps = 100]] )
Оптимизатор
Поиск площадок

Поиск страниц для УРЛа urlId по параметрам.

Имя Тип Обязательно По умолчанию Описание
urlId int Да - ID УРЛа
filter array Да - фильтр:
  • (string) site_id - ID сайта, можно через запятую
  • (string) page_id - ID страницы, можно через запятую
  • (int) cy_from - минимальное знаение тИЦ
  • (int) cy_2 - максимальное значение тИЦ
  • (int) sqi_1 - минимальное знаение ИКС
  • (int) sqi_2 - максимальное значение ИКС
  • (int) domain_level = 0 - уровень домена:
    • 0 - все уровни
    • 2 - второго уровня
    • 3 - третьего уровня
  • (array) domain_zones - массив с ID доменных зон
  • (array) categories_v2 - массив с ID категорий
  • (array) regions - массив с ID регионов
  • (array) yaca_categories - массив с ID категорий YACA
  • (array) whitelists - массив с ID списков избранного
  • (int) flag_blocked_in_yandex = null - наличие в Yandex:
    • 0 - есть (по умолчанию)
    • 1 - нет
    • 2 - не важно
  • (int) flag_blocked_in_google = null - наличие в Google:
    • 0 - есть
    • 1 - нет
    • 2 - не важно (по умолчанию)
  • (int) in_yaca = null - сайты из YACA:
    • 0 - только не в YACA
    • 1 - только в YACA
  • (int) in_dmoz = null - сайты из DMOZ:
    • 0 - только не в DMOZ
    • 1 - только в DMOZ
  • (int) days_old_whois - количество дней, которые прошли с момента регистрации сайта
  • (int) date_added - количество дней, которые прошли с момента регистрации сайта в системе
  • (int) nogood = null - область поиска:
    • 0 - все сайты
    • 1 - основная база
    • 2 - сайты сомнительного содержания
  • (boolean) double - отображать площадки с размещенными ссылками
  • (boolean) no_double_in_project - не отображать сайты, уже купленные в рамках других URL текущего проекта
  • (boolean) no_double_in_system - не отображать сайты, уже купленные в рамках других URL других проектов
  • (boolean) no_double_in_folder - не отображать сайты, уже купленные в рамках других URL текущего раздела
  • (float) price_from - минимальная цена страницы
  • (float) price_2 - максимальная цена страницы
  • (int) pr_from - минимальное значение PR
  • (int) pr_2 - максимальное значение PR
  • (int) site_pr_1 - минимальное значение PR главной
  • (int) site_pr_2 - максимальное значение PR главной
  • (int) tr_1 - минимальное значение SapeRank
  • (int) tr_2 - максимальное значение SapeRank
  • (int) mj_cf_1 - минимальное значение Majestic Citation Flow
  • (int) mj_cf_2 - максимальное значение Majestic Citation Flow
  • (int) mj_tf_1 - минимальное значение Majestic Trust Flow
  • (int) mj_tf_2 - максимальное значение Majestic Trust Flow
  • (int) moz_domain_authority_1 - минимальное значение MOZ Domain Authority
  • (int) moz_domain_authority_2 - максимальное значение MOZ Domain Authority
  • (int) page_mozrank_1 - минимальное значение MOZ Page Rank
  • (int) page_mozrank_2 - максимальное значение MOZ Page Rank
  • (int) page_authority_1 - минимальное значение MOZ Page Authority
  • (int) page_authority_2 - максимальное значение MOZ Page Authority
  • (int) level_from - минимальный уровень вложенности страницы
  • (int) level_2 - максимальный уровень вложенности страницы
  • (int) ext_links - максимальное число внешних ссылок
  • (int) ext_links_forecast - прогнозируемое число внешних ссылок
  • (array) page_languages - массив идентификаторов языков страниц сайта (sape.get_languages — список допустимых значений)
  • (array) site_languages - массив идентификаторов преобладающих языков сайта (sape.get_languages — список допустимых значений)
  • (string) words - ключевые слова
  • (int) words_type = null - где искать ключевые слова:
    • 0 - в тексте страниц (по-умолчанию)
    • 1 - в title страниц
  • (int) links_display_mode = null - форма вывода ссылок, если не передан, то не важно:
    • 0 - стандартный
    • 1 - блочный
    • 2 - стандартный + блочный
  • (int) schemas_access = null - схемы сайта, если не передан, то не важно:
    • 1 - только http
    • 2 - только https
    • 3 - http и https
  • (float) int_rank_1 - минимальное значение Sape IntRank
  • (float) int_rank_2 - максимальное значение Sape IntRank
  • (boolean) only_open_url - только сайты с открытыми УРЛами
  • (string) pages_per_site = null - флаг "all" доступен если поиск осуществляется по конкретному сайту (т.е. задан один site_id):
    • preferred - только оптимальные (по умолчанию)
    • one - одна
    • all - все страницы
  • (int) order = null - сортировка:
    • 1 - ID сайта ↓
    • 11 - ID сайта ↑
    • 2 - Домен ↓
    • 12 - Домен ↑
    • 3 - ТиЦ ↓
    • 13 - ТиЦ ↑
    • 4 - Категория ↓
    • 14 - Категория ↑
    • 5 - ID страницы ↓
    • 15 - ID страницы ↑
    • 6 - PR ↓
    • 16 - PR ↑
    • 7 - УВ ↓
    • 17 - УВ ↑
    • 8 - ВС ↓
    • 18 - ВС ↑
    • 9 - Цена ↓
    • 19 - Цена ↑
    • 102 - IntRank ↓
    • 1002 - IntRank ↑
    • 103 - PageMozRank ↓
    • 1003 - PageMozRank ↑
    • 104 - PageAuthority ↓
    • 1004 - PageAuthority ↑
  • (boolean) show_title - Показывать тайтлы для страницы
pn int Нет 0 номер страницы (для пагинации).
ps int Нет 100 кол-во результатов на странице.
Тип Описание
array Результат поиска:
  • (int) id - ID страницы
  • (string) uri - URI
  • (int) pr - PR
  • (int) tr - SapeRank
  • (string) * title - заголовок страницы
  • (int) level - уровень вложенности
  • (float) price - цена
  • (int) ext_links - количество внешних ссылок
  • (int) free_places - количество свободных мест
  • (int) lang_id - язык страницы
  • (float) int_rank - Sape IntRank
  • (int) site_id - ID сайта
  • (string) url - УРЛ сайта
  • (boolean) in_dmoz - есть ли в DMOZ
  • (boolean) in_yaca - есть ли в YACA
  • (int) category_id_v2 - ID категории
  • (string) yaca_category_ids - ID категорий YACA
  • (int) cy - тИЦ
  • (int) sqi - ИКС
  • (int) mj_cf - Majestic Citation Flow
  • (int) mj_tf - Majestic Trust Flow
  • (int) flag_blocked_in_yandex - наличие в Яндекс
  • (int) flag_blocked_in_google - наличие в Google
  • (int) nof_pages_in_yandex - количество страниц в индексе Яндекс
  • (int) nof_pages_in_google - количество страниц в индексе Google
  • (int) schemas_access - схемы сайта
  • (int) page_authority - MOZ Page Authority
  • (int) page_mozrank - MOZ Page Rank
(string) sape.placement_create( (int) pageId, (int) urlId, (int|string) anchor[, (array) hash = array()] )
Оптимизатор
Ссылки

Размещение новой ссылки.

Имя Тип Обязательно По умолчанию Описание
pageId int Да - ID страницы
urlId int Да - ID УРЛа
anchor int|string Да - если anchor число, то выбирается текст из БД текстов по ID; если anchor = 0, то берётся следующий неиспользованный текст
hash array Нет array() Содержит следующие значения:
  • (int) force_seo_wait - установка статуса если это возможно:
    • 1 - ожидает подтверждения оптимизатора
    • 2 - размещено
  • (float) max_price - максимальная цена за ссылку, если цена ссылки, больше максимальной, то не будем покупать
Тип Описание
string ID ссылки
(array) sape.placements_create( [(array) placements = array()] )
Оптимизатор
Ссылки

Размещение списка новых ссылок.

Имя Тип Обязательно По умолчанию Описание
placements array Нет array() Список, каждый элемент которого содержит:
  • (int) page_id - ID страницы
  • (int) url_id - ID УРЛа
  • (string) anchor - если anchor число, то выбирается текст из БД текстов по ID; если anchor = 0, то берётся следующий неиспользованный текст
  • (array) params = array() Содержит следующие значения:
    • (int) force_seo_wait - установка статуса если это возможно:
      • 1 - ожидает подтверждения оптимизатора
      • 2 - размещено
    • (float) max_price - максимальная цена за ссылку, если цена ссылки, больше максимальной, то не будем покупать
Тип Описание
array в случае успеха возвращается массив с ID ссылок или описаниями ошибок
(string) sape.get_placement_status( (int) placementId[, (boolean) checkSleepBalance = false] )
Оптимизатор
Вебмастер
Ссылки

Получение текущего статуса ссылки по ID.

Имя Тип Обязательно По умолчанию Описание
placementId int Да - ID ссылки
checkSleepBalance boolean Нет false флаг указывающий на то, что нужно проверить на биллинговый слип
Тип Описание
string статус ссылки или если указан флаг checkSleepBalance, то будет возвращён массив со следующими полями:
  • (string) status
  • (boolean) is_sleep_balance
(array) sape.get_placements_new_prices( [(int) projectId[, (int) filterDays
Код
Сообщение
Описание
100
SAPE.RU: Not enough params :o(
Не достаточно параметров
101
SAPE.RU: Internal error :o(
Внутренняя ошибка
102
SAPE.RU: Bad or unknown ID :o(
Неверный ID
110
SAPE.RU: User registration failed :o(
Пользователь не зарегистрирован
111
SAPE.RU: Bad login :o(
Неверный логин или пароль
112
SAPE.RU: Login already in use :o(
Данный логин уже есть в системе
113
SAPE.RU: Email already in use :o(
Данный e-mail уже есть в системе
114
SAPE.RU: Password too short :o(
Пароль слишком короткий
115
SAPE.RU: Bad email :o(
Невалидный e-mail
116
SAPE.RU: Bad username :o(
Некорректное имя пользователя
117
SAPE.RU: Bad refid :o(
Неверный ID реферала
118
SAPE.RU: Bad user id :o(
Неверный ID пользователя
119
SAPE.RU: User not auth :o(
Пользователь не авторизован
120
SAPE.RU: Bad external system ID :o(
Неправильный ID внешней системы
121
SAPE.RU: Method is restricted for current user :o(
Метод не разрешается вызывать для этого пользователя
122
SAPE.RU: User does not exist :o(
Пользователь не существует
123
SAPE.RU: User does not have a phone :o(
У пользователя нету телефона
140
SAPE.RU: Billing in progress :o(
Идёт биллинг
141
SAPE.RU: Afterbilling aggregations building in progress :o(
Идёт послебиллинговое построение аггрегаций
150
SAPE.RU: Bad subscribe type :o(
Неверный тип подписки
151
SAPE.RU: Bad template id :o(
Неверный id шаблона
210
SAPE.RU: Anchor add failed :o(
Анкор не добавлен
211
SAPE.RU: Anchor delete failed :o(
Анкор не удален
310
SAPE.RU: Project create failed :o(
Проект не создан
311
SAPE.RU: Project bad name :o(
Некорректное название прокта
320
SAPE.RU: URL Add failed :o(
URL не добавлен
321
SAPE.RU: URL is banned :o(
URL забанен
322
SAPE.RU: Bad URL length :o(
Неверная длина URLа
323
SAPE.RU: URL is malformed :o(
Неправильно сформированный URL
324
SAPE.RU: Bad URL domain :o(
Неверный домен URLа
325
SAPE.RU: Url contains quote :o(
URL содержит кавычки
330
SAPE.RU: Site add failed :o(
Сайт не добавлен
331
SAPE.RU: Bad url :o(
Неверный URL
332
SAPE.RU: Site already exists :o(
Сайт уже есть в системе
333
SAPE.RU: No code on front page :o(
Отсутствует код системы на главной странице
334
SAPE.RU: No code on page :o(
Отсутствует код системы на странице
335
SAPE.RU: No connection to site :o(
Ошибка связи с сервером
336
SAPE.RU: Site cannot be reindexed now :o(
В данный момент переиндексация сайта запрещена
337
SAPE.RU: Site is already bought out :o(
Сайт уже выкуплен
338
SAPE.RU: Site reindex is already started :o(
Ошибка, задание в очереди или уже выполняется.
410
SAPE.RU: Placement create failed :o(
Ссылка не создана
420
SAPE.RU: Placement delete failed :o(
Ссылка не удалена
430
SAPE.RU: Placement update text failed :o(
Текст ссылки не изменен
432
SAPE.RU: Placement update price failed :o(
Цена ссылки не изменена
435
SAPE.RU: Placement update url failed :o(
URL ссылки не изменен
440
SAPE.RU: Placement accept SEO failed :o(
Ссылка не подтверждена оптимизатором
450
SAPE.RU: Placement unsleep failed :o(
Ссылка не восстановлена
460
SAPE.RU: Placement accept WM failed :o(
Ссылка не подтверждена вебмастером
465
SAPE.RU: Placement new price accept failed :o(
Ошибка подтверждения новых цен
466
SAPE.RU: Placement new price reject failed :o(
Ошибка отклонения новых цен
470
SAPE.RU: Autofilter create failed, no texts on url
Автофильтр не создан, для URLа не создано ни одного текста
471
SAPE.RU: Autofilter create failed, already exist
Автофильтр не создан, уже существует
500
SAPE.RU: Bad Project ID
Неверный ID проекта
501
SAPE.RU: Bad Site ID
Неверный ID сайта
502
SAPE.RU: Bad URL ID
Неверный ID URLа
503
SAPE.RU: Bad Placement ID
Неверный ID ссылки
504
SAPE.RU: Bad Placement Text
Неверный текст ссылки
505
SAPE.RU: Bad date in params
Неверный формат даты в параметрах
506
SAPE.RU: Bad Page ID
Неверный ID страницы
507
SAPE.RU: Bad Project ID - No URLs
Неверный ID проекта - отсутствуют URLы
508
SAPE.RU: Bad category id
Неверный ID категории
509
SAPE.RU: Bad filter id
Неверный ID фильтра
510
SAPE.RU: Bad whitelist id
Неверный ID раздела в избранном
511
SAPE.RU: Bad keyword
Неверное ключевое слово
512
SAPE.RU: Bad stop-words list ID
Неверное ID списка стоп-слов
513
SAPE.RU: Bad Project blacklist ID
Не задан black-лист проекта
514
SAPE.RU: Bad date interval
Неверный интервал дат
515
SAPE.RU: Bad domain id
Неверный ID домена
521
SAPE.RU: Bad placement anchor ID
Неверный ID анкора
522
SAPE.RU: Empty placement anchor
Пустой анкор
523
SAPE.RU: Malformed placement anchor
Некорректный анкор
524
SAPE.RU: Spammed placement anchor
Заспамленный анкор
525
SAPE.RU: Anchor too long
Анкор слишком длинный
526
SAPE.RU: Anchor exist
Анкор существует
650
SAPE.RU: Empty login :o(
Пустой логин
651
SAPE.RU: User is not activated :o(
Пользователь не активирован
652
SAPE.RU: Quantity of attempts of authentication for current IP is exceeded :o(
Количество попыток авторизации для текущего IP исчерпано
653
SAPE.RU: Login does not exist :o(
Пользователь не существует
654
SAPE.RU: Invalid authorization cookie :o(
Неверная авторизационная cookie
655
SAPE.RU: User is banned :o(
Пользователь забанен
656
SAPE.RU: User is blocked - need to change password :o(
Пользователь заблокирован - должен сменить пароль
657
SAPE.RU: Invalid authorization ticket :o(
Неверный авторизационный тикет
660
SAPE.RU: Access restricted for current IP :o(
Доступ с текущего IP запрещен
661
SAPE.RU: No partner contract :o(
Нет договора партнерской программы
662
SAPE.RU: No WM contract :o(
Нет договора вебмастера
663
SAPE.RU: No SEO contract :o(
Нет договора оптимизатора
664
SAPE.RU: Extended mode denied :o(
Доступ к дополнительным функциям закрыт
665
SAPE.RU: Not wizard account
Это не визард аккаунт
666
SAPE.RU: Invalid login or password :o(
Неверный логин или пароль
667
SAPE.RU: Please, login
Пожалуйста авторизуйтесь в системе
668
SAPE.RU: Quantity of attempts of authentication is exceeded
Количество попыток авторизации исчерпано
669
SAPE.RU: TEMPORARY UNAVAILABLE
Временно не доступно
670
SAPE.RU: Empty array!
Пустой массив
671
SAPE.RU: Input array empty!
Входной массив данных пустой
672
SAPE.RU: Return array empty!
Выходной массив данных пустой
673
SAPE.RU: Search result empty!
Поиск вернул пустой результат
680
SAPE.RU: Request processing error!
Ошибка во время обработки запроса)
681
SAPE.RU: Request already exist!
Запрос уже существует
711
SAPE.RU: Bill amount too small :o(
Сумма счета слишком мала
800
SAPE.RU: Bad handle :o(
Неверный указатель
801
SAPE.RU: Get task status failed :o(
Ошибка получения статуса по переданному указателю
802
SAPE.RU: Cannot get factor status :o(
Невозможно получить статус фактора
900
SAPE.RU: OAuth error :o(
Ошибка OAuth
1000
SAPE.RU: Elama error :o(
Ошибка Elama
1100
SAPE.RU: RT error :o(
Ошибка RT
1200
SAPE.RU: RTB error :o(
Ошибка RTB
1400
SAPE.RU: Wizard error :o(
Ошибка Wizard
1500
SAPE.RU: Archiving in PR failed :o(
Архивирвоание проекта в PR закончилось неудачей
2101
SAPE.RU: Anchor add_failed, bad name :o(
Анкор не добавлен, некорректное название
2201
SAPE.RU: Teaser upload failed, maximum allowed size for file 1.95MB :o(
Файл с картинкой должен быть меньше 1.95MB
2202
SAPE.RU: Teaser upload failed, file must be jpg, gif or png :o(
Файл с картинкой должен быть в формате jpg, gif или png
2203
SAPE.RU: Teaser upload failed, file broken:o(
Файл с картинкой не читается
4101
SAPE.RU: Placement create failed, undefined page
Ссылка не создана, страница не определена
4102
SAPE.RU: Placement create failed, big price
Ссылка не создана, слишком высокая цена
4103
SAPE.RU: Placement create failed, undefined site
Ссылка не создана, сайт не определен
4104
SAPE.RU: Placement create failed, links limit reached
Ссылка не создана, достигнут предел размещенией
4105
SAPE.RU: Placement create failed, page is not active
Ссылка не создана, страница не активирована
4106
SAPE.RU: Placement create failed, site is not active
Ссылка не создана, сайт не активирован
4107
SAPE.RU: Placement create failed, self link (anchor_url==site_url)
Ссылка не создана, является внутренней
4108
SAPE.RU: Placement create failed, link already exists
Ссылка не создана, данная ссылка уже существует
4109
SAPE.RU: Placement create failed, IN WM BL
Ссылка не создана, URL в блэклисте вебмастера
4110
SAPE.RU: Placement create failed, IN SEO BL
Ссылка не создана, сайт в блэклисте оптимизатора
4111
SAPE.RU: Placement create failed, text error
Ссылка не создана, ошибка текста
4112
SAPE.RU: Placement create failed, not enough money for 2 days
Ссылка не создана, не достаточно средств на 2 дня размещения
4113
SAPE.RU: Placement context create failed, anchor text error
Контекстная ссылка не создана, ошибка в тексте анкора
4114
SAPE.RU: Placement context create failed, sql error
Контекстная ссылка не создана, SQL-ошибка
4116
SAPE.RU: Placement context create failed, no snippet
Контекстная ссылка не создана, отсутствует сниппет
4117
SAPE.RU: Placement get good text failed, there are stop words
Текст не подобран, присутствуют стоп-слова
4118
SAPE.RU: Placement get good text failed, there are russian chars
Текст не подобран, присутствуют русские буквы
4119
SAPE.RU: Placement get good text failed
Текст не подобран
4120
SAPE.RU: Placement get good text failed, no active anchor texts
Текст не подобран, нет активных текстов
4510
SAPE.RU: URL unsleep failed :o(
URL не восстановлен
4511
SAPE.RU: URL unsleep failed, no money :o(
URL не восстановлен, не хватает денег
4512
SAPE.RU: URL unsleep failed, no links to unsleep :o(
URL не восстановлен, нет ссылок для восстановления
6651
SAPE.RU: Not wizard user account
Этот аккаунт не пользуется визардом
6661
SAPE.RU: Authorization by password or md5 is prohibited. Please use token instead (Details: https://help.sape.ru/sape/faq/1685). To generate token visit https://passport.sape.ru/security/token/.
Авторизация по паролю или md5 запрещена. Пожалуйста, используйте токен (Подробнее: https://help.sape.ru/sape/faq/1685). Сгенерировать токен можно в вашем аккаунте: https://passport.sape.ru/security/token/
7000
SAPE.RU: Too deep :o(
Уточните условия поиска
7001
SAPE.RU: Too short word :o(
Слишком короткое слово
7002
SAPE.RU: Quantity of calls to a method is exceeded
Количество обращений к методу исчерпано
7003
SAPE.RU: Search result is too big :o(
Слишком много данных в результате поиска, уточните условия
41021
SAPE.RU: Placement create failed, zero price
Ссылка не создана, цена нулевая
41031
SAPE.RU: Placement create failed, site is not saling
Ссылка не создана, на сайте отключена продажа ссылок
41181
SAPE.RU: Placement get good text failed, there are not russian chars
Текст не подобран, отсутствуют русские буквы
41301
SAPE.RU: Placement create failed, undefined teaser page
Ссылка не создана, тизерная страница не определена
41302
SAPE.RU: Placement create failed, not enough traffic
Ссылка не создана, недостаточно трафика на странице
41304
SAPE.RU: Placement create failed, not enough traffic on site
Ссылка не создана, недостаточно трафика на сайте
41305
SAPE.RU: Placement create failed, teaser blocks limit reached
Ссылка не создана, превышен лимит тизерных блоков