Sape.ru Xml-Rpc

Our xml-rpc interface is available at http://api.sape.ru/xmlrpc/. Request should be made using port 80, the body of xml-response should be put to POST_DATA. All communication is in UTF-8. Also you can work at https https://api.sape.ru/xmlrpc/.

If you know nothing about XML-RPC we recommend you read about it at www.xmlrpc.com:

  1. The protocol implementation for your favorite programming language.
  2. For those who use PHP we recommend Zend Framework

Display categories Hide categories
Select the role:
Select a category
(int) sape.login( (string) login, (string) token )
Advertiser
Publisher
Authorization and account settings

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

Name Type Obligatorily По умолчанию Description
login string Yes - логин
token string Yes - токен
Type Description
int User's ID
(array) sape.get_user()
Advertiser
Publisher
Authorization and account settings

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

Type Description
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()
Advertiser
Publisher
Balance

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

Type Description
float баланс пользователя
(float) sape.get_balance_real()
Advertiser
Publisher
Balance

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

Type Description
float баланс пользователя
(array) sape.get_balance_locks()
Advertiser
Publisher
Balance

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

Type Description
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]]] )
Advertiser
Publisher
Input / output of funds

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

Name Type Obligatorily По умолчанию Description
dateYear int Yes - Year of sample
dateMonth int No null Month of sample
dateDay int No null Day of sample
userId int No null User's ID
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - ID счета
  • (int) doc_num - номер документа
  • (date) ctime - дата создания
  • (float) amount - сумма
  • (date) date_payed - дата поступления
  • (date) date_update - transfer date
(array) sape.get_bills_unpayed()
Advertiser
Publisher
Input / output of funds

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

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

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

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

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

Type Description
array список ID доменов
(boolean) sape.domain_get_status( (string) domain )
Publisher
Links

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

Name Type Obligatorily По умолчанию Description
domain string Yes - домен
Type Description
boolean Возможные значения:
  • true - есть активные ссылки
  • false - нет активных ссылок
(array) sape.get_project( (int) projectId )
Advertiser
Projects

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

Name Type Obligatorily По умолчанию Description
projectId int Yes - Project ID
Type Description
array Содержит следующие значения:
  • (int) id - Project 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]]] )
Advertiser
Projects

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

Name Type Obligatorily По умолчанию Description
options array No null Содержит следующие значения:
  • (boolean) show_deleted = false - показывать удаленные
  • (boolean) show_count = false - показывать количество урлов и ссылок в статусе ОК
pn int No 0 The page number (for pagination).
ps int No 10000 The number of elements to display on the page (for pagination).
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - Project 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()] )
Advertiser
Projects

New project's creation.

Name Type Obligatorily По умолчанию Description
name string Yes - имя проекта
options array No 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 стратегии подбора ссылок
Type Description
int ID созданного проекта
(boolean) sape.project_update( (int) projectId, (array) options )
Advertiser
Projects

Change of the site's settings in accordance with the passed parameters.

Name Type Obligatorily По умолчанию Description
projectId int Yes - Project ID
options array Yes - Содержит следующие значения:
  • (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 стратегии подбора ссылок
Type Description
boolean результат операции
(array) sape.get_project_sites( (int) projectId )
Advertiser
Projects

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

Name Type Obligatorily По умолчанию Description
projectId int Yes - Project ID
Type Description
array cписок ID площадок
(array) sape.get_project_info( (int|array) projectIds )
Advertiser
Projects

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

Name Type Obligatorily По умолчанию Description
projectIds int|array Yes - ID проектов
Type Description
array Список, каждый элемент которого содержит:
  • (int) project_id - Project 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()
Advertiser
Projects

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

Type Description
array Список, каждый элемент которого содержит:
  • (int) project_id - Project ID
  • (int) folder_id - Section ID
  • (string) folder_name - section title
(boolean) sape.project_move_to_folder( (int) projectId, (int) folderId )
Advertiser
Projects

The transfer of a project to another section.

Name Type Obligatorily По умолчанию Description
projectId int Yes - Project ID
folderId int Yes - Directory ID
Type Description
boolean результат операции
(boolean) sape.project_delete( (int) projectId )
Advertiser
Projects

Project's removal.

Name Type Obligatorily По умолчанию Description
projectId int Yes - Project ID
Type Description
boolean результат операции
(array) sape.get_url( (int) urlId[, (boolean) showDeleted = false] )
Advertiser
URLs

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

Name Type Obligatorily По умолчанию Description
urlId int Yes - ID урла
showDeleted boolean No false показываеть удаленные
Type Description
array Содержит следующие значения:
  • (int) id - URL ID,
  • (int) project_id - Project 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) position_mail - позиция в mail
  • (int) position_mail_diff - изменение позиции в mail
  • (date) position_mail_date_log - дата изменения позиции в mail
(array) sape.get_urls( (int) projectId[, (boolean) showDeleted = false[, (array) options = array()]] )
Advertiser
URLs

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

Name Type Obligatorily По умолчанию Description
projectId int Yes - Project ID
showDeleted boolean No false показываеть удаленные
options array No array() Содержит следующие значения:
  • (boolean) tiny = false - выводить краткую информацю
  • (int) pn = 0 - номер страницы (для пагинации)
  • (int) ps = 0 - the number of elements to display on the page (for pagination)
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - URL ID,
  • (int) * project_id - Project 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) * position_mail - позиция в mail
  • (int) * position_mail_diff - изменение позиции в mail
  • (date) * position_mail_date_log - дата изменения позиции в mail
(int) sape.url_add( (int) projectId, (string) url[, (string) name[, (int|string) keyword]] )
Advertiser
URLs

Adding a new URL to the project.

Name Type Obligatorily По умолчанию Description
projectId int Yes - Project ID
url string Yes - УРЛ
name string No - URL's title
keyword int|string No - Keyword
Type Description
int ID созданного УРЛа
(boolean) sape.url_update( (int) urlId, (array) params )
Advertiser
URLs

Change of the URL's settings in accordance with the passed parameters.

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
params array Yes - Содержит следующие значения:
  • (int) project_id - Project 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"
Type Description
boolean результат операции
(array) sape.get_url_anchors( (int) urlId )
Advertiser
URLs

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

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
Type Description
array Список, каждый элемент которого содержит:
  • (string) id - ID анкора
  • (string) anchor - анкор
  • (int) nof - количество использованных раз
  • (int) limit - максимальное использование
  • (int) * folder_id - ID папки
(int) sape.get_url_anchors_count( (int) urlId )
Advertiser
URLs

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

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
Type Description
int количества анкоров УРЛа
(array) sape.get_urls_anchors_count( [(array) params = null] )
Advertiser
URLs

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

Name Type Obligatorily По умолчанию Description
params array No null Содержит следующие значения:
  • (int|array) project_id - Project ID / projects ID,
  • (int|array) url_id - ID урла/урлов
Type Description
array Список, каждый элемент которого содержит:
  • (int) url_id - URL ID,
  • (int) nof - количество анкоров
(array) sape.get_anchors_usage_sitewide( (int) urlId )
Advertiser
Links
Anchors

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

Name Type Obligatorily По умолчанию Description
urlId int Yes - Идентификатор УРЛа
Type Description
array Список, каждый элемент которого содержит:
  • (string) id - Идентификатор анкора
  • (date) date_created - Дата создания
  • (string) txt - Anchor
  • (int) nof - Кол-во использований
  • (int) limit_per_packet - Лимит использований на пакет
  • (int) limit_per_site - Лимит использований на площадку
(boolean) sape.url_set_autoseo( (int) urlId, (boolean) flagAuto, (boolean) flagRequireConfirm )
Advertiser
URLs
Filters and autofilters

The change of the URL's moderation mode.

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
flagAuto boolean Yes - покупать сссылки автоматически
flagRequireConfirm boolean Yes - необходимо подтверждение размещения ссылки
Type Description
boolean результат операции
(boolean) sape.url_delete( (int) urlId )

URL removal.

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
Type Description
boolean результат операции
(array) sape.get_sites( [(array) options = null] )
Publisher
Sites

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

Name Type Obligatorily По умолчанию Description
options array No null Содержит следующие значения:
  • (boolean) show_days_to_recheck = false - показать количество дней до возможности запустить переиндексацию
  • (boolean) show_block_display_params = false - показать параметры блочного отображения ссылок
  • (boolean) show_traf_pages = false - показать количество трафиковых страниц
  • (int) pn = 0
  • (int) ps = 0
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - Site's ID
  • (string) url - УРЛ
  • (int) cy - CY
  • (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 - 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 - number of 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 - автоматически устанавливать новые цены на страницах
  • (float) auto_set_prices_factor - множитель новых цен для страниц (от 0.1 до 3; используется, когда auto_set_prices = 3)
  • (boolean) pr_change_auto_set_prices_link - при изменении PRа страниц автоматически менять цены на текуще ссылки (0 - не менять, 1 - менять)
  • (int) pr_change_auto_set_prices - при изменении PRа страниц автоматически устанавливать новые цены
  • (float) pr_change_prices_factor - множитель новых цен для страниц при изменении PRa(от 0.1 до 3; используется, когда pr_change_auto_set_prices = 3)
  • (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] )
Publisher
Sites

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

Name Type Obligatorily По умолчанию Description
url string Yes - УРЛ
categoryId int Yes - ID категории
urlCode string No null УРЛ страницы, на которой размещен клиентский код
Type Description
int Site's ID
(boolean) sape.site_update( (int) siteId, (array) params )
Publisher
Sites

Changes of the site's settings in accordance with the transferred parameters.

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
params array Yes - Содержит следующие значения:
  • (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 - автоматически устанавливать новые цены
  • (float) auto_set_prices_factor - значение для флага "средние по системе умноженные на"
  • (boolean) pr_change_auto_set_prices_link - при изменении PRа страниц автоматически менять цены на текуще ссылки (0 - не менять, 1 - менять)
  • (int) pr_change_auto_set_prices - автоматически устанавливать новые цены при изменении PR
  • (float) pr_change_prices_factor - значение для флага "средние по системе умноженные на" при изменении PR
  • (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
Type Description
boolean результат операции
(int) sape.get_site_pages_count( (int) siteId[, (string) status = null] )
Publisher
Sites
Pages

The number of pages on a site.

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
status string No null статус страницы:
  • NEW - новая
  • OK - активная
  • DEL - удалена
  • NO_CODE - код не найден
Type Description
int количество страниц по одному сайту
(int) sape.get_site_pages_context_count( (int) siteId[, (string) status = null] )
Publisher
Sites
Pages

The number of contextual pages on a site.

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
status string No null статус страницы:
  • NEW - новая
  • OK - активная
  • DEL - удалена
  • NO_CODE - код не найден
Type Description
int количество контекстных страниц по одному сайту
(array) sape.get_sites_folders()
Publisher
Sites

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

Type Description
array Список, каждый элемент которого содержит:
  • (int) site_id - Site's ID
  • (int) folder_id - Section ID
  • (string) folder_name - section title
(boolean) sape.site_move_to_folder( (int) siteId, (int) folderId )
Publisher
Sites

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

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
folderId int Yes - Directory ID
Type Description
boolean результат операции
(array) sape.get_site_regions( (int) siteId )
Publisher
Sites

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

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
Type Description
array Список регионов сайта
(boolean) sape.site_set_max_per_page( (int) siteId[, (array) params = null] )
Publisher
Sites

Installation of the maximum number of links. You can increase the maximum number of links no more than 1 time in 2 weeks.

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
params array No null Содержит следующие значения:
  • (int) mpp_1 - максимальное количество ссылок для главной
  • (int) mpp_2 - максимальное количество ссылок для страниц второго уровня
  • (int) mpp_3 - максимальное количество ссылок для страниц третьего уровня
Type Description
boolean результат операции
(boolean) sape.site_reindex( (int) siteId )
Publisher
Sites

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

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
Type Description
boolean результат операции
(boolean) sape.site_delete( (int) siteId )
Publisher
Sites

A site's removal from the system.

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
Type Description
boolean результат операции
(array) sape.get_site_page( (int) siteId, (int) pageId )
Publisher
Sites
Pages

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

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
pageId int Yes - Page's ID
Type Description
array Содержит следующие значения:
  • (int) id - Page's ID
  • (string) status - стату
  • (string) status_context - контекстный стату
  • (string) uri - УРЛ страницы
  • (int) pr - PR
  • (int) level - page level
  • (int) ext_links - outbound link number
  • (float) price - 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] )
Publisher
Sites
Pages

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

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
filter array No null Содержит следующие значения:
  • (int) level
  • (int) pr
  • (int) only_ext_links
  • (int) only_indexed_in_yandex
  • (int) pn = 0
  • (int) ps = 0
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - Page's ID
  • (string) status - стату
  • (string) status_context - контекстный стату
  • (string) uri - УРЛ страницы
  • (int) pr - PR
  • (int) level - page level
  • (int) ext_links - outbound link number
  • (float) price - 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]]] )
Publisher
Sites
Pages

Activation of site's pages.

Name Type Obligatorily По умолчанию Description
siteId int No null Site's ID
pageIds int|array No null Pages ID
flagContext boolean No false если указано true, то будет активирована контекстная страница, в противном случае - обычная
Type Description
int количество активированных страниц
(int) sape.site_pages_exclude( [(int) siteId = null[, (int|array) pageIds = null[, (boolean) flagContext = false]]] )
Publisher
Sites
Pages

Exclusion of site's pages.

Name Type Obligatorily По умолчанию Description
siteId int No null Site's ID
pageIds int|array No null Pages ID
flagContext boolean No false если указано true, то будет исключена контекстная страница, в противном случае - обычная
Type Description
int количество исключенных страниц
(int) sape.site_pages_purge( [(int) siteId = null[, (int|array) pageIds = null[, (boolean) flagContext = false]]] )
Publisher
Sites
Pages

Removing the site's pages.

Name Type Obligatorily По умолчанию Description
siteId int No null Site's ID
pageIds int|array No null Pages ID
flagContext boolean No false если указано true, то будет удалена контекстная страница, в противном случае - обычная
Type Description
int количество удаленных страниц
(array) sape.get_sites_pages_count( [(string) status = null] )
Publisher
Sites
Pages

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

Name Type Obligatorily По умолчанию Description
status string No null статус страницы:
  • NEW - новая
  • OK - активная
  • DEL - удалена
  • NO_CODE - код не найден
Type Description
array Список, каждый элемент которого содержит:
  • (int) site_id - Site's ID
  • (int) nof - number of pages
(array) sape.get_sites_pages_context_count( [(string) status = null] )
Publisher
Sites
Pages

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

Name Type Obligatorily По умолчанию Description
status string No null статус страницы:
  • NEW - новая
  • OK - активная
  • DEL - удалена
  • NO_CODE - код не найден
Type Description
array Список, каждый элемент которого содержит:
  • (int) site_id - Site's ID
  • (int) nof - number of pages
(boolean) sape.page_update_price( (int) siteId, (int) pageId, (float) priceNew[, (boolean) changePlaced = false] )
Publisher
Pages

Price changing of the page.

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
pageId int Yes - Page's ID
priceNew float Yes - price
changePlaced boolean No false обновятся цены на проданные ссылки
Type Description
boolean результат операции
(boolean) sape.pages_update_price( (int) siteId, (int) level, (int) pr, (float) priceNew[, (boolean) changePlaced = false] )
Publisher
Pages

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

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
level int Yes - уровень вложенности (от 1 до 3)
pr int Yes - PageRank (от 0 до 9), может принимать значение 'all', если необходимо установить одну цену для определенного уровня вложенности
priceNew float Yes - price
changePlaced boolean No false обновятся цены на проданные ссылки
Type Description
boolean результат операции
(array) sape.get_project_money_stats( (int) projectId[, (int) year = null[, (int) month = null[, (int) day = null]]] )
Advertiser
Projects

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

Name Type Obligatorily По умолчанию Description
projectId int Yes - Project ID
year int No null год выборки
month int No null месяц выборки
day int No null день выборки
Type Description
array Список, каждый элемент которого содержит:
  • (date) date_logged - дата
  • (float) sum - сумма
(array) sape.get_projects_money_stats( [(int) year = null[, (int) month = null[, (int) day = null]]] )
Advertiser
Projects

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

Name Type Obligatorily По умолчанию Description
year int No null год выборки
month int No null месяц выборки
day int No null день выборки
Type Description
array Список, каждый элемент которого содержит:
  • (date) date_logged - дата
  • (int) project_id - Project ID
  • (float) sum - сумма
(array) sape.get_url_money_stats( (int) urlId[, (int) year = null[, (int) month = null[, (int) day = null]]] )
Advertiser
URLs

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

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
year int No null год выборки
month int No null месяц выборки
day int No null день выборки
Type Description
array Список, каждый элемент которого содержит:
  • (date) date_logged - дата
  • (float) sum - сумма
(array) sape.get_urls_money_stats( (array) urlIds, (int) year[, (int) month = null[, (int) day = null]] )

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

Name Type Obligatorily По умолчанию Description
urlIds array Yes - список ID УРЛов
year int Yes - год выборки
month int No null месяц выборки
day int No null день выборки
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - URL ID,
  • (date) date_logged - дата
  • (float) sum - сумма
(array) sape.get_site_money_stats( (int) siteId[, (int) year = null[, (int) month = null[, (int) day = null]]] )
Publisher
Sites

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

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
year int No null год выборки
month int No null месяц выборки
day int No null день выборки
Type Description
array Список, каждый элемент которого содержит:
  • (date) date_logged - дата
  • (float) sum - сумма
(array) sape.get_balance_money_stats( [(int) year = null[, (int) month = null[, (int) day = null]]] )
Advertiser
Publisher
Balance

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

Name Type Obligatorily По умолчанию Description
year int No null Year of sample
month int No null Month of sample
day int No null Day of sample
Type Description
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]]] )
Advertiser
Publisher
Balance

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

Name Type Obligatorily По умолчанию Description
year int No null Year of sample
month int No null Month of sample
day int No null Day of sample
Type Description
array Список, каждый элемент которого содержит:
  • (date) date_logged - дата
  • (int) partner_id - ID партнера
  • (float) sum - сумма
(array) sape.get_filters( [(array) options = null] )
Advertiser
Filters and autofilters

Receipt of filter's list.

Name Type Obligatorily По умолчанию Description
options array No null Содержит следующие значения:
  • (boolean) show_params = false - показать значение фильтров виде хэша
  • (boolean) show_extended = false - показать значение дополнительных параметров фильтра
  • (boolean) show_auto_list = true - показать список автофильтров
  • (array) filter_id - список ID фильтров
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - Filter's ID
  • (string) name - название фильтра
  • (array) * params = null Содержит следующие значения:
    • (int) ext_links - maximum number of outbound links
    • (int) ext_links_forecast - outbound links number forecast
    • (int) cy_from - minimum CY value
    • (int) cy_2 - maximum CY value
    • (int) pr_from - minimal PR value
    • (int) pr_2 - maximum PR value
    • (int) tr_1 - minimal SapeRank value
    • (int) tr_2 - maximum SapeRank value,
    • (float) price_from - minimal page price
    • (float) price_2 - maximum page price
    • (int) level_from - minimal page level
    • (int) level_2 - maximum page level
    • (int) in_yaca = null - сайты из YACA:
      • 0 - только не в YACA
      • 1 - только в YACA
    • (int) in_dmoz = null - сайты из DMOZ:
      • 0 - только не в DMOZ
      • 1 - только в DMOZ
    • (int) domain_level - domain level
    • (int) no_double_in_project - не отображать сайты, уже купленные в рамках других URL текущего проекта
    • (int) flag_blocked_in_yandex = null - наличие в Yandex:
      • 0 - есть (по умолчанию)
      • 1 - нет
      • 2 - не важно
    • (int) flag_blocked_in_google = null - presence in Google:
      • 0 - есть
      • 1 - нет
      • 2 - не важно (по умолчанию)
    • (string) words - keywords
    • (int) words_type = null - где искать ключевые слова:
      • 0 - в тексте страниц (по-умолчанию)
      • 1 - в title страниц
    • (int) links_display_mode = null - форма вывода ссылок, если не передан, то не важно:
      • 0 - стандартный
      • 1 - блочный
      • 2 - стандартный + блочный
    • (int) nogood = null - область поиска:
      • 0 - все сайты
      • 1 - основная база
      • 2 - сайты сомнительного содержания
    • (int) date_added - number of days since the site's registration in the system
    • (string) domain_zones - список ID доменных зон
    • (int) days_old_whois - number of days since the site's registration
    • (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 - minimal Sape IntRank
    • (float) int_rank_2 - maximal Sape IntRank
    • (int) mj_cf_1 - minimal Majestic Citation Flow value
    • (int) mj_cf_2 - maximum Majestic Citation Flow value
    • (int) mj_tf_1 - minimal Majestic Trust Flow value
    • (int) mj_tf_2 - maximum Majestic Trust Flow value
    • (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 )
Advertiser
Filters and autofilters

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

Name Type Obligatorily По умолчанию Description
filterName string Yes - имя фильтра
filter array Yes - Содержит следующие значения:
  • (int) cy_from - minimum CY value
  • (int) cy_2 - maximum CY value
  • (int) domain_level = 0 - domain level:
    • 0 - все уровни
    • 2 - второго уровня
    • 3 - третьего уровня
  • (array) domain_zones - an array with domain zones IDs
  • (array) categories_v2 - an array with categories IDs
  • (array) regions - an array with regions IDs
  • (array) yaca_categories - an array with YACA categories IDs
  • (array) whitelists - an array with whitelists IDs
  • (int) flag_blocked_in_yandex = null - наличие в Yandex:
    • 0 - есть (по умолчанию)
    • 1 - нет
    • 2 - не важно
  • (int) flag_blocked_in_google = null - presence in 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 - number of days since the site's registration
  • (int) date_added - number of days since the site's registration in the system
  • (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 - minimal page price
  • (float) price_2 - maximum page price
  • (int) pr_from - minimal PR value
  • (int) pr_2 - maximum PR value
  • (int) site_pr_1 - minimal value of homepage PR
  • (int) site_pr_2 - maximum value of homepage PR
  • (int) tr_1 - minimal SapeRank value
  • (int) tr_2 - maximum SapeRank value,
  • (int) mj_cf_1 - minimal Majestic Citation Flow value
  • (int) mj_cf_2 - maximum Majestic Citation Flow value
  • (int) mj_tf_1 - minimal Majestic Trust Flow value
  • (int) mj_tf_2 - maximum Majestic Trust Flow value
  • (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 - minimal page level
  • (int) level_2 - maximum page level
  • (int) ext_links - maximum number of outbound links
  • (int) ext_links_forecast - outbound links number forecast
  • (array) page_languages - массив идентификаторов языков страниц сайта (sape.get_languages — список допустимых значений)
  • (array) site_languages - массив идентификаторов преобладающих языков сайта (sape.get_languages — список допустимых значений)
  • (string) words - keywords
  • (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 - minimal Sape IntRank
  • (float) int_rank_2 - maximal Sape IntRank
Type Description
int ID нового фильтра
(boolean) sape.filter_update( (int) filterId, (array) filter )
Advertiser
Filters and autofilters

Change of the filter parameters.

Name Type Obligatorily По умолчанию Description
filterId int Yes - Filter's ID
filter array Yes - Содержит следующие значения:
  • (string) filter_name - название фильтра
  • (int) cy_from - minimum CY value
  • (int) cy_2 - maximum CY value
  • (int) domain_level = 0 - domain level:
    • 0 - все уровни
    • 2 - второго уровня
    • 3 - третьего уровня
  • (array) domain_zones - an array with domain zones IDs
  • (array) categories_v2 - an array with categories IDs
  • (array) regions - an array with regions IDs
  • (array) yaca_categories - an array with YACA categories IDs
  • (array) whitelists - an array with whitelists IDs
  • (int) flag_blocked_in_yandex = null - наличие в Yandex:
    • 0 - есть (по умолчанию)
    • 1 - нет
    • 2 - не важно
  • (int) flag_blocked_in_google = null - presence in 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 - number of days since the site's registration
  • (int) date_added - number of days since the site's registration in the system
  • (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 - minimal page price
  • (float) price_2 - maximum page price
  • (int) pr_from - minimal PR value
  • (int) pr_2 - maximum PR value
  • (int) site_pr_1 - minimal value of homepage PR
  • (int) site_pr_2 - maximum value of homepage PR
  • (int) tr_1 - minimal SapeRank value
  • (int) tr_2 - maximum SapeRank value,
  • (int) mj_cf_1 - minimal Majestic Citation Flow value
  • (int) mj_cf_2 - maximum Majestic Citation Flow value
  • (int) mj_tf_1 - minimal Majestic Trust Flow value
  • (int) mj_tf_2 - maximum Majestic Trust Flow value
  • (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 - minimal page level
  • (int) level_2 - maximum page level
  • (int) ext_links - maximum number of outbound links
  • (int) ext_links_forecast - outbound links number forecast
  • (array) page_languages - массив идентификаторов языков страниц сайта (sape.get_languages — список допустимых значений)
  • (array) site_languages - массив идентификаторов преобладающих языков сайта (sape.get_languages — список допустимых значений)
  • (string) words - keywords
  • (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 - minimal Sape IntRank
  • (float) int_rank_2 - maximal Sape IntRank
Type Description
boolean результат операции
(array) sape.get_filters_auto( (array) urlIds[, (boolean) showParams = false] )
Advertiser
Filters and autofilters

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

Name Type Obligatorily По умолчанию Description
urlIds array Yes - список УРЛов
showParams boolean No false если равно true, то добавляются следующие поля: current_quant, current_price
Type Description
array Список, каждый элемент которого содержит:
  • (int) filter_auto_id - ID автофильтра
  • (int) filter_id - Filter's 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 )
Advertiser
Filters and autofilters

Autofilter creation for URL.

Name Type Obligatorily По умолчанию Description
filterId int Yes - Filter's ID
urlId int Yes - URL ID,
quant int Yes - количество
price float Yes - price
dailyQuota int Yes - дневная квота
Type Description
int Autofilter ID
(boolean) sape.filter_auto_update( (int) filterAutoId, (int) quant, (float) price, (int) dailyQuota )
Advertiser
Filters and autofilters

Autofilter change for URL.

Name Type Obligatorily По умолчанию Description
filterAutoId int Yes - Autofilter ID
quant int Yes - количество
price float Yes - price
dailyQuota int Yes - дневная квота
Type Description
boolean результат операции
(boolean) sape.filter_auto_delete( (int) filterAutoId )
Advertiser
Filters and autofilters

Autofilter removal.

Name Type Obligatorily По умолчанию Description
filterAutoId int Yes - Autofilter ID
Type Description
boolean результат операции
(boolean) sape.filter_delete( (int) filterId[, (boolean) forceDelete = false] )
Advertiser
Filters and autofilters

Filter's removal.

Name Type Obligatorily По умолчанию Description
filterId int Yes - Filter's ID
forceDelete boolean No false если параметр true, то удаляет все автофильтры которые привязаны к фильтру, в противном случае выполняет проверку есть ли автофильтры и если есть, то не будет удалять фильтр
Type Description
boolean результат операции
(array) sape.search( (int) urlId, (array) filter[, (int) pn[, (int) ps = 100]] )
Advertiser
Sites searching

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

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
filter array Yes - фильтр:
  • (string) site_id - site IDs (comma-separated)
  • (string) page_id - ID страницы, можно через запятую
  • (int) cy_from - minimum CY value
  • (int) cy_2 - maximum CY value
  • (int) domain_level = 0 - domain level:
    • 0 - все уровни
    • 2 - второго уровня
    • 3 - третьего уровня
  • (array) domain_zones - an array with domain zones IDs
  • (array) categories_v2 - an array with categories IDs
  • (array) regions - an array with regions IDs
  • (array) yaca_categories - an array with YACA categories IDs
  • (array) whitelists - an array with whitelists IDs
  • (int) flag_blocked_in_yandex = null - наличие в Yandex:
    • 0 - есть (по умолчанию)
    • 1 - нет
    • 2 - не важно
  • (int) flag_blocked_in_google = null - presence in 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 - number of days since the site's registration
  • (int) date_added - number of days since the site's registration in the system
  • (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 - minimal page price
  • (float) price_2 - maximum page price
  • (int) pr_from - minimal PR value
  • (int) pr_2 - maximum PR value
  • (int) site_pr_1 - minimal value of homepage PR
  • (int) site_pr_2 - maximum value of homepage PR
  • (int) tr_1 - minimal SapeRank value
  • (int) tr_2 - maximum SapeRank value,
  • (int) mj_cf_1 - minimal Majestic Citation Flow value
  • (int) mj_cf_2 - maximum Majestic Citation Flow value
  • (int) mj_tf_1 - minimal Majestic Trust Flow value
  • (int) mj_tf_2 - maximum Majestic Trust Flow value
  • (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 - minimal page level
  • (int) level_2 - maximum page level
  • (int) ext_links - maximum number of outbound links
  • (int) ext_links_forecast - outbound links number forecast
  • (array) page_languages - массив идентификаторов языков страниц сайта (sape.get_languages — список допустимых значений)
  • (array) site_languages - массив идентификаторов преобладающих языков сайта (sape.get_languages — список допустимых значений)
  • (string) words - keywords
  • (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 - minimal Sape IntRank
  • (float) int_rank_2 - maximal Sape IntRank
  • (boolean) only_open_url - sites only with open URLs
  • (string) pages_per_site = null - флаг "all" доступен если поиск осуществляется по конкретному сайту (т.е. задан один site_id):
    • preferred - только оптимальные (по умолчанию)
    • one - одна
    • all - все страницы
  • (int) order = null - sorting:
    • 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 - show titles for pages
pn int No 0 номер страницы (для пагинации)
ps int No 100 кол-во сообщений на странице
Type Description
array Результат поиска:
  • (int) id - Site's ID
  • (string) url - site URL
  • (boolean) in_dmoz - presence in DMOZ
  • (boolean) in_yaca - presence in YACA
  • (int) category_id_v2 - ID категории
  • (string) region_id - regions IDs
  • (string) yaca_category_ids - YACA categories IDs
  • (int) cy - CY
  • (int) domain_level - уровень домана
  • (int) pr - PR
  • (int) mj_cf - Majestic Citation Flow
  • (int) mj_tf - Majestic Trust Flow
  • (int) flag_blocked_in_yandex - presence in Yandex
  • (int) flag_blocked_in_google - presence in Google
  • (int) nof_pages - number of pages
  • (int) nof_pages_in_yandex - number of pages in Yandex
  • (int) nof_pages_in_google - number of pages in Google
  • (int) schemas_access - схемы сайта
  • (int) lang_id - язык страницы
  • (int) moz_domain_authority - MOZ Domain Authority
  • (array) pages = null - страницы сайта:
    • (int) id - Page's ID
    • (string) uri - URI
    • (int) pr - PR
    • (int) tr - page level
    • (string) * title - заголовок страницы
    • (int) level - уровень домана
    • (int) ext_links - outbound link number
    • (float) price - price
    • (int) free_places - number of 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]] )
Advertiser
Sites searching

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

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
filter array Yes - фильтр:
  • (string) site_id - site IDs (comma-separated)
  • (string) page_id - ID страницы, можно через запятую
  • (int) cy_from - minimum CY value
  • (int) cy_2 - maximum CY value
  • (int) domain_level = 0 - domain level:
    • 0 - все уровни
    • 2 - второго уровня
    • 3 - третьего уровня
  • (array) domain_zones - an array with domain zones IDs
  • (array) categories_v2 - an array with categories IDs
  • (array) regions - an array with regions IDs
  • (array) yaca_categories - an array with YACA categories IDs
  • (array) whitelists - an array with whitelists IDs
  • (int) flag_blocked_in_yandex = null - наличие в Yandex:
    • 0 - есть (по умолчанию)
    • 1 - нет
    • 2 - не важно
  • (int) flag_blocked_in_google = null - presence in 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 - number of days since the site's registration
  • (int) date_added - number of days since the site's registration in the system
  • (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 - minimal page price
  • (float) price_2 - maximum page price
  • (int) pr_from - minimal PR value
  • (int) pr_2 - maximum PR value
  • (int) site_pr_1 - minimal value of homepage PR
  • (int) site_pr_2 - maximum value of homepage PR
  • (int) tr_1 - minimal SapeRank value
  • (int) tr_2 - maximum SapeRank value,
  • (int) mj_cf_1 - minimal Majestic Citation Flow value
  • (int) mj_cf_2 - maximum Majestic Citation Flow value
  • (int) mj_tf_1 - minimal Majestic Trust Flow value
  • (int) mj_tf_2 - maximum Majestic Trust Flow value
  • (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 - minimal page level
  • (int) level_2 - maximum page level
  • (int) ext_links - maximum number of outbound links
  • (int) ext_links_forecast - outbound links number forecast
  • (array) page_languages - массив идентификаторов языков страниц сайта (sape.get_languages — список допустимых значений)
  • (array) site_languages - массив идентификаторов преобладающих языков сайта (sape.get_languages — список допустимых значений)
  • (string) words - keywords
  • (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 - minimal Sape IntRank
  • (float) int_rank_2 - maximal Sape IntRank
  • (boolean) only_open_url - sites only with open URLs
  • (string) pages_per_site = null - флаг "all" доступен если поиск осуществляется по конкретному сайту (т.е. задан один site_id):
    • preferred - только оптимальные (по умолчанию)
    • one - одна
    • all - все страницы
  • (int) order = null - sorting:
    • 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 - show titles for pages
pn int No 0 номер страницы (для пагинации).
ps int No 100 кол-во результатов на странице.
Type Description
array Результат поиска:
  • (int) id - Page's ID
  • (string) uri - URI
  • (int) pr - PR
  • (int) tr - SapeRank
  • (string) * title - заголовок страницы
  • (int) level - page level
  • (float) price - price
  • (int) ext_links - outbound link number
  • (int) free_places - number of free places
  • (int) lang_id - язык страницы
  • (float) int_rank - Sape IntRank
  • (int) site_id - Site's ID
  • (string) url - site URL
  • (boolean) in_dmoz - presence in DMOZ
  • (boolean) in_yaca - presence in YACA
  • (int) category_id_v2 - ID категории
  • (string) yaca_category_ids - YACA categories IDs
  • (int) cy - CY
  • (int) mj_cf - Majestic Citation Flow
  • (int) mj_tf - Majestic Trust Flow
  • (int) flag_blocked_in_yandex - presence in Yandex
  • (int) flag_blocked_in_google - presence in Google
  • (int) nof_pages_in_yandex - number of pages in Yandex
  • (int) nof_pages_in_google - number of pages in Google
  • (int) schemas_access - схемы сайта
  • (int) page_authority - MOZ Page Authority
  • (int) page_mozrank - MOZ Page Rank
(string) sape.search_sitewide_delayed( (int) projectId, (array) filter[, (int) pn[, (int) ps = 100]] )

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

Name Type Obligatorily По умолчанию Description
projectId int Yes - Project ID
filter array Yes - фильтр:
  • (array) site_ids - список ID сайта
  • (int) domain_tcy__min - minimum CY value
  • (int) domain_tcy__max - maximum CY value
  • (int) domain_pr__min - minimal value of homepage PR
  • (int) domain_pr__max - maximum value of homepage PR
  • (int) domain_mj_cf__min - minimal Majestic Citation Flow value
  • (int) domain_mj_cf__max - maximum Majestic Citation Flow value
  • (int) domain_mj_tf__min - minimal Majestic Trust Flow value
  • (int) domain_mj_tf__max - maximum Majestic Trust Flow value
  • (int) domain_moz_authority__min - минимальное значение MOZ Domain Authority
  • (int) domain_moz_authority__max - максимальное значение MOZ Domain Authority
  • (int) domain_days_old_whois__min - number of days since the site's registration
  • (int) domain_level = 0 - domain level:
    • 0 - все уровни
    • 2 - второго уровня
    • 3 - третьего уровня
  • (int) domain_schemas_access = null - схемы сайта, если не передан, то не важно:
    • 1 - только http
    • 2 - только https
    • 3 - http и https
  • (boolean) domain_flag_blocked_in_yandex - наличие в Yandex
  • (boolean) domain_flag_blocked_in_google - presence in Google
  • (boolean) domain_in_yaca - сайты из YACA
  • (boolean) domain_in_dmoz - сайты из DMOZ
  • (array) domain_region_ids - an array with regions IDs
  • (array) domain_yaca_category_ids - an array with YACA categories IDs
  • (array) domain_zone_ids - an array with domain zones IDs
  • (int) domain_dout__min - минимальное значение исходящих доменов
  • (int) domain_dout__max - максимальное значение исходящих доменов
  • (int) domain_din__min - минимальное значение входящих доменов
  • (int) domain_din__max - максимальное значение входящих доменов
  • (int) site_date_added - number of days since the site's registration in the system
  • (int) site_links_display_mode = null - форма вывода ссылок, если не передан, то не важно:
    • 0 - стандартный
    • 1 - блочный
    • 2 - стандартный + блочный
  • (int) site_database = null - область поиска:
    • 0 - все сайты
    • 1 - основная база
    • 2 - сайты сомнительного содержания
  • (array) site_category_ids - an array with categories IDs
  • (array) site_language_ids - массив идентификаторов преобладающих языков сайта (sape.get_languages — список допустимых значений)
  • (float) page_price__min - minimal page price
  • (float) page_price__max - maximum page price
  • (int) page_traffic_rank__min - minimal SapeRank value
  • (int) page_traffic_rank__max - maximum SapeRank value,
  • (int) page_level__min - minimal page level
  • (int) page_level__max - maximum page level
  • (int) page_pr__min - minimal PR value
  • (int) page_pr__max - maximum PR value
  • (int) page_moz_rank__min - минимальное значение MOZ Page Rank
  • (int) page_moz_rank__max - максимальное значение MOZ Page Rank
  • (float) page_int_rank__min - minimal Sape IntRank
  • (float) page_int_rank__max - maximal Sape IntRank
  • (int) page_authority__min - минимальное значение MOZ Page Authority
  • (int) page_authority__max - максимальное значение MOZ Page Authority
  • (int) page_max_ext_links - maximum number of outbound links
  • (int) page_max_ext_links_forecast - outbound links number forecast
  • (array) page_language_ids - массив идентификаторов языков страниц сайта (sape.get_languages — список допустимых значений)
  • (string) ts_words - keywords
  • (int) ts_words_type = null - где искать ключевые слова:
    • 0 - в тексте страниц (по-умолчанию)
    • 1 - в title страниц
  • (array) whitelist_ids - an array with whitelists IDs
  • (boolean) no_double_in_project - не отображать сайты, уже купленные в рамках других URL текущего проекта
  • (boolean) no_double_in_system - не отображать сайты, уже купленные в рамках других URL других проектов
  • (boolean) no_double_in_folder - не отображать сайты, уже купленные в рамках других URL текущего раздела
  • (boolean) doubles - отображать площадки с размещенными ссылками
  • (boolean) site_open_urls - sites only with open URLs
  • (int) sitewide_placement_price__min - минимальная цена ссылки в пакете
  • (int) sitewide_placement_price__max - максимальная цена ссылки в пакете
  • (int) sitewide_nof_free_places__min - минимальное кол-во свободных мест на сайте
  • (int) sitewide_nof_free_places__max - максимальное кол-во свободных мест на сайте
  • (int) sorting_factor = 0 - поле для сортировки:
    • 0 - По умолчанию
    • 1 - Domain
    • 2 - CY
    • 5 - Site's ID
    • 6 - Category
    • 7 - Page's ID
    • 8 - PR
    • 9 - Page level
    • 10 - External links
    • 11 - Price
    • 12 - IntRank
    • 13 - PageMozRank
    • 14 - PageAuthority
  • (int) sorting_order = 0 - порядок сортировки:
    • 0 - по возрастанию
    • 1 - по убыванию
pn int No 0 номер страницы (для пагинации)
ps int No 100 кол-во результатов на странице
Type Description
string MD5 задания
(array) sape.search_sitewide_result( (string) handler )

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

Name Type Obligatorily По умолчанию Description
handler string Yes - указатель задания
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - ID площадки
  • (boolean) in_dmoz - признак наличия в DMOZ
  • (int) cy - CY
  • (string) url - УРЛ площадки
  • (int) pr - PR
  • (int) flag_blocked_in_yandex - признак бана в Яндекс
  • (int) flag_blocked_in_google - признак бана в Google
  • (int) nof_pages_in_yandex - number of pages in Yandex
  • (int) nof_pages_in_google - number of pages in Google
  • (int) date_added - дата добавления домена (Timestamp)
  • (int) nof_pages - число страниц площадки
  • (int) mj_cf - Majestic Citation Flow
  • (int) mj_tf - Majestic Trust Flow
  • (int) schemas_access - схема сайта
  • (int) moz_domain_authority - MOZ Domain Authority
  • (int) lang_id - идентификатор преобладающего языка площадки
  • (int) sitewide_nof_free_places - кол-во мест под сквозное размещение
  • (string) region_id - список идентификаторов регионов площадки (через запятую)
  • (string) category_id_v2 - список идентификаторов категорий (через запятую)
  • (float) price - базовая цена сквозной ссылки
  • (int) packet_size_optimize - размер оптимального пакета
  • (array) packet_size_list = null - скидочная таблица:
    • (int) key - процент от общего числа свободных мест площадки
    • (int) size - кол-во сквозных ссылок
    • (float) price - базовая цена сквозной ссылки
    • (float) cost - базовая стоимость пакета
    • (int) * discountPersent - мкидка в процентах
    • (float) * discountPrice - конечная цена ссылки с учетом скидки и комиссии
    • (float) * discountCost - конечная стоимость пакета с учетом скидки и комиссии
(string) sape.placement_create( (int) pageId, (int) urlId, (int|string) anchor[, (array) hash = array()] )
Advertiser
Links

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

Name Type Obligatorily По умолчанию Description
pageId int Yes - Page's ID
urlId int Yes - URL ID,
anchor int|string Yes - если anchor число, то выбирается текст из БД текстов по ID; если anchor = 0, то берётся следующий неиспользованный текст
hash array No array() Содержит следующие значения:
  • (int) force_seo_wait - установка статуса если это возможно:
    • 1 - ожидает подтверждения оптимизатора
    • 2 - размещено
  • (float) max_price - максимальная цена за ссылку, если цена ссылки, больше максимальной, то не будем покупать
Type Description
string Link ID
(array) sape.placements_create( [(array) placements = array()] )
Advertiser
Links

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

Name Type Obligatorily По умолчанию Description
placements array No array() Список, каждый элемент которого содержит:
  • (int) page_id - Page's ID
  • (int) url_id - URL ID,
  • (string) anchor - если anchor число, то выбирается текст из БД текстов по ID; если anchor = 0, то берётся следующий неиспользованный текст
  • (array) params = array() Содержит следующие значения:
    • (int) force_seo_wait - установка статуса если это возможно:
      • 1 - ожидает подтверждения оптимизатора
      • 2 - размещено
    • (float) max_price - максимальная цена за ссылку, если цена ссылки, больше максимальной, то не будем покупать
Type Description
array в случае успеха возвращается массив с ID ссылок или описаниями ошибок
(string) sape.get_placement_status( (int) placementId[, (boolean) checkSleepBalance = false] )
Advertiser
Publisher
Links

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

Name Type Obligatorily По умолчанию Description
placementId int Yes - Link ID
checkSleepBalance boolean No false флаг указывающий на то, что нужно проверить на биллинговый слип
Type Description
string статус ссылки или если указан флаг checkSleepBalance, то будет возвращён массив со следующими полями:
  • (string) status
  • (boolean) is_sleep_balance
(array) sape.get_placements_new_prices( [(int) projectId[, (int) filterDays = 30[, (boolean) showSiteId = false]]] )
Advertiser
Links

Receipt of the new prices of the projects links.

Name Type Obligatorily По умолчанию Description
projectId int No 0 ID проекта (если равен 0, то новые цены ищутся для всех проектов)
filterDays int No 30 rол-во дней, в течение которых цены были изменены
showSiteId boolean No false возвращать ID сайта
Type Description
array Список, каждый элемент которого содержит:
  • (string) id - Link ID
  • (date) date - дата установки старой цены
  • (float) price - старая цена
  • (date) date_price_changed - дата установки новой цены
  • (float) price_new - новая цена
  • (int) * site_id - Site's ID
(boolean) sape.placements_new_price_accept( (array) placementIds )
Advertiser
Links

Одобрение новых цен на ссылки.

Name Type Obligatorily По умолчанию Description
placementIds array Yes - Links ID
Type Description
boolean результат операции
(boolean) sape.placements_new_price_reject( (array) placementIds )
Advertiser
Links

Отклонение новых цен на ссылоки.

Name Type Obligatorily По умолчанию Description
placementIds array Yes - Links ID
Type Description
boolean результат операции
(boolean) sape.placement_update_url( (int) placementId, (int) urlId )
Advertiser
Links

Link URL change. The links transfer is possible only between URLs of the same domain.

Name Type Obligatorily По умолчанию Description
placementId int Yes - Link ID
urlId int Yes - URL ID,
Type Description
boolean результат операции
(array) sape.placements_accept_wm( (array) pids )
Publisher
Links

Одобрение ссылок вебмастером. Необходимо одобрять ссылки в статусе WAIT_WM.

Name Type Obligatorily По умолчанию Description
pids array Yes - список ID ссылок (не больше 100 элементов)
Type Description
array Содержит следующие значения:
  • (int) nof_ok - ссылок в статусе OK
  • (int) nof_wait - ссылок в статусе WAIT
  • (array) ext_stats = null - подробная статистика по УРЛ'ам:
    • (int) nof_ok = 0 - ссылок в статусе OK
    • (int) nof_wait = 0 - ссылок в статусе WAIT
(boolean) sape.placement_accept_seo( (int) placementId )
Advertiser
Links

Advertiser's confirmation of link. Approve links in WAIT_SEO status.

Name Type Obligatorily По умолчанию Description
placementId int Yes - Link ID
Type Description
boolean результат операции
(array) sape.placements_accept_seo( (array) placementIds )
Advertiser
Links

Одобрение списка ссылок оптимизатором. Необходимо одобрять ссылки в статусе WAIT_SEO.

Name Type Obligatorily По умолчанию Description
placementIds array Yes - список ID ссылок (не больше 100 элементов)
Type Description
array Список, каждый элемент которого содержит:
  • (string) id - Link ID
  • (int) status = 0 - статус:
    • 0 - ALREADY_IS
    • 1 - OK
    • -1 - FAILED
(int) sape.placement_sleep( (array) placementIds )
Advertiser
Links

The sleeping of a link or a group of links.

Name Type Obligatorily По умолчанию Description
placementIds array Yes - Links ID
Type Description
int в случае успеха возвращает количество успешно замороженных ссылок
(array) sape.placement_sleep_url( (int) urlId )
Advertiser
Links

The sleeping of all URL links.

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
Type Description
array Содержит следующие значения:
  • (int) slept - количество успешно замороженных ссылок
  • (int) not_slept - количество ссылок, во время заморозки которых произошла ошибка
  • (int) removed - количество удалённых заявок
(boolean) sape.placement_sleep_project( (int) projectId )
Advertiser
Links

The sleeping of all links and all URLs of the project.

Name Type Obligatorily По умолчанию Description
projectId int Yes - Project ID
Type Description
boolean результат операции
(int) sape.placement_unsleep( (array) placementIds )
Advertiser
Links

The unsleeping of a link or a group of links.

Name Type Obligatorily По умолчанию Description
placementIds array Yes - Links ID
Type Description
int в случае успеха возвращает количество успешно размороженных ссылок
(int) sape.placement_unsleep_url( (int) urlId )
Advertiser
Links

The unsleeping of all URL links.

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
Type Description
int в случае успеха возвращает количество успешно размороженных ссылок
(int) sape.placements_delete_url( (int) urlId[, (string) status = null] )
Advertiser
Links

All links rejection (if status is not specified, then all links will be removed).

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
status string No null если не указан статус, будут удалены все:
  • WAIT_WM - ожидает подтверждения вебмастера
  • WAIT_SEO - ожидает подтверждения оптимизатора
  • OK - размещена
  • ERROR - не найдена
  • SLEEP - заблокирована вручную или из-за нехватки денег у оптимизатора
Type Description
int в случае успеха возвращает количество успешно удалённых заявок
(int) sape.placements_wait_delete_url( (int) urlId )
Advertiser
Links

Rejection of all WAIT URLs (WAIT_SEO and WAIT_WM).

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
Type Description
int в случае успеха возвращает количество успешно удалённых заявок
(boolean) sape.placement_delete( (int) pid[, (array) params = null] )
Advertiser
Links

Link removal by ID.

Name Type Obligatorily По умолчанию Description
pid int Yes - Link ID
params array No null Содержит следующие значения:
  • (boolean) no_bl_add - не добавлять в блек лист
Type Description
boolean результат операции
(array) sape.placements_delete( (array) pids[, (array) params = null] )
Advertiser
Links

Удаление ссылок по списку ID.

Name Type Obligatorily По умолчанию Description
pids array Yes - список ID (не больше 100 элементов)
params array No null Содержит следующие значения:
  • (boolean) no_bl_add - не добавлять в блек лист
Type Description
array список ID успешно удалённых ссылок
(int) sape.url_anchor_add( (int) urlId, (string) text[, (array) options = array()] )
Advertiser
URLs
Anchors

A new text adding to URL.

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
text string Yes - aнкор
options array No array() список параметров:
  • (int) limit - максимальное количество использования текста в ссылках
  • (boolean) check_exist - возвращать ошибку, если переданный текст уже существует на УРЛе, если параметр не указан, то в случае наличия дубля анкора будет возвращаться ID уже существующего анкора
Type Description
int ID нового текста
(array) sape.url_anchors_add( (int) urlId, (array) anchors[, (array) options = array()] )
Advertiser
URLs
Anchors

Добавление для УРЛа списка новых текстов.

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
anchors array Yes - список анкоров
options array No array() список параметров:
  • (int) limit - максимальное количество использования текста в ссылках
  • (boolean) return_errors = false - возвращать ошибки
  • (boolean) check_exist - возвращать ошибку, если переданный текст уже существует на УРЛе, если параметр не указан, то в случае наличия дубля анкора будет возвращаться ID уже существующего анкора
Type Description
array если параметр return_errors не передан, то воздращается только список ID новых акоров:
  • (array) anchors_id - список ID новых анкоров
  • (array) errors Список, каждый элемент которого содержит:
    • (int) code - код ошибки
    • (int) text_num - порядковый номер недобавленного текста (нумерация от 1)
(string|boolean) sape.placement_update_text( (int) placementId, (string) anchor[, (int) actionReject = 1] )
Advertiser
Links
Anchors

Создание заявки на смену текста.

Name Type Obligatorily По умолчанию Description
placementId int Yes - Link ID
anchor string Yes - если anchor число, то выбирается текст из БД текстов по ID; если anchor = 0, то берётся следующий неиспользованный текст
actionReject int No 1 действие при отказе вебмастера сменить текст:
  • 1 - старая ссылка сохраняется
  • 2 - старая ссылка удаляется
Type Description
string|boolean в случае успеха возвращает ID ссылки с новым текстом или true если добавлена заявка на смену текста
(array) sape.get_placements_text_updates( [(int) siteId = null] )
Publisher
Links
Anchors

Receipt of text change requests.

Name Type Obligatorily По умолчанию Description
siteId int No null ID сайта, если не задан, то для всех сайтов пользователя
Type Description
array Список, каждый элемент которого содержит:
  • (string) id - Link ID
  • (date) date_created - дата создания ссылки
  • (string) txt - старый текст
  • (date) request_date - дата создания заявки на смену текста
  • (string) request_txt - новый текст
  • (int) action_reject = 1 - флаг, указывающий на то, что будет, если отклонить заявку:
    • 1 - старая ссылка сохраняется
    • 2 - старая ссылка удаляется
(array) sape.placements_text_updates_accept( (array) plIds )
Publisher
Links
Anchors

The approval of text change requests.

Name Type Obligatorily По умолчанию Description
plIds array Yes - List of ID links
Type Description
array список ID новых ссылок в том же порядке как и на входе
(boolean) sape.placements_text_updates_reject( (array) plIds )
Publisher
Links
Anchors

Rejection of text change requests.

Name Type Obligatorily По умолчанию Description
plIds array Yes - List of ID links
Type Description
boolean результат операции
(boolean) sape.url_anchor_delete( (int) urlId, (int|string) anchor )
Advertiser
URLs
Anchors

Удаление текста из базы текстов УРЛа.

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
anchor int|string Yes - ID или текст анкора
Type Description
boolean результат операции
(int) sape.url_anchors_delete( (int) urlId[, (array) anchorIds = null] )
Advertiser
URLs
Anchors

Удаление списка текстов из базы текстов УРЛа.

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
anchorIds array No null список ID анкоров (если не задан, то будут удалены все тексты УРЛа)
Type Description
int количество удалённых текстов
(int) sape.url_anchors_delete_sitewide( (int) urlId[, (array) anchorIds = null] )
Advertiser
URLs
Anchors

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

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
anchorIds array No null список ID анкоров (если не задан, то будут удалены все тексты УРЛа)
Type Description
int количество удалённых текстов
(string) sape.urls_anchors_add_sitewide_delayed( (array) urlIds, (array) texts[, (array) options = array()] )
Advertiser
URLs
Anchors

Добавление текстов для УРЛов проекта сквозных ссылок.

Name Type Obligatorily По умолчанию Description
urlIds array Yes - идентификаторы УРЛов
texts array Yes - список анкоров
options array No array() список параметров:
  • (int) limit_per_packet - максимальное количество использования текста в пакете
  • (int) limit_per_site - максимальное количество использования текста на площадке
  • (boolean) merge - Команда склеивать полные дубли
  • (boolean) merge_anchor - Команда склеивать дубли анкоров
Type Description
string MD5 идентификатора задания
(string) sape.create_and_buy_packet_sitewide( (int) projectId, (int) siteId, (array) params )

Создание пакета сквозных ссылок (черновик)

Name Type Obligatorily По умолчанию Description
projectId int Yes - Идентификатор проекта
siteId int Yes - Идентификатор площадки
params array Yes - Параметры создания пакета:
  • (int) size - Размер пакета
  • (int) draftStrategy - Стратегия формирования пакета
Type Description
string MD5 задания
(array) sape.create_and_buy_packet_sitewide_result( (string) handler )

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

Name Type Obligatorily По умолчанию Description
handler string Yes - Указатель задания
Type Description
array Результат создания пакета:
  • (int) packet_id - Идентификатор пакета
  • (array) * bad_words = null Список, каждый элемент которого содержит:
    • (string) word - Слово
(boolean) sape.sitewide_packet_delete( (int) packetId )

Удаление пакета сквозных ссылок.

Name Type Obligatorily По умолчанию Description
packetId int Yes - Идентификатор пакета
Type Description
boolean Результат операции
(array) sape.sitewide_packets_get( (int) projectId, (int) ps, (int) pn )

Список пакетов сквозных ссылок.

Name Type Obligatorily По умолчанию Description
projectId int Yes - Идентификатор проекта
ps int Yes - Кол-во элементов на странице
pn int Yes - The page number
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - Идентификатор пакета
  • (int) site_id - Идентификатор площадки
  • (int) status - Идентификатор статуса пакета
  • (int) size - Кол-во ссылок в пакете
  • (int) nof_placements - Кол-во размещенных ссылок
  • (int) nof_errors - Кол-во ссылок с ошибками
  • (int) nof_sleeps - Кол-во ссылок в статусе sleep
  • (date) date_created - Дата создания пакета
  • (float) price - Стоимость ссылки
  • (int) procent_error - Процент ссылок с ошибками
  • (int) procent_sleep - Процент спящих ссылок
(array) sape.get_stopwords()
Publisher
Censored words

Receiving of the user's censored words list.

Type Description
array Список, каждый элемент которого содержит:
  • (int) id - List ID
  • (string) name - имя списка
  • (string) words - список стоп-слов
(array) sape.get_stopwords_site( (int) siteId )
Publisher
Censored words
Sites

Receiving of the ID array with site's list of censored words.

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
Type Description
array список ID списков стоп-слов сайта
(int) sape.stopwords_list_add( (string) name, (string) words )
Publisher
Censored words

Censored words list addition.

Name Type Obligatorily По умолчанию Description
name string Yes - название
words string Yes - стоп-слова
Type Description
int ID списка стоп-слов
(boolean) sape.stopwords_list_update( (int) listId, (string) name, (string) words )
Publisher
Censored words

Change of censored words list.

Name Type Obligatorily По умолчанию Description
listId int Yes - List ID
name string Yes - название
words string Yes - стоп-слова
Type Description
boolean результат операции
(boolean) sape.stopwords_words_add( (array) listIds, (string) words )
Publisher
Censored words

Censored words addition to the list.

Name Type Obligatorily По умолчанию Description
listIds array Yes - List ID
words string Yes - Censored words
Type Description
boolean результат операции
(boolean) sape.stopwords_words_delete( (array) listIds, (string) words )
Publisher
Censored words

Censored words removal from the list.

Name Type Obligatorily По умолчанию Description
listIds array Yes - List ID
words string Yes - Censored words
Type Description
boolean результат операции
(int) sape.stopwords_site_add( (array) listIds, (int) siteId )
Publisher
Censored words
Sites

Censored words binding to the site.

Name Type Obligatorily По умолчанию Description
listIds array Yes - Invalid ID of censored words list
siteId int Yes - Site's ID
Type Description
int количество привязанных списков
(int) sape.stopwords_site_delete( (array) listIds, (int) siteId )
Publisher
Censored words
Sites

Removal of the censored words list and site's connections.

Name Type Obligatorily По умолчанию Description
listIds array Yes - Invalid ID of censored words list
siteId int Yes - Site's ID
Type Description
int количество удаленных связей
(boolean) sape.stopwords_list_delete( (int) listId )

Censored words list removal.

Name Type Obligatorily По умолчанию Description
listId int Yes - List ID
Type Description
boolean результат операции
(array) sape.get_whitelists()
Advertiser
Publisher
White and black lists

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

Type Description
array Список, каждый элемент которого содержит:
  • (int) id - ID
  • (string) name - название
(int) sape.whitelist_create( (string) name )
Advertiser
White and black lists

The adding of the section of favorites.

Name Type Obligatorily По умолчанию Description
name string Yes - название
Type Description
int ID нового раздела избранного
(array) sape.get_wl_domains( (int) wlId[, (int) pn[, (int) ps = 100]] )
Advertiser
White and black lists

Domains receiving from the section of favorites.

Name Type Obligatorily По умолчанию Description
wlId int Yes - ID раздела избранного
pn int No 0 номер страницы (для пагинации)
ps int No 100 кол-во сообщений на странице
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - ID домена
  • (string) domain - домен
(boolean) sape.wl_add( (array) domains, (array) wlIds )
Advertiser
White and black lists

Domains adding to the section/sections of favorites.

Name Type Obligatorily По умолчанию Description
domains array Yes - список доменов
wlIds array Yes - Section ID
Type Description
boolean результат операции
(boolean) sape.wl_del( (array) domainIds, (array) wlIds )
Advertiser
White and black lists

Domains removal from the section/sections of favorites.

Name Type Obligatorily По умолчанию Description
domainIds array Yes - список ID доменов
wlIds array Yes - Section ID
Type Description
boolean результат операции
(boolean) sape.whitelist_delete( (int) wlId )
Advertiser
White and black lists

Section of favorites removal.

Name Type Obligatorily По умолчанию Description
wlId int Yes - ID списка избранного
Type Description
boolean результат операции
(array) sape.get_gbl_domains( [(int) pn[, (int) ps = 100]] )
Advertiser
White and black lists

Получение списка доменов в глобальном БЛ.

Name Type Obligatorily По умолчанию Description
pn int No 0 номер страницы (для пагинации)
ps int No 100 кол-во сообщений на странице
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - ID домена
  • (string) domain - домен
(array) sape.get_projects_gbl_domains( [(int) pn[, (int) ps = 100]] )
Advertiser
White and black lists

Получение списка доменов в глобальном БЛ.

Name Type Obligatorily По умолчанию Description
pn int No 0 номер страницы (для пагинации)
ps int No 100 кол-во сообщений на странице
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - ID домена
  • (string) domain - домен
(int) sape.urls_gbl_add( (array) domains[, (boolean) removePlacements = true] )
Advertiser
White and black lists

Добавление домена в глобальный БЛ.

Name Type Obligatorily По умолчанию Description
domains array Yes - список доменов
removePlacements boolean No true если true, то будет удалены все размещенные ссылки на этом домене
Type Description
int количество успешно добавленных записей
(int) sape.projects_gbl_add( (array) domains[, (boolean) removePlacements = true] )
Advertiser
White and black lists

Добавление домена в глобальный БЛ.

Name Type Obligatorily По умолчанию Description
domains array Yes - список доменов
removePlacements boolean No true если true, то будет удалены все размещенные ссылки на этом домене
Type Description
int количество успешно добавленных записей
(int) sape.urls_gbl_del( (array) domains )
Advertiser
White and black lists

Удаление домена из глобального БЛ.

Name Type Obligatorily По умолчанию Description
domains array Yes - список доменов
Type Description
int количество успешно удаленных записей
(int) sape.projects_gbl_del( (array) domains )
Advertiser
White and black lists

Удаление домена из глобального БЛ.

Name Type Obligatorily По умолчанию Description
domains array Yes - список доменов
Type Description
int количество успешно удаленных записей
(array) sape.get_project_bl_domains( (int) projectId[, (int) pn[, (int) ps = 100]] )
Advertiser
White and black lists

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

Name Type Obligatorily По умолчанию Description
projectId int Yes - Project ID
pn int No 0 номер страницы (для пагинации)
ps int No 100 кол-во сообщений на странице
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - ID домена
  • (string) domain - домен
(int) sape.url_bl_add( (int) urlId, (array) domains[, (boolean) removePlacements = true] )
Advertiser
White and black lists

Добавление домена в БЛ проекта по УРЛу.

Name Type Obligatorily По умолчанию Description
urlId int Yes - URL ID,
domains array Yes - список доменов
removePlacements boolean No true если true, то будет удалены все размещенные ссылки на этом домене
Type Description
int количество успешно добавленных записей
(int) sape.project_bl_add( (int) projectId, (array) domains[, (boolean) removePlacements = true] )
Advertiser
White and black lists

Добавление домена в БЛ проекта.

Name Type Obligatorily По умолчанию Description
projectId int Yes - Project ID
domains array Yes - список доменов
removePlacements boolean No true если true, то будет удалены все размещенные ссылки на этом домене
Type Description
int количество успешно добавленных записей
(int) sape.project_bl_del( (int) projectId, (array) domains )
Advertiser
White and black lists

Удаление домена из БЛ проекта.

Name Type Obligatorily По умолчанию Description
projectId int Yes - Project ID
domains array Yes - список доменов
Type Description
int количество успешно удаленных записей
(int) sape.site_bl_add( (array) domains[, (int) siteId[, (boolean) removePlacements = true]] )
Publisher
White and black lists

Adding of domains list to the BL or GBL.

Name Type Obligatorily По умолчанию Description
domains array Yes - список доменов
siteId int No 0 ID сайта, если = 0, то добавление доменов в GBL
removePlacements boolean No true если true, то будет удалены все размещенные ссылки на этом домене
Type Description
int количество успешно добавленных записей
(int) sape.site_bl_del( (array) domains[, (int) siteId] )
Publisher
White and black lists

The removal of domains list from the BL or GBL.

Name Type Obligatorily По умолчанию Description
domains array Yes - список доменов
siteId int No 0 ID сайта, если = 0, то удаление доменов из GBL
Type Description
int количество успешно удаленных записей
(array) sape.get_bonus_sponsor_details()
Advertiser
Publisher
Balance

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

Type Description
array Список, каждый элемент которого содержит:
  • (int) user_id - User's ID
  • (float) bonus - баланс
(array) sape.get_bonus_sponsor_history()
Advertiser
Publisher
Balance

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

Type Description
array Список, каждый элемент которого содержит:
  • (int) request_id - ID заявки
  • (int) request_date - timestamp заявки
  • (int) user_id - User's ID
  • (float) amount - сумма
(array) sape.get_bonus_user_details()
Advertiser
Publisher
Balance

Получение информации о бонусах по партнерским программам.

Type Description
array Список, каждый элемент которого содержит:
  • (int) sponsor_user_id - ID спонсора
  • (int) bonus_program_id - ID партнерской программы
  • (float) bonus - баланс
(array) sape.get_bonus_user_history()
Advertiser
Publisher
Balance

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

Type Description
array Список, каждый элемент которого содержит:
  • (int) request_id - ID заявки
  • (int) request_date - timestamp заявки
  • (int) bonus_program_id - ID партнерской программы
  • (int) sponsor_user_id - ID спонсора
  • (float) amount - сумма
(array) sape.get_bonus_user_balances_history( (timestamp) dateFrom, (timestamp) dateTo[, (int) bonusProgramId = null] )

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

Name Type Obligatorily По умолчанию Description
dateFrom timestamp Yes - дата от
dateTo timestamp Yes - дата до
bonusProgramId int No null ID бонусной программы
Type Description
array Список, каждый элемент которого содержит:
  • (int) request_id - ID заявки
  • (int) request_date - timestamp заявки
  • (int) bonus_program_id - ID партнерской программы
  • (int) sponsor_user_id - ID спонсора
  • (float) amount - сумма
(array) sape.get_domain_zones()
Advertiser
Publisher
Categories and lists of transfers

Получение списка доменных зон.

Type Description
array Список, каждый элемент которого содержит:
  • (int) id - ID
  • (string) zone - зона
(array) sape.get_regions()
Advertiser
Publisher
Categories and lists of transfers

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

Type Description
array Список, каждый элемент которого содержит:
  • (int) id - ID
  • (string) name - регион
(array) sape.get_categories_v2( [(string) lang = ru] )
Advertiser
Publisher
Categories and lists of transfers

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

Name Type Obligatorily По умолчанию Description
lang string No ru язык резульрата
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - ID
  • (string) name - категория
(array) sape.get_yaca_categories()
Advertiser
Publisher
Categories and lists of transfers

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

Type Description
array Список, каждый элемент которого содержит:
  • (int) id - ID
  • (int) parent_id - ID родительской категории
  • (string) name - название
(array) sape.get_languages( [(string) lang = ru] )
Advertiser
Publisher
Categories and lists of transfers

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

Name Type Obligatorily По умолчанию Description
lang string No ru язык резульрата
Type Description
array Список, каждый элемент которого содержит:
  • (int) id - ID
  • (string) name - язык
(array) sape.get_avg_prices()
Advertiser
Publisher

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

Type Description
array Список, каждый элемент которого содержит:
  • (int) cy_from - ТиЦ от
  • (int) cy_to - ТиЦ до
  • (int) level - page level
  • (int) pr - pr
  • (float) price - средняя цена
(array) sape.get_avg_site_prices( (int) siteId[, (boolean) withNoActive = false[, (boolean) showPlaces = false]] )
Advertiser
Publisher
Sites

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

Name Type Obligatorily По умолчанию Description
siteId int Yes - Site's ID
withNoActive boolean No false считать неактивные страницы
showPlaces boolean No false возвращать или нет количество мест и ссылок
Type Description
array Список, каждый элемент которого содержит:
  • (int) level - page level
  • (int) pr - pr
  • (float) price - средняя цена
  • (int) * total_places - всего мест для данного уровня
  • (int) * total_links - всего ссылок
  • (int) * total_free - мест свободно
(array) sape.get_messages( [(array) filter = null[, (int) pn[, (int) ps = 100]]] )
Advertiser
Publisher

Поиск сообщений по параметрам.

Name Type Obligatorily По умолчанию Description
filter array No null Содержит следующие значения:
  • (array) dates - список дат за которые необходимо получить сообщения (доступны только последние семь дней)
  • (string) query - текст фильтра (utf-8)
  • (array) types - список типов сообщений:
    • 1 - На собственной странице * размещена новая ссылка * на URL *
    • 2 - Новая заявка на размещение на странице * ссылки * на URL *
    • 3 - Размещение на странице * ссылки * на URL * утверждено хозяином площадки (АВТО) и оптимизатором (АВТО)
    • 4 - Размещение на странице * ссылки * на URL * утверждено хозяином площадки (АВТО) и ожидает подтверждения оптимизатора.
    • 5 - Размещение на странице * ссылки * на URL * отменено.
    • 6 - На собственной странице * обновился текст ссылки на URL * &mdash новый текст *
    • 7 - Заявка на смену текста ссылки на URL * на странице * — новый текст *
    • 8 - Новая цена (*) для размещения ссылки * на сайт * на странице * принята.
    • 9 - Размещение на странице * ссылки * на URL * подтверждено оптимизатором.
    • 10 - Площадка * [ID:*] удалена вебмастером из системы вместе со всеми заявками и ссылками!
    • 11 - Проект * удалён
    • 12 - В проект * добавлен URL *
    • 13 - Удаление URL из проекта
    • 14 - От Вашего сайта * [ID:*] в течение последних * дней не было ни одного обращения к нашему серверу за новыми ссылками. Покупка новых ссылок на сайте приостановлена. Напишите в обратную связь, когда исправите проблему.
    • 15 - При очередной проверке размещения ссылок, на странице * не была найдена ваша ссылка * на сайт *.
    • 16 - Число внешних ссылок на всех страницах сайта * обновлено нашим роботом.
    • 17 - Cайт * не проиндексирован поисковой системой Яндекс.
    • 18 - Главная страница сайта * не отвечает! Примите необходимые меры и добавьте сайт в систему снова.
    • 19 - Ваш сайт * проиндексирован нашим роботом и отправлен на модерацию. Для начала работы следует разрешить найденные роботом страницы к продаже. Сайт заработает после проверки нашим модератором.
    • 20 - Cайт * удалён из системы.
    • 21 - Ваш сайт * проиндексирован нашим контекстным роботом. Для начала работы следует разрешить найденные роботом страницы с контекстным кодом к продаже.
    • 22 - Цена на размещение ссылки * [*] на странице * увеличена с * до * . У Вас есть * дней, чтобы принять новую цену или отказаться от этой ссылки.
    • 24 - Размещение на странице * ссылки * на URL * утверждено хозяином площадки и оптимизатором (АВТО).
    • 25 - Размещение на странице * ссылки * на URL * утверждено хозяином площадки и ожидает подтверждения оптимизатора.
    • 26 - Ваш УРЛ [ID:*] из проекта * был принудительно переведён в ручной режим работы из полу-автоматического в связи с тем, что в течение 10 дней Вами не было одобрено/отклонено ни одной подобранной автоматом заявки.
    • 27 - Режим модерации УРЛа * был изменён на ручной/автоматический
    • 28 - Проект * усыплён
    • 29 - Sleep сделаный оптимизатором
    • 30 - Sleep из-за нулевого баланса
    • 31 - Сайт активирован пользователем после бана за отсутствие обращений к диспенсеру
    • 32 - UnSleep ссылки
    • 33 - Заявка на смену текста ссылки на URL * на странице * — новый текст * — утверждено хозяином площадки (АВТО).
    • 34 - Настройка `Проставлять ссылкам атрибут rel="nofollow"` для URL * включена
    • 35 - Настройка `Проставлять ссылкам атрибут rel="nofollow"` для URL * сброшена
    • 36 - Частота работы авторежима на УРЛе * была изменена на * дня(ей).
    • 37 - На Вашем сайте * слишком большой процент ссылок в статусе ERROR. Покупка новых ссылок на сайте приостановлена. Напишите в обратную связь, когда исправите проблему.
    • 38 - При очередной проверке размещения ссылок, на странице * не была найдена ваша ссылка * на сайт *. Это может быть связано с проблемами хостинга у площадки. Средства с вашего счета не будут списаны за эти сутки, при восстановлении работоспособности площадки размещение вашей ссылки возобновится.
    • 39 - Заявка на странице * ссылки * на URL * отменена.
    • 40 - Поисковые системы считают ваш сайт %u [ID:%i] небезопасным. Покупка новых ссылок на сайте приостановлена.
    • 41 - Ваш сайт %u [ID:%i] активирован после бана за превышение количества ссылок в статусе ERROR.
    • 42 - При очередной проверке размещения ссылок, на странице * не была найдена ваша ссылка * на сайт *.
    • 43 - Настройка "Проставлять ссылкам тег noindex" для URL %u включена.
    • 44 - Новая заявка на размещение на странице * тизера * c изображением * на URL *
    • 45 - Размещение на странице * ссылки * на URL * утверждено хозяином площадки (АВТО) и оптимизатором (АВТО)
    • 46 - На собственной странице * размещён новый тизер * c изображением * со ссылкой на URL *.
    • 47 - Новая заявка на размещение на странице * тизера * c изображением * на URL * утверждена хозяином площадки (АВТО) и оптимизатором (АВТО).
    • 48 - Размещение на странице * тизера * c изображением * на URL * подтверждено оптимизатором.
    • 49 - Размещение на странице * тизера * с изображением * на URL * утверждено хозяином площадки и оптимизатором (АВТО).
    • 50 - Размещение на странице * ссылки* с изображением * на URL * утверждено хозяином площадки и ожидает подтверждения оптимизатора.
    • 51 - Новая заявка на размещение на странице * тизера * c изображением * на URL * - ожидает модерации изображения.
    • 52 - Изображение * для тизерных размещений успешно прошло модерацию.
    • 53 - Изображение * для тизерных размещений не прошло модерацию.
    • 54 - Ваш сайт * [ID: *] недоступен в течение последних * дней. Покупка новых ссылок на сайте приостановлена. Напишите в обратную связь, когда исправите проблему.
    • 55 - Новая заявка на размещение пакета сквозных ссылок [ID: *; размер: *] на сайте *.
    • 56 - Размещение пакета сквозных ссылок [ID: *] на сайте * утверждено хозяином площадки.
    • 57 - Размещение пакета сквозных ссылок [ID: *] на сайте * отменено хозяином площадки.
    • 58 - Размещение пакета сквозных ссылок [ID: *] на сайте * отменено оптимизатором.
    • 59 - Размещение пакета сквозных ссылок [ID: *] на сайте * приостановлено.
    • 60 - Размещение пакета сквозных ссылок [ID: *] на сайте * приостановлено из-за нулевого баланса.
    • 61 - Размещение пакета сквозных ссылок [ID: *] на сайте * приостановлено из-за превышения количества ссылок в статусе ERROR.
    • 62 - Размещение пакета сквозных ссылок [ID: *] на сайте * возобновлено.
pn int No 0 номер страницы
ps int No 100 rол-во сообщений на странице (может принимать следующие значения: 10, 50, 100, 250, 500, 1000)
Type Description
array Содержит следующие значения:
  • (int) row_count - кол-во сообщений
  • (int) page_count - кол-во страниц
  • (array) messages = array() Список, каждый элемент которого содержит:
    • (date) date - дата
    • (int) type - тип
    • (string) body - текст сообщения (UTF-8)
(string) sape.placements_update_text_delayed( (array) plAnchor[, (int) actionReject = 1] )
Advertiser
Links
Anchors
Pending tasks

Обновление текстов ссылок в фоновом режиме.

Name Type Obligatorily По умолчанию Description
plAnchor array Yes - ключами данного массива должны быть идентификаторы ссылок в виде строки, а значениями тексты или идентификаторы анкоров
actionReject int No 1 Возможные значения:
  • 1 - старая ссылка сохраняется
  • 2 - старая ссылка удаляется
Type Description
string указатель на задание (handler)
(string) sape.placements_delete_delayed( (array) placementIds[, (array) options = null] )
Advertiser
Links
Pending tasks

Удаление ссылок в фоновом режиме.

Name Type Obligatorily По умолчанию Description
placementIds array Yes - Links ID
options array No null Содержит следующие значения:
  • (boolean) no_bl_add - не добавлять в блек лист
Type Description
string указатель на задание (handler)
(array) sape.get_task_status( (string) handler )
Advertiser
Publisher
Pending tasks

Получение статуса задания по указателю. Поля result, sofar, totalwork - могут быть пустыми (зависит от выполняемого задания и статуса).

Name Type Obligatorily По умолчанию Description
handler string Yes - указатель на задание.
Type Description
array Содержит следующие значения:
  • (int) status - статус выполнения:
    • 0 - ожидает выполнения
    • 1 - выполняется
    • 2 - выполнено
  • (mixed) result - результат
  • (int) sofar - количество выполненных операций задания (если есть)
  • (int) totalwork - общее количество операций задания (если есть)
Code
Message
Description
100
SAPE.RU: Not enough params :o(
Not enough parameters
101
SAPE.RU: Internal error :o(
Internal error
102
SAPE.RU: Bad or unknown ID :o(
Invalid ID
110
SAPE.RU: User registration failed :o(
The user is not registered
111
SAPE.RU: Bad login :o(
Invalid login or password
112
SAPE.RU: Login already in use :o(
This login is already in the system
113
SAPE.RU: Email already in use :o(
This e-mail is already in the system
114
SAPE.RU: Password too short :o(
The password is too short
115
SAPE.RU: Bad email :o(
Invalid e-mail
116
SAPE.RU: Bad username :o(
Invalid username
117
SAPE.RU: Bad refid :o(
Invalid referral ID
118
SAPE.RU: Bad user id :o(
Invalid user ID
119
SAPE.RU: User not auth :o(
The user is not authorized
120
SAPE.RU: Bad external system ID :o(
Invalid external system ID
121
SAPE.RU: Method is restricted for current user :o(
The method is not allowed to be called for this user
122
SAPE.RU: User does not exist :o(
User dos not exist
123
SAPE.RU: User does not have a phone :o(
The user has no phone number
140
SAPE.RU: Billing in progress :o(
Billing is in process
141
SAPE.RU: Afterbilling aggregations building in progress :o(
There is a postbilling creation of aggregations
150
SAPE.RU: Bad subscribe type :o(
Invalid subscription type
151
SAPE.RU: Bad template id :o(
Invalid template ID
210
SAPE.RU: Anchor add failed :o(
Anchor is not added
211
SAPE.RU: Anchor delete failed :o(
Anchor is not removed
310
SAPE.RU: Project create failed :o(
Project is not created
311
SAPE.RU: Project bad name :o(
Invalid project's title
320
SAPE.RU: URL Add failed :o(
URL is not added
321
SAPE.RU: URL is banned :o(
URL is banned
322
SAPE.RU: Bad URL length :o(
Invalid URL length
323
SAPE.RU: URL is malformed :o(
Malformed URL
324
SAPE.RU: Bad URL domain :o(
Invalid URL domain
325
SAPE.RU: Url contains quote :o(
URL contains the quotation marks
330
SAPE.RU: Site add failed :o(
Site is not added
331
SAPE.RU: Bad url :o(
Invalid URL
332
SAPE.RU: Site already exists :o(
Site is already in the system
333
SAPE.RU: No code on front page :o(
There is no system code on the homepage
334
SAPE.RU: No code on page :o(
There is no system code on the page
335
SAPE.RU: No connection to site :o(
Server communication error
336
SAPE.RU: Site cannot be reindexed now :o(
The site recrawling is currently prohibited
337
SAPE.RU: Site is already bought out :o(
Site is already purchased
338
SAPE.RU: Site reindex is already started :o(
Task is in the queue or is being executed.
410
SAPE.RU: Placement create failed :o(
Link is not created
420
SAPE.RU: Placement delete failed :o(
Link is not removed
430
SAPE.RU: Placement update text failed :o(
Link text is not changed
432
SAPE.RU: Placement update price failed :o(
Link price is not changed
435
SAPE.RU: Placement update url failed :o(
Link URL is not changed
440
SAPE.RU: Placement accept SEO failed :o(
Link is not confirmed by the advertiser
450
SAPE.RU: Placement unsleep failed :o(
Link is not restored
460
SAPE.RU: Placement accept WM failed :o(
Link is not confirmed by the publisher
465
SAPE.RU: Placement new price accept failed :o(
Error of new prices confirmation
466
SAPE.RU: Placement new price reject failed :o(
Error of new prices rejection
470
SAPE.RU: Autofilter create failed, no texts on url
Autofilter is not created. There is no texts for URL
471
SAPE.RU: Autofilter create failed, already exist
Autofilter is not created. It already exists
500
SAPE.RU: Bad Project ID
Invalid project ID
501
SAPE.RU: Bad Site ID
Invalid site ID
502
SAPE.RU: Bad URL ID
Invalid URL ID
503
SAPE.RU: Bad Placement ID
Invalid link ID
504
SAPE.RU: Bad Placement Text
Invalid link text
505
SAPE.RU: Bad date in params
Invalid date format in the parameters
506
SAPE.RU: Bad Page ID
Invalid page ID
507
SAPE.RU: Bad Project ID - No URLs
Invalid project ID: there are no URLs
508
SAPE.RU: Bad category id
Invalid category ID
509
SAPE.RU: Bad filter id
Invalid filter ID
510
SAPE.RU: Bad whitelist id
Invalid section ID in favorites
511
SAPE.RU: Bad keyword
Invalid keyword
512
SAPE.RU: Bad stop-words list ID
Invalid ID of censored words list
513
SAPE.RU: Bad Project blacklist ID
Project blacklist is not created
514
SAPE.RU: Bad date interval
Invalid date range
515
SAPE.RU: Bad domain id
Invalid domain ID
521
SAPE.RU: Bad placement anchor ID
Invalid anchor ID
522
SAPE.RU: Empty placement anchor
Empty anchor
523
SAPE.RU: Malformed placement anchor
Incorrect anchor
524
SAPE.RU: Spammed placement anchor
Spammed anchor
525
SAPE.RU: Anchor too long
Anchor is too long
526
SAPE.RU: Anchor exist
Anchor already exists
650
SAPE.RU: Empty login :o(
Empty login
651
SAPE.RU: User is not activated :o(
User is not activated
652
SAPE.RU: Quantity of attempts of authentication for current IP is exceeded :o(
Number of the authorization attemps for the current IP is exhausted
653
SAPE.RU: Login does not exist :o(
User dos not exist
654
SAPE.RU: Invalid authorization cookie :o(
Invalid authorisation cookie
655
SAPE.RU: User is banned :o(
User is banned
656
SAPE.RU: User is blocked - need to change password :o(
User is blocked. Change the password
657
SAPE.RU: Invalid authorization ticket :o(
Invalid authorisation ticket
660
SAPE.RU: Access restricted for current IP :o(
Access from the current IP is forbidden
661
SAPE.RU: No partner contract :o(
There is no affiliate program's contract
662
SAPE.RU: No WM contract :o(
There is no publisher's contract
663
SAPE.RU: No SEO contract :o(
There is no advertiser's contract
664
SAPE.RU: Extended mode denied :o(
Access to the additional functions is closed
665
SAPE.RU: Not wizard account
This is not a Wizard account
666
SAPE.RU: Invalid login or password :o(
Invalid login or password
667
SAPE.RU: Please, login
Log in the system, please
668
SAPE.RU: Quantity of attempts of authentication is exceeded
Number of the authorization attempts is exhausted
669
SAPE.RU: TEMPORARY UNAVAILABLE
Temporarily is not available
670
SAPE.RU: Empty array!
Empty array
671
SAPE.RU: Input array empty!
Input data array is empty
672
SAPE.RU: Return array empty!
Output data array is empty
673
SAPE.RU: Search result empty!
Search returned the empty result
680
SAPE.RU: Request processing error!
Error during the request processing
681
SAPE.RU: Request already exist!
Request already exists
711
SAPE.RU: Bill amount too small :o(
Invoice amount is too small
800
SAPE.RU: Bad handle :o(
Invalid index
801
SAPE.RU: Get task status failed :o(
Status receiving error by the transfered index
802
SAPE.RU: Cannot get factor status :o(
It is impossible to receive the factor status
900
SAPE.RU: OAuth error :o(
"OAuth" error
1000
SAPE.RU: Elama error :o(
"Elama" error
1100
SAPE.RU: RT error :o(
"RT" error
1200
SAPE.RU: RTB error :o(
"RTB" error
1400
SAPE.RU: Wizard error :o(
"Wizard" error
1500
SAPE.RU: Archiving in PR failed :o(
Project archiving in PR failed
2101
SAPE.RU: Anchor add_failed, bad name :o(
Anchor is not added, invalid title
2201
SAPE.RU: Teaser upload failed, maximum allowed size for file 1.95MB :o(
The image file should be less than 1.95 MB
2202
SAPE.RU: Teaser upload failed, file must be jpg, gif or png :o(
The image file should be in jpg, gif or png format
2203
SAPE.RU: Teaser upload failed, file broken:o(
The image file is not readable
4101
SAPE.RU: Placement create failed, undefined page
Link is not created, page is not defined
4102
SAPE.RU: Placement create failed, big price
Link is not created, price is too high
4103
SAPE.RU: Placement create failed, undefined site
Link is not created, site is not defined
4104
SAPE.RU: Placement create failed, links limit reached
Link is not created, placement limit is reached
4105
SAPE.RU: Placement create failed, page is not active
Link is not created, page is not activated
4106
SAPE.RU: Placement create failed, site is not active
Link is not created, site is not activated
4107
SAPE.RU: Placement create failed, self link (anchor_url==site_url)
Link is not created, it is outbound
4108
SAPE.RU: Placement create failed, link already exists
Link is not created, this links already exists
4109
SAPE.RU: Placement create failed, IN WM BL
Link is not created, URL is in the publisher's blacklist
4110
SAPE.RU: Placement create failed, IN SEO BL
Link is not created, URL is in the advertiser's blacklist
4111
SAPE.RU: Placement create failed, text error
Link is not created, text error
4112
SAPE.RU: Placement create failed, not enough money for 2 days
Link is not created, not enough funds for 2 days placement
4113
SAPE.RU: Placement context create failed, anchor text error
Contextual link is not created, anchor text's error
4114
SAPE.RU: Placement context create failed, sql error
Contextual link is not created, SQL error
4116
SAPE.RU: Placement context create failed, no snippet
Contextual link is not created, there is no snippet
4117
SAPE.RU: Placement get good text failed, there are stop words
Text is not selected, there are censored words
4118
SAPE.RU: Placement get good text failed, there are russian chars
Text is not selected, there are Russian letters
4119
SAPE.RU: Placement get good text failed
Text is not selected
4120
SAPE.RU: Placement get good text failed, no active anchor texts
Text is not selected, there are no active texts
4510
SAPE.RU: URL unsleep failed :o(
URL is no restored
4511
SAPE.RU: URL unsleep failed, no money :o(
URL is no restored, not enough money
4512
SAPE.RU: URL unsleep failed, no links to unsleep :o(
URL is no restored, there are no links to be restored
6651
SAPE.RU: Not wizard user account
This account doesn't use Wizard
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/.
Authorization by password or md5 is prohibited. Use token, please (More info at: https://help.sape.ru/sape/faq/1685). You may generate token in your account: https://passport.sape.ru/security/token/
7000
SAPE.RU: Too deep :o(
Specify search conditions
7001
SAPE.RU: Too short word :o(
Too short word
7002
SAPE.RU: Quantity of calls to a method is exceeded
Number of the calls to the method is exhausted
7003
SAPE.RU: Search result is too big :o(
Too much data in SERP, specify search conditions
41021
SAPE.RU: Placement create failed, zero price
Link is not created, zero price
41031
SAPE.RU: Placement create failed, site is not saling
Link is not created, links selling is off on the site
41181
SAPE.RU: Placement get good text failed, there are not russian chars
Text is not selected, there are no Russian letters
41301
SAPE.RU: Placement create failed, undefined teaser page
Link is not created, teaser page is not defined
41302
SAPE.RU: Placement create failed, not enough traffic
Link is not created, not enough traffic on the page
41304
SAPE.RU: Placement create failed, not enough traffic on site
Link is not created, not enough traffic on the site
41305
SAPE.RU: Placement create failed, teaser blocks limit reached
Ссылка не создана, превышен лимит тизерных блоков