PR.SAPE.RU XML-RPC

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

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



Описания существующих функций

  • integer sape_pr.login(string $login, string $token)
    Авторизация в системе; необходимо вызывать в начале каждой сессии. Далее при каждом следующем запросе нужно передавать все вернувшиеся cookie.
    Возвращает ID пользователя.
    Описания параметров:
  • array sape_pr.project.index(struct $filter = [])
    Список проектов пользователя.
    Каждый элемент содержит:
    • id => (integer) ID проекта
    • name => (string) название вместе с типом
    • type => (integer) код типа
    • is_seo_checking => (boolean) проверяются ли заявки оптимизатором
    • is_archived => (boolean) находится ли в архиве
    • created_at => (string) дата создания в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
    • categories_names => (array) массив названий тематик
    • is_wizard => (boolean) создан ли через систему Wizard.Sape (самостоятельные операции запрещены)
    Типы проектов:
    • 1 - обычный
    • 2 - беззаботный
    • 3 - wizard (создан через систему Wizard.Sape)
    • 4 - lite
    • 5 - sape (PR-отражение проекта из Sape)
    • 6 - как у конкурентов

    Описания параметров:
    • struct $filter - Необязательный массив фильтров; может включать в себя:
      • id => (integer) ID проекта
      • is_archived => (boolean) находится ли в архиве
      • is_wizard => (boolean) создан ли через систему Wizard.Sape
  • integer sape_pr.project.create(string $name, struct $params = [])
    Добавление проекта.
    Описание возможных настроек проекта: project.update (название проекта - "name" - задаётся явно первым аргументом).
    Описания параметров:
    • string $name - Название проекта
    • struct $params - Необязательный массив настроек проекта
  • void sape_pr.project.update(integer $id, struct $params = [])
    Изменение настроек проекта.

    Описания параметров:
    • integer $id - ID проекта
    • struct $params - Массив настроек:
      • auto_approve_min_index - автоматически принимать заявки, минуя статус проверки размещения, если %И площадки равен или превышает заданное значение (0 - отключить автопринятие; умолчание для нового проекта - 0)
      • check_index_mode - требование по индексации (умолчание для нового проекта - 3)
      • noindex_action - действие при неиндексации (умолчание для нового проекта - 0)
      • do_autobuy_twitt - автоматически тратить 10% от стоимости ссылок на ускорение индексации заявок (умолчание для нового проекта - 0)
      • is_auto_favorites - автоматически принимать, если сайт в избранном (умолчание для нового проекта - 0)
      • is_auto_indexed - автоматически принимать, если заявка проиндексирована (умолчание для нового проекта - 0)
      • is_auto_premoderation - автоматически подтверждать создание авторежимных заявок спустя 7 дней (умолчание для нового проекта - 1)
      • name - название
      • categories_ids - ID одной тематики (в будущем можно будет задать массив из нескольких тематик); список возможных тематик: site.yacacats_tree
      Виды требований по индексации:
      • 0 - индексация не требуется
      • 1 - индексация в Яндексе
      • 2 - индексация в Google
      • 3 - индексация в Яндексе или Google
      Виды действий при неиндексации:
      • 0 - ничего не делать
      • 1 - пересоздать заявку на схожей площадке
      • 2 - пересоздать заявку, требующую подтверждения, на схожей площадке
      • 3 - отменить заявку с возвратом средств
  • void sape_pr.project.set_is_archive(integer $id, boolean $is_archived)
    Установка флага "архивности" проекта.
  • array sape_pr.project.adverts(struct $filter = [], integer $page = 1, integer $per_page = 500)
    Список заявок для проектов.
    Текст заявки можно получить методом advert.get_content.
    Каждый элемент содержит:
    • id
    • type - тип заявки
    • project_id - ID проекта
    • status - статус заявки
    • error - статус ошибки
    • wait_days - кол-во дней для размещения заявки вебмастером
    • in_yaca - площадка с данной заявкой есть в Яндекс.Каталог
    • in_dmoz - площадка с данной заявкой есть в DMOZ
    • in_yandex - площадка с данной заявкой есть в Яндекс.Новости
    • in_google - площадка с данной заявкой есть в Google News
    • in_novoteka - площадка с данной заявкой есть в Novoteka
    • in_rambler - площадка с данной заявкой есть в Рамблер-Новости
    • links - ссылки из заявки
    • price - стоимость
    • credit_period - длительность рассрочки
    • credit_status - статус рассрочки
    • site_url - URL площадки, на которой размещена заявка
    • placement_url - адрес размещения
    • cy - тИЦ площадки
    • pr - PR площадки
    • is_placement_guarantied - гарантия размещения вебмастером
    • is_placement_unique - признак уникальности текста размещённого материала
    • is_indexed - статус индексации
    • wait_index_days_left - количество дней до возможности отмены утверждённой заявки в случае, когда заявка ожидает индексации. В других случаях - null. Если число отрицательное, заявка может быть отменена в любой момент.
    • date_billing - дата списания средств
    • created_at - дата-время создания
    • updated_at - дата-время последнего какого-либо обновления
    • placed_at - дата-время размещения
    • status_at - дата-время установки последнего статуса
    • keywords - ключевые слова
    • description - примечание к заявке
    • version - версия примечания к заявке
    • title - заголовок (добавляется, если тип заявки - статья)
    • author - автор (добавляется, если тип заявки - статья)
    • insured_id - ID исходной заявки, на основе которой была создана новая по гарантии от снятия
    • noindex_id - ID исходной заявки, на основе которой была создана новая из-за неиндексации исходной

    Типы:
    • link - ссылка в новости
    • news - статья
    • archive - ссылка в архиве
    • review - обзор

    Статусы:
    • 4 - проверка модератором
    • 7 - на уточнении SEO
    • 5 - на размещении
    • 11 - проверка размещения
    • 12 - на доработке WM
    • 13 - требует подтверждения
    • 20 - размещена
    • 21 - отклонена вебмастером
    • 22 - отменена оптимизатором
    • 23 - отклонена модератором
    • 25 - определена к снятию
    • 26 - снята
    • 27 - отклонена роботом
    • 28 - отклонена роботом (WM)
    • 29 - отклонена роботом (SEO)

    Статусы рассрочки:
    • 1 - выплаты еще не начаты
    • 2 - идет выплата
    • 3 - идет выплата (списывается резерв)
    • 5 - выплаты приостановлены
    • 6 - недостаточно средств
    • 10 - выплаты завершены
    • 20 - выплаты прекращены из-за ошибки размещения

    Статусы ошибок:
    • 0 - без ошибок (ссылка найдена)
    • 1 - сервер недоступен
    • 2 - страница запрещена для индексирования в robots.txt
    • 3 - страница запрещена для индексирования в мета-тегах
    • 4 - некорректный URL
    • 5 - запрос перенаправляется на другую страницу
    • 7 - на странице используется rel="canonical" и адрес ссылки в теге не совпадает с адресом размещения в системе
    • 10 - ссылка не найдена
    • 11 - ссылка находится в <noindex>
    • 12 - текст ссылки отличается
    • 13 - в качестве текста ссылки написали "любой анкор"
    • 14 - текст ссылки содержит запрещённые слова
    • 15 - ошибка в кодировке страницы
    • 16 - ошибка в разметке страницы
    • 17 - получена пустая страница
    • 30 - проверка не завершилась
    • 40 - нельзя размещать ссылку на другом сайте
    • 41 - на этой странице уже есть размещенный материал

    Описания параметров:
    • struct $filter - Необязательные фильтры выборки:
      • advert_ids - массив ID заявок (иначе выбираются все заявки согласно остальным условиям выборки)
      • created_at_start - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', начиная с которой была создана заявка
      • created_at_stop - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', до которой (включительно) была создана заявка
      • updated_at_start - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', начиная с которой заявка была обновлена
      • updated_at_stop - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', до которой (включительно) заявка была обновлена
      • only_insurance_applied - признак, возвращать ли данные только по пересозданным заявкам по гарантии от снятия
      • only_noindex_recreated - признак, возвращать ли данные только по заявкам, пересозданным из-за неиндексации
      • only_recreated - объединение признаков "only_insurance_applied" и "only_noindex_recreated"
      • project_ids - массив ID проектов (иначе выбираются заявки из всех проектов пользователя)
      • status_codes - массив кодов статусов (иначе выборка по всем статусам заявки)
      • status_date_start - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', начиная с которой был установлен текущий статус заявки
      • status_date_stop - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', до которой (включительно) был установлен текущий статус заявки
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • array sape_pr.project.twadverts(struct $filter = [], integer $page = 1, integer $per_page = 500)
    Список твит-заявок в проекте.
    Каждый элемент содержит:
    • id
    • project_id - ID проекта
    • status - статус заявки
    • tw_account_id - ID твит-аккаунта
    • price - стоимость
    • text - текст в теле твита
    • url - ссылка в теле твита
    • placement_url - адрес размещения
    • status_at - время смены статуса
    • placed_at - время размещения
    • created_at - время создания
    • is_paid - оплачена/не оплачена

    Статусы:
    • 1 - На размещении
    • 20 - Отправлена WM
    • 30 - В работе
    • 40 - Проверка размещения
    • 45 - Одобрена
    • 50 - Отменена WM
    • 51 - Отменена SEO
    • 52 - Отменена модератором
    • 53 - Отменена роботом

    Описания параметров:
    • struct $filter - Необязательные фильтры выборки:
      • advert_ids - массив ID твит-заявок (иначе выбираются все заявки согласно остальным условиям выборки)
      • project_ids - массив ID проектов (иначе выбираются заявки из всех проектов пользователя)
      • account_ids - массив ID твит-аккаунтов
      • status_codes - массив кодов статусов (иначе выборка по всем статусам заявки)
      • status_at_start - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', начиная с которой был установлен текущий статус заявки
      • status_at_stop - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', до которой (включительно) был установлен текущий статус заявки
      • created_at_start - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', начиная с которой была создана заявка
      • created_at_stop - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', до которой (включительно) была создана заявка
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • array sape_pr.project.social(struct $filter = [], integer $page = 1, integer $per_page = 500)
    Список заявок в социальных сетях для проектов.
    Каждый элемент содержит:
    (для type == 2):
    • id - ID социальной заявки
    • project_id - ID проекта
    • type - код типа
    • sn - код соц. сети
    • url - урл задания
    • nb_likes - кол-во лайков/постов/пользователей
    • nb_likes_current - кол-во на данный момент
    • price - стоимость за единицу
    • status - код статуса
    • daily_limit - лимит в день
    • text - текст задания
    • min_age
    • max_age
    • gender
    • marital_status
    • country
    • city
    • min_friends_count
    • max_friends_count
    • created_at - дата-время создания заявки
    • updated_at - дата-время обновления заявки
    • likes_data - массив данных о выполненных размещениях; каждый элемент содержит:
      • id - уникальный (в пределах социальной заявки) строковый ID выполнения лайка
      • pr_id - ID выполнения в нашей системе
      • url_location - URL страницы аккаунта
      • url_post - URL страницы размещения поста
      • posted_at - время размещения поста в формате UNIX timestamp
      • is_billed - признак, оплачено ли данное размещение
    (для type == 4):
    • id - ID социальной заявки
    • project_id - ID проекта
    • type - код типа
    • sn - код типа размещения
    • url - урл задания
    • nb_likes - кол-во лайков/постов/пользователей
    • nb_likes_current - кол-во на данный момент
    • price - стоимость за единицу
    • status - код статуса
    • daily_limit - лимит в день
    • is_concrete_url - признак, требовать ли от исполнителя строгого размещения заданного в заявке URL-а; иначе исполнитель размещает любой URL, найденный в домене, вырезанном из заданного оптимизатором URL-а
    • created_at - дата-время создания заявки
    • updated_at - дата-время обновления заявки
    • likes_data - массив данных о выполненных размещениях; каждый элемент содержит:
      • id - уникальный (в пределах социальной заявки) строковый ID выполнения лайка
      • pr_id - ID выполнения в нашей системе
      • url_post - URL страницы размещения
      • posted_at - время размещения в формате UNIX timestamp
      • is_billed - признак, оплачено ли данное размещение

    Коды типов социальных заявок:
    • 2 - Share / Ссылка на стене
    • 4 - Crowd / Ссылка из обсуждения

    Коды типов размещений:
    (для type == 2):
    • 1 - ВКонтакте
    • 2 - Facebook
    • 3 - Google+
    • 4 - Мой Мир
    (для type == 4):
    • 5 - любое
    • 6 - Ответы@Mail.Ru
    • 7 - форумы и комментарии к блогам

    Коды статусов:
    • 1 - создается
    • 2 - активна
    • 3 - останавливается
    • 10 - завершена
    • 11 - отменена
    • 100 - отменена из-за ошибки

    Описания параметров:
    • struct $filter - Необязательные фильтры выборки:
      • order_ids - массив ID заявок (иначе выбираются все заявки согласно остальным условиям выборки)
      • status_codes - массив кодов статусов (иначе выборка по всем статусам заявок)
      • types - массив кодов типов (иначе выборка по всем доступным типам заявок)
      • created_at_start - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', начиная с которой была создана социальная заявка
      • created_at_stop - дата в формате 'ГГГГ-ММ-ДД ЧЧ:ММ:СС', до которой (включительно) была создана социальная заявка
      • project_ids - массив ID проектов (иначе выбираются заявки из всех проектов пользователя)
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • struct sape_pr.project.finance_stats(string $period_group = "month", string $date_start = null, string $date_stop = null, array $projects_ids = [])
    Возвращает финансовые данные по проектам.
    Каждый элемент под соответствующим ключом (ID проекта) содержит подмассив с ключами - периодами:
    • period_date - период
    • sum_accepted - стоимость одобренных заявок
    • sum_billed - сумма фактически списанных в периоде средств по проектам
    • sum_billed_accepted - сумма фактически списанных средств по одобренным в периоде заявкам
    • sum_index_wait - стоимость одобренных заявок, которые ждут индексации
    • sum_potential - сумма ещё не списанных средств по одобренным в периоде заявкам
    • rejects - массив сумм возвращённых (не списанных) средств по видам отмен заявок:
      • sum_reject_index - заявки, отменённые из-за неиндексации
      • sum_reject_error - заявки, отменённые из-за ошибки размещения
      • sum_reject_sleep - заявки, отменённые по причине отсутствия средств у оптимизатора
      • sum_reject_moder - заявки, отменённые модератором

    Описания параметров:
    • string $period_group - разбиение на периоды по дням 'day' или месяцам 'month'
    • string $date_start - с какой даты 'ГГГГ-ММ-ДД' собирать данные (null - певое число текущего месяца)
    • string $date_stop - до какой даты 'ГГГГ-ММ-ДД' собирать данные (null - текущая дата)
    • array $projects_ids - ID проектов (массив не задан - все проекты)
  • array sape_pr.project.import_anchors(integer $project_id, array $anchors)
    Импортирует анкоры для проекта.
    Возвращает тот же массив $anchors, но с добавленными id:
    • url_id - ID URL-а
    • anchor_id - ID анкора
    • url - URL анкора
    • text - текст анкора

    Описания параметров:
    • integer $project_id - ID проекта
    • array $anchors - Массив импортируемых анкоров; каждый элемент должен содержать:
      • url - URL анкора
      • text - текст анкора
  • array sape_pr.site.average_prices(struct $filter = [])
    Средние цены для площадок.
    Функция возвращает массив, каждый элемент которого содержит:
    • cy_min - нижняя граница значения тИЦ (включительно)
    • cy_max - верхняя граница значения тИЦ (исключительно)
    • format - формат размещения
    • price - средняя цена для данной комбинации тИЦ/формата
    • site_ids - если задан входной фильтр site_ids, этот элемент будет содержать массив id площадок, соответствующих данному интервалу.

    Форматы размещения заявок:
    • link - ссылка в новости
    • news - статья
    • archive - ссылка в архиве
    • review - обзор

    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • cy - значение тИЦ (работает совместно с format)
      • format - формат размещения (работает совместно с cy)
      • site_ids - массив ID площадок (действует независимо от cy и format)
  • array sape_pr.site.blog_types()
    Список блогплатформ.
    Функция возвращает массив, ключи которого - ID блогплатформ, а значения - их названия.
  • array sape_pr.site.categories(array $categories_ids = [])
    Список тематик.
    Функция возвращает массив:
    • ID тематики => название тематики

    Описания параметров:
    • array $categories_ids - - необязательный массив ID тематик (пустой массив - возвращаются все тематики).
  • array sape_pr.site.regions(integer $parent_id = null)
    Список регионов.
    Функция возвращает массив, ключи которого - ID регионов, а значения - массивы:
    • parent_id - ID региона, которому принадлежит данный
    • name - название региона

    Описания параметров:
    • integer $parent_id - Вернуть список регионов, принадлежащих заданному
  • array sape_pr.site.yacacats_tree()
    Двухуровневое дерево тематик Яндекс.Каталога.
    Представлено массивом с ключами - ID тематик верхнего уровня и значениями:
    • item - информация о тематике:
      • id - ID тематики
      • parent_id - ID родительской тематики
      • name - название тематики
    • subitmes - массив данных по подтематикам (каждый элемент по структуре аналогичен структуре 'item')
    Внимание! Только при поиске/фильтрации можно задавать общие тематики верхнего уровня (item => parent_id == 0), если под ними имеются подтематики (непустой элемент item => subitems). Иначе, если требуется задать конкретные тематики для какой-либо сущности, подобные общие тематики указывать нельзя (будет возвращена ошибка, сообщающая, что задана некорректная тематика).
  • integer sape_pr.site.request_create(struct $parameters)
    Создаёт запрос на добавление новой площадки. В случае успеха возвращает ID запроса.
    Описания параметров:
    • struct $parameters - Параметры запроса:
      Обязательные:
      • categories_list - массив ID тематик (от одной до трёх)
      • placement_section_path - мультистрокове описание путей до разделов размещения (пример пути: Главная → Архив статей → Выбираем год и месяц → Заявка)
      • url - URL площадки
      Необязательные:
      • description - описание площадки
      • price_link - цены ссылки в новости
      • price_news - цена статьи
      • price_archive - цена ссылки в архиве
      • price_review - цена обзора
  • array sape_pr.site.request_get(struct $filter = [], integer $page = 1, integer $per_page = 500)
    Возвращает данные по запросу на добавление площадки:
    • id - ID запроса
    • url - URL площадки
    • status - код статуса запроса
    • description - описание площадки
    • created_at - дата создания запроса в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
    • updated_at - дата изменения запроса в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
    • price_link - цена заявки для формата "ссылка в новости"
    • price_news - цена заявки для формата "статья"
    • price_archive - цена заявки для формата "ссылка в архив"
    • price_review - цена заявки для формата "обзор"
    • reject_reason - причина отказа
    • site_id - ID площадки (если запрос был одобрен)
    • placement_section_path - пути до разделов размещения

    Возможные коды статусов:
    • 2 - недостаточный тИЦ
    • 3 - ожидает проверки кода
    • 4 - ожидает проверки модератором
    • 10 - присутствует в Sape
    • 20 - одобрен
    • 21 - отклонен модератором
    • 22 - отклонён из-за низкой индексации Яндексом

    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • created_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой были добавлены запросы
      • created_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) были добавлены запросы
      • ids - список ID запросов
      • status_codes - список кодов статусов
      • updated_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой запросы были обновлены
      • updated_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) запросы были обновлены
      • url - URL площадки
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • array sape_pr.site.search(string $type, struct $filter, integer $page, integer $per_page)
    Поиск площадок.
    Для каждого сайта будет возвращен массив со следующими параметрами:
    • id - ID сайта
    • url - url сайта
    • price - стоимость выбранного формата размещения
    • price_by_type - стоимости всех возможных форматов размещений:
      • link - стоимость размещения ссылки в новости
      • news - стоимость размещения cтатьи
      • archive - стоимость размещения ссылки в архиве
      • review - стоимость размещения обзора
    • cy - тИЦ
    • pr - PR
    • date_whois - whois площадки
    • pr - PR
    • in_yaca - находится в Я.Каталоге
    • in_dmoz - находится в DMOZ
    • ag_yandex - есть в Яндекс.Новостях
    • ag_google - есть в Google.Новостях
    • ag_novoteka - есть в Новотеке
    • ag_rambler - есть в Рамблер-Новости
    • advert_indexed_percent - процент индексации заявок
    • avg_placement_time - среднее время размещения заявки в днях
    • placement_uniqueness - уникальность размещений
    • placement_probability - процент размещения
    • days_to_index - средняя скорость индексации в днях
    • nof_pages_in_yandex - количество страниц, проиндексированных в Яндексе
    • nof_pages_in_google - количество страниц, проиндексированных в Google
    • yaca_categories - массив ID категорий Я.Каталога
    • categories_ids - массив ID тематик площадки
    • regions_ids - массив ID регионов площадки
    • is_mos - площадка принимает МОС-заявки
    • is_new - новая площадка
    • is_sape_links - площадка торгует ссылками в Sape
    • is_credit_available - принимается оплата в рассрочку
    • is_placement_outside_only - размещает ссылки только вне текста новости

    Описания параметров:
    • string $type - Формат размещения (link|news|archive|review)
    • struct $filter - Необязательный массив фильтров:
      • advert_indexed_percent_from - минимальный процент индексации заявок
      • advert_indexed_percent_to - максимальный процент индексации заявок
      • include_undefined - при заданном advert_indexed_percent_* включать в поиск площадки с неопределённым %И
      • avg_placement_time_from - минимальное среднее время размещения по заданному формату в днях
      • avg_placement_time_to - максимальное среднее время размещения по заданному формату в днях
      • id - ID площадки или массив ID площадок
      • price_from - цена от
      • price_to - цена до
      • cy_from - тИЦ от
      • cy_to - тИЦ до
      • placement_probability_from - минимальный процент размещения
      • placement_probability_to - максимальный процент размещения
      • pr_from - PR от
      • pr_to - PR до
      • whois_from - возраст площадки в днях (от)
      • whois_to - возраст площадки в днях (до)
      • in_yaca - находится в Я.Каталоге (0 - нет, 1 - да, 2 или не задано - не важно)
      • in_dmoz - есть в DMOZ (0 - нет, 1 - да, 2 или не задано - не важно)
      • ag_yandex - есть в Яндекс.Новостях
      • ag_google - есть в Google.Новостях
      • ag_novoteka - есть в Новотеке
      • cat_ag_filter_or - требовать наличия хотя бы в одном из указанных каталогов (in_*) или агрегаторов (ag_*)
      • is_credit_available - есть ли возможность покупать заявки в рассрочку (0 - нет, 1 - да, 2 или не задано - не важно)
      • is_placement_outside_only - размещение ссылок только вне текста (0 - нет, 1 - да, 2 или не задано - не важно)
      • is_non_thematic_advert - площадки принимают нетематические ссылки (0 - нет, 1 - да, 2 или не задано - не важно); только для форматов размещения 'link' и 'archive'
      • is_non_thematic_article - площадки принимают нетематические статьи или обзоры (0 - нет, 1 - да, 2 или не задано - не важно); только для форматов размещения 'news' и 'review'
      • project_id - ID проекта для фильтрации площадок по размещённым/отклонённым ссылкам, для учёта чёрного списка площадок у проекта и для исключения площадки, чей ID домена совпадает с ID домена проекта (если последний задан)
      • hide_inaction - {true|false} (требуется project_id) скрывать площадки с размещенными ссылками в рамках проекта
      • hide_rejected - {true|false} (требуется project_id) скрывать площадки с отклонёнными ссылками в рамках проекта
      • exclude_blogs - исключить площадки-блоги
      • include_only_blogs - искать только площадки блоги (игнорирует условие "exclude_blogs")
      • exclude_placed_other_sections - {true|false} (требуется "project_id") скрывать площадки с размещёнными заявками в рамках других проектов того же раздела
      • whitelists_ids - искать площадки присутствующие в указанных списках избранного
      • show_new - искать только среди новых сайтов
      • categories_ids - массив с ID тематик (см. список тематик) для поиска площадок, относящихся хотя бы к одной из этих тематик
      • regions_ids - массив с ID регионов (см. список регионов) для поиска площадок, относящихся хотя бы к одному из этих регионов
      • blog_types_ids - массив с ID блогплатформ (см. список блогплатформ) для поиска площадок, относящихся хотя бы к одной из этих блогплатформ
      • yacacats_ids - массив с ID тематик Яндекс.Каталога (см. дерево категорий Яндекс.Каталога) для поиска площадок, относящихся хотя бы к одной из этих категорий
      • no_sape_links - искать только те площадки, которые не торгуют ссылками в Sape (0 - нет, 1 - да, 2 или не задано - не важно)
      • is_mos - площадка принимает МОС-заявки
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (5000 max)
  • array sape_pr.site.ownlist(array $ids = [], struct $params = [], integer $page = 1, integer $per_page = 1000)
    Получить данные по собственным площадкам.
    По каждой площадке будет возвращён массив со следующими данными:
    • id - ID площадки
    • url - адрес площадки
    • is_active - true, если площадка активна
    • inactive_reason - причина деактивации
    • is_disabled - true, если площадка не принимает новые заявки
    • disabled_reason - причина, по которой площадка автоматически перестала принимать новые заявки
    • is_archive - true, если площадка архивирована
    • placement_propability - вероятность размещения
    • indexation_percent - процент индексации
    • uniqueness_percent - процент уникальности
    • days_to_index - средняя скорость индексации в днях
    • average_placement_times - массив со средними временами размещения (в часах) по форматам размещения заявок
    • advert_type_prices - массив с ценами на форматы размещения заявок
    • nofs_statuses - массив, каждый элемент которого содержит ключ - код статуса и значение - количество заявок в этом статусе
    • nofs_errors - массив, каждый элемент которого содержит ключ - код ошибки и значение - количество заявок с этой ошибкой
    • nofs_waiting_index - количетсво заявок, ожидающих индексации
    • created_at - дата создания площадки в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
    • nof_visitors - посещаемость
    • categories_ids - массив ID тематик площадки (полный список возможных значений)
    • regions_ids - список ID регионов площадок (полный список возможных значений)
    • is_ags - true, если площадка находится под АГС--

    Форматы размещения заявок:
    • link - ссылка в новости
    • news - статья
    • archive - ссылка в архиве
    • review - обзор

    Описания параметров:
    • array $ids - массив ID площадок (если не указать, выбираются все площадки)
    • struct $params - Необязательный массив параметров:
      • categories_ids - искать только площадки, среди тематик которых значится хотя бы одна из данного массива ID тематик (полный список возможных значений)
      • created_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой были созданы площадки
      • created_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) были созданы площадки
      • updated_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой площадки были обновлены
      • updated_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) площадки были обновлены
      • is_active - флаг: искать только активные (true) или только неактивные (false) площадки (со стороны системы)
      • is_ags - флаг: искать только площадки под АГС-- (true) или только площадки не под АГС-- (false)
      • is_archive - флаг: искать только архивированные (true) или только неархивированные площадки (false)
      • is_disabled - флаг: искать только скрытые (true) или только участвующие (false) в поиске площадки (со стороны вебмастера)
      • nofs_statuses - массив кодов статусов, по каждому из которых подсчитывать количество заявок
      • nofs_errors - массив кодов ошибок, по каждому из которых подсчитывать количество заявок
      • show_nofs_waiting_index - признак, показывать ли количество заявок, ожидающих индексации
      • show_no_price_TYPE - признаки фильтрации площадок, у которых не задана или указана неактивной цена формата размещения заявки "TYPE"
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (1000 max)
  • void sape_pr.site.update(integer $id, struct $params)
    Обновить параметры площадки.
    Описания параметров:
    • integer $id - ID площадки
    • struct $params - Параметры для обновления:
      • price_link: Цена за размещение ссылки
      • price_news: Цена за размещение статьи
      • price_archive: Цена за размещение ссылки в архиве
      • price_review: Цена за размещение за размещения обзора
      • contact: Контактная информация
      • placement_example: Примеры размещения
      • is_credit_available: Включить покупку в рассрочку (см. http://help.sape.ru/pr/faq/1206)
      • is_disabled: Не принимать новые заявки
      • is_placement_outside_only: Размещение ссылок только ВНЕ текста новости
      • is_non_thematic_advert: Принимаю нетематические ссылки
      • is_non_thematic_article: Принимаю нетематические статьи и пишу нетематические обзоры
      • is_changeable_url: Разрешено менять URL
      • is_changeable_anchor: Разрешено менять анкор
      • words_stop_list: Стоп-лист
      • is_stop_unprintable_words: Фильтровать нецензурные слова
      • is_stop_adult_words: Фильтровать adult-слова
      • description: Описание
  • array sape_pr.site.adverts(struct $filter = [], integer $page = 1, integer $per_page = 500, boolean $is_guest = false)
    Список заявок для площадок.
    Текст заявки можно получить методом advert.get_content.
    Каждый элемент содержит:
    • id
    • type - тип
    • site_id - ID площадки
    • site_url - домен площадки
    • status - статус
    • links - ссылки из заявки, где каждый элемент - подмассив:
      • id - ID ссылки
      • href - URL ссылки
      • text - анкор ссылки
      • anchor_id - ID анкора
      • anchor_parent_id - ID родительского анкора или null
      • steroid_alteration_id - ID стероида изменения ссылок или null; задан, если ссылка была создана благодаря данному стероиду
      • is_disabled_pending - признак, помечена ли ссылка к деактивации (удалению из задания)
      • href_encoded - кодированный URL
      • href_utf8 - URL, конвертированный из win1251 в utf8
    • links_new_drafts - черновики новых ссылок, предложенных на замену "links" в рамках платной услуги "изменение ссылок"; если черновиков нет, содержит пустой массив; структура аналогична структуре "links"
    • price - стоимость (NULL, если нет прав на просмотр финансовых данных площадки)
    • billed - сумма уже выплаченных средств (NULL, если нет прав на просмотр финансовых данных площадки)
    • credit_period - длительность рассрочки
    • credit_status - статус рассрочки
    • placement_url - адрес размещения
    • placement_in_text - признак размещения ссылки в тексте материала
    • placement_out_text - признак размещения ссылки вне текста материала
    • is_placement_guarantied - гарантия размещения вебмастером
    • is_placement_unique - признак уникальности текста размещённого материала
    • is_indexed - статус индексации (null, если статус неизвестен)
    • is_seo_rework_possible - можно ли отправить заявку на доработку оптимизатору
    • wait_index_days_left - количество дней до отмены утверждённой заявки в случае, когда заявка ожидает индексации. В других случаях - null. Если число отрицательное, заявка может быть отменена в любой момент.
    • date_billing - дата зачисления средств
    • error - статус ошибки
    • wait_days - кол-во дней для размещения заявки вебмастером
    • created_at - дата-время создания
    • updated_at - дата-время последнего какого-либо обновления
    • placed_at - дата-время размещения
    • status_at - дата-время последнего статуса
    • description - примечание к заявке
    • keywords - ключевые слова
    • version - версия текста
    • title - заголовок (добавляется, если тип заявки - статья)
    • author - автор (добавляется, если тип заявки - статья)
    • is_mos - МОС-заявка

    Типы:
    • link - ссылка в новости
    • news - статья
    • archive - ссылка в архиве
    • review - обзор

    Статусы заявки:
    • 5 - на размещении
    • 7 - на уточнении SEO
    • 11 - проверка размещения
    • 12 - на доработке WM
    • 20 - размещена
    • 21 - отклонена вебмастером
    • 22 - отменена оптимизатором
    • 23 - отклонена модератором
    • 24 - отклонена стоп-листом
    • 25 - определена к снятию
    • 26 - снята
    • 27 - отклонена роботом
    • 28 - отклонена роботом (WM)
    • 29 - отклонена роботом (SEO)

    Статусы рассрочки:
    • 1 - выплаты еще не начаты
    • 2 - идет выплата
    • 3 - идет выплата (списывается резерв)
    • 5 - выплаты приостановлены
    • 6 - недостаточно средств
    • 10 - выплаты завершены
    • 20 - выплаты прекращены из-за ошибки размещения

    Статусы ошибок:
    • 0 - без ошибок (ссылка найдена)
    • 1 - сервер недоступен
    • 2 - страница запрещена для индексирования в robots.txt
    • 3 - страница запрещена для индексирования в мета-тегах
    • 4 - некорректный URL
    • 5 - запрос перенаправляется на другую страницу
    • 7 - на странице используется rel="canonical" и адрес ссылки в теге не совпадает с адресом размещения в системе
    • 10 - ссылка не найдена
    • 11 - ссылка находится в <noindex>
    • 12 - текст ссылки отличается
    • 13 - в качестве текста ссылки написали "любой анкор"
    • 14 - текст ссылки содержит запрещённые слова
    • 15 - ошибка в кодировке страницы
    • 16 - ошибка в разметке страницы
    • 17 - получена пустая страница
    • 30 - проверка не завершилась
    • 40 - нельзя размещать ссылку на другом сайте
    • 41 - на этой странице уже есть размещенный материал

    Описания параметров:
    • struct $filter - Массив необязательных фильтров:
      • accepted_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой заявки были одобрены к оплате (в т. ч. проиндексированы)
      • accepted_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) заявки были одобрены к оплате (в т. ч. проиндексированы)
      • advert_ids - массив ID заявок (иначе выбираются все заявки согласно остальным условиям выборки)
      • billed_at_start - дата в формате "ГГГГ-ММ-ДД", начиная с которой заявки были (будут) оплачены
      • billed_at_stop - дата в формате "ГГГГ-ММ-ДД", до которой (включительно) заявки были (будут) оплачены
      • created_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой были созданы заявки
      • created_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) были созданы заявки
      • error_codes - массив кодов ошибок (иначе выборка по всем ошибкам заявки)
      • only_links_alteration - признак, искать ли только заявки, по которым есть новые заказы на изменение ссылок
      • only_wait_index - признак, искать ли только заявки, ждущие индексации
      • site_ids - массив ID площадок (иначе выбираются заявки из всех площадок пользователя)
      • status_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой у заявок менялся статус
      • status_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) у заявок менялся статус
      • status_codes - массив кодов статусов (иначе выборка по всем статусам заявки)
      • types - массив типов заявок (иначе выборка по всем типам)
      • updated_at_start - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", начиная с которой заявки были обновлены
      • updated_at_stop - дата в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС", до которой (включительно) заявки были обновлены
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
    • boolean $is_guest - Искать по гостевым площадкам (false - собственным)
  • struct sape_pr.site.finance_stats(string $period_group = "month", string $date_start = null, string $date_stop = null, array $sites_ids = [])
    Возвращает финансовые данные по площадкам.
    Каждый элемент под соответствующим ключом (ID площадки) содержит подмассив с ключами - периодами:
    • period_date - период
    • sum_accepted - стоимость одобренных заявок
    • sum_billed - сумма фактически зачисленных в периоде средств по площадкам
    • sum_billed_accepted - сумма фактически зачисленных средств по одобренным в периоде заявкам
    • sum_index_wait - стоимость одобренных заявок, которые ждут индексации
    • sum_potential - сумма ещё не зачисленных средств по одобренным в периоде заявкам
    • rejects - массив сумм возвращённых (не зачисленных) средств по видам отмен заявок:
      • sum_reject_index - заявки, отменённые из-за неиндексации
      • sum_reject_error - заявки, отменённые из-за ошибки размещения
      • sum_reject_sleep - заявки, отменённые по причине отсутствия средств у оптимизатора
      • sum_reject_moder - заявки, отменённые модератором

    Описания параметров:
    • string $period_group - Разбиение на периоды по дням 'day' или месяцам 'month'
    • string $date_start - С какой даты 'ГГГГ-ММ-ДД' собирать данные (null - певое число текущего месяца)
    • string $date_stop - До какой даты 'ГГГГ-ММ-ДД' собирать данные (null - текущая дата)
    • array $sites_ids - ID площадок (пустой массив - все площадки)
  • array sape_pr.site.get_favorites(array $filter = [])
    Возвращает избранные площадки в виде массива, в котором ключами являются ID площадок, а значениями - URL площадок.
    Описания параметров:
    • array $filter - Фильтр по массиву ID или URL площадок в стандартном формате, punycode или киррилице
  • void sape_pr.site.add_favorites(array $urls_or_ids)
    Добавляет площадки в избранное.
    Описания параметров:
    • array $urls_or_ids - Массив ID или URL площадок в стандартном формате, punycode или киррилице
  • void sape_pr.site.remove_favorites(array $urls_or_ids)
    Удаляет площадки из избранного.
    Описания параметров:
    • array $urls_or_ids - Массив ID или URL площадок в стандартном формате, punycode или киррилице
  • void sape_pr.site.remove_favorites_all()
    Удаляет из избранного все площадки.
  • string sape_pr.advert.create(string $type, integer $project_id, integer $site_id, struct $params)
    Создание заявки.
    Описания параметров:
    • string $type - Формат размещения (link|news|archive|review)
    • integer $project_id - ID проекта
    • integer $site_id - ID площадки
    • struct $params - Параметры создания заявки:
      • wait_days - период ожидания (дней)
      • max_price - максимальная цена покупки
      • credit_period - период рассрочки 90 или 180 дней. Для создания заявок с разовой оплатой (не в рассрочку) - параметр credit_period указывать не нужно
      • instant_if_no_credit - если площадка не принимает заявки в рассрочку, создать заявку с единовременной оплатой
      • is_text_final - запретить склонение текста ссылки
      • place_in_text - размещение в тексте
      • place_outside - размещение вне текста
      • set_warranty - назначить заявке 1 год платной гарантии от снятия
      Для заявок форматов link|archive|review:
      • text - текст заявки
      • any_text_anchor - заявка создается с признаком "любой анкор"
      Для заявок формата news:
      • article_id - id статьи для размещения
      Параметры "place_in_text" и "place_outside" устанавливаются только для заявок с форматом размещения "link".
  • struct sape_pr.advert.get(integer $id)
    Получение параметров заявки.
    Возвращаемый массив содержит:
    • id - ID
    • type - формат размещения
    • site_id - ID площадки
    • site_url - URL площадки
    • status - код статуса (см. текстовые расшифровки в описании site.adverts)
    • credit_period - длительность рассрочки
    • credit_status - код статуса рассрочки (см. текстовые расшифровки в описании site.adverts)
    • placement_url - адрес размещения
    • placement_in_text - признак размещения ссылки в тексте материала
    • placement_out_text - признак размещения ссылки вне текста материала
    • is_placement_guarantied - гарантия размещения вебмастером
    • is_indexed - статус индексации (null, если статус неизвестен)
    • wait_index_days_left - количество дней до отмены утверждённой заявки в случае, когда заявка ожидает индексации. В других случаях - null. Если число отрицательное, заявка может быть отменена в любой момент.
    • date_billing - дата зачисления средств
    • wait_days - кол-во дней для размещения заявки вебмастером
    • created_at - дата-время создания
    • updated_at - дата-время последнего какого-либо обновления
    • status_at - дата-время установки текущего статуса
    • placed_at - дата-время размещения
    • is_mos - (только для WM) является ли МОС-заявкой
    • price - стоимость (NULL, если нет прав на просмотр финансовых данных площадки)
    • billed - сумма выплаченных (для SEO) или заработанных (для WM) средств (NULL, если нет прав на просмотр финансовых данных площадки)
    • project_id - (только для SEO) ID проекта
    • error - (только для WM) код статуса ошибки (см. текстовые расшифровки в описании site.adverts)
    • is_placement_unique - (только для WM) признак уникальности текста размещённого материала

    Описания параметров:
    • integer $id - ID заявки
  • struct sape_pr.advert.get_content(integer $id, integer $revision = null)
    Получение задания заявки.
    Возвращаемый массив содержит:
    • body - текст (ссылки + примечание)
    • links - ссылки из заявки
    • links_new - новые ссылки, предложенные на замену "links" в рамках платной услуги "изменение ссылок"
    • description - примечание к заявке
    • author - автор (для статей)
    • title - заголовок (для статей)
    • version - версия текста

    Описания параметров:
    • integer $id - ID заявки
    • integer $revision - Номер версии описания задачи. По-умолчанию, текущая.
  • void sape_pr.advert.cancel(integer $id)
    Отмена заявки оптимизатором.
    Описания параметров:
    • integer $id - ID заявки
  • void sape_pr.advert.approve(integer $id, integer $placement_type = null)
    Утверждение размещения.
    Описания параметров:
    • integer $id - ID заявки
    • integer $placement_type - Способ размещения.
      Если для заявки уже указан конкретный способ размещения, $placement_type указывать не нужно. Если для заявки указаны оба способа размещения (как в тексте, так и в не текста), укажите в качестве $placement_type явно выбранный тип размещения:
      • 1 - в тексте
      • 2 - вне текста
      При этом, если будет указан способ 2 (вне текста), заявка будет отправлена модератору на перепроверку.
  • void sape_pr.advert.premoderate(integer $id)
    Подтвердить создание заявки (дать вебмастеру возможность с ней работать).
    Описания параметров:
    • integer $id - ID заявки
  • void sape_pr.advert.return_wm_improve(integer $id, string $reason)
    Отправить заявку на доработку вебмастеру.
    Описания параметров:
    • integer $id - ID заявки
    • string $reason - Причина
  • void sape_pr.advert.reject(integer $id, string $reason = null)
    Отклонение заявки вебмастером.
    Описания параметров:
    • integer $id - ID заявки
    • string $reason - Причина отклонения (null - стандартное сообщение об отклонении заявки вебмастером)
  • void sape_pr.advert.add_comment(integer $id, string $text, string $recipient = "myself")
    Добавляет комментарий к заявке.
    Описания параметров:
    • integer $id - ID заявки
    • string $text - Текст комментария
    • string $recipient - Кому предназначен комментарий. Возможные значения:
      • moderator - модератору
      • myself - себе
      • all - всем (вебмастеру, оптимизатору, модератору)
  • void sape_pr.advert.place(integer $id, string $url)
    Указание адреса размещения.
    Описания параметров:
    • integer $id - ID заявки
    • string $url - URL размещения
  • void sape_pr.advert.guarantee(integer $id)
    Гарантирование размещения заявки.
    Описания параметров:
    • integer $id - ID заявки
  • void sape_pr.advert.return_seo_rework(integer $id, string $reason)
    Отправка заявки на доработку оптимизатору.
    Описания параметров:
    • integer $id - ID заявки
    • string $reason - Текст причины
  • void sape_pr.advert.force_billing(integer $id)
    Назначение заявке досрочной выплаты всей стоимости (выплата средств происходит в течение суток).
    Описания параметров:
    • integer $id - ID заявки
  • struct sape_pr.advert.pack_offer(integer $pack_type, integer $project_id)
    Возвращает предложение по заданному пакету.
    Каждый элемент с ключом - ID площадки содержит данные по площадкам:
    • advert_indexed_percent - процент индексации заявок
    • ag_google - признак присутствия площадки в Google News
    • ag_yandex - признак присутствия площадки в Яндекс.Новостях
    • cy - тИЦ площадки
    • in_dmoz - признак присутствия площадки в DMOZ
    • in_yaca - признак присутствия площадки в Яндекс.Каталоге
    • price - цена заявки на площадке
    • url - URL площадки

    Описания параметров:
    • integer $pack_type - Тип пакета:
      • 1 - "Новостной удар" (формат заявок - ссылка в новости)
      • 2 - "Тематика" (формат заявок - обзор)
    • integer $project_id - ID проекта
  • array sape_pr.advert.pack_buy(integer $pack_type, integer $project_id, struct $params)
    Покупает пакет заявок. Возвращает массив строк - ID заявок.
    Описания параметров:
    • integer $pack_type - Тип пакета:
      • 1 - "Новостной удар" (формат заявок - ссылка в новости)
      • 2 - "Тематика" (формат заявок - обзор)
    • integer $project_id - ID проекта
    • struct $params - Параметры создания заявок:
      • см. описание в advert.create
      • исключение: "text" не задаётся; в качестве текста задания подбирается ссылка с наименее используемым анкором проекта
  • array sape_pr.social.filter_values(string $field, integer $sn, string $country = null)
    Возможные значения таргетинга.
    Используются значения, а не ключи массива.
    Описания параметров:
    • string $field - Поле фильтрации: gender, marital_status, country, city
    • integer $sn - Соцсеть: 1 - vk, 2 - fb, 3 - g+, 4 - mailru
    • string $country - Страна (необходима для выборки городов)
  • integer sape_pr.social.nb_profiles(integer $sn, struct $param)
    Кол-во пользователей подходящих под параметры таргетинга.
    Параметры таргетинга см. в social.create.
    Описания параметров:
    • integer $sn - Соцсеть: 1 - vk, 2 - fb, 3 - g+, 4 - mailru
    • struct $param - Параметры заявки
  • integer sape_pr.social.create(integer $type, integer $project_id, struct $param)
    Создание социальной заявки. Возвращает ID созданной заявки.
    Описания параметров:
    • integer $type - Тип размещения; возможные типы:
      • 2 - Share / Ссылка на стене
      • 4 - Crowd / Ссылка из обсуждения
    • integer $project_id - ID проекта
    • struct $param - Параметры заявки:
      Если $type == 2:
      • sn - соцсеть. 1: vk, 2: fb, 3: g+, 4: mailru
      • url - URL страницы
      • nb_likes - кол-во лайков/постов/пользователей
      • daily_limit - ограничение в день
      • text - текст поста
      • min_age - минимальный возраст
      • max_age - максимальный возраст
      • gender - пол (см. описание social.filter_values)
      • marital_status - семейное положение (см. описание social.filter_values)
      • country - страна (см. описание social.filter_values)
      • city - город (см. описание social.filter_values)
      • min_friends_count - минимальное кол-во друзей
      • max_friends_count - максимальное кол-во друзей
      Если $type == 4:
      • url - URL страницы
      • nb_likes - кол-во постов
      • sn - тип размещения: 5 (по умолчанию) - любое, 6 - Ответы@Mail.Ru, 7 - форумы и комментарии к блогам
      • is_concrete_url - признак, требовать ли от исполнителя строгого размещения заданного в заявке URL-а; иначе (по умолчанию) исполнитель размещает любой URL, найденный в домене, вырезанном из заданного оптимизатором URL-а
  • struct sape_pr.social.get(integer $id)
    Получение параметров заявки (не включает данные о выполнениях).
    Описание возвращаемой структуры: project.social.
    Описания параметров:
    • integer $id - ID заявки
  • void sape_pr.social.cancel(integer $id)
    Отмена заявки оптимизатором.
    Описания параметров:
    • integer $id - ID заявки
  • array sape_pr.autobuyer.index(struct $filter = [])
    Список авторежимов пользователя.
    Каждый элемент содержит:
    • id - ID авторежима
    • project_id - ID проекта
    • name - название
    • budget - бюджет
    • created_at - дата создания

    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • id - ID авторежима
      • project_id - ID проекта
  • array sape_pr.autobuyer.anchors(integer $id)
    Список URL-ов и анкоров, подключенных к авторежиму.
    Каждый элемент содержит:
    • anchor_id - ID анкора
    • url_id - ID URL-а
    • url - текст URL-а
    • text - текст анкора
    • budget - бюджет на анкор (если задан)
    • nb_adverts_max - максимальное количество ссылок на анкор (если задано)

    Описания параметров:
    • integer $id - ID авторежима
  • integer sape_pr.autobuyer.create(struct $params, struct $anchor_data, boolean $start = true)
    Создаёт новый авторежим и возвращает его ID.
    Бюджет должен быть задан для проекта ($params) ИЛИ для анкоров ($anchor_data).
    Описания параметров:
    • struct $params - Параметры создания авторежима:
      • project_id - ID проекта
      • name - название авторежима
      • filter_type - тип фильтра
      • filter_id - ID фильтра
      • mode - режим (0 - полуавтоматический, 1 - автоматический)
      • period - период закупки (0 - единоразово, 30 - ежемесячно, 90 - 3 месяца, 180 - полгода)
      • adverts_per_day - максимальное кол-во заявок в день (опционально)
      • nb_review_links - кол-во ссылок для обзора (по умолчанию 3)
      • budget - бюджет авторежима
      • payment_type - тип оплаты (0 - сразу, 1 - в рассрочку)
      • credit_period - срок рассрочки (90, 180)
      • comment - комментарий к создаваемым заявкам (опционально)
    • struct $anchor_data - Анкоры авторежима; ключами является ID анкора, а значениями - массив параметров:
      • budget - бюджет на анкор
      • nb_adverts_max - максимальное кол-во ссылок
    • boolean $start - Запустить ли сразу созданный авторежим
  • void sape_pr.autobuyer.stop(integer $id)
    Остановить авторежим.
    Описания параметров:
    • integer $id - ID авторежима
  • void sape_pr.autobuyer.start(integer $id)
    Запустить авторежим.
    Описания параметров:
    • integer $id - ID авторежима
  • array sape_pr.autobuyer.stat(integer $id)
    Статистика по авторежиму.
    Описания параметров:
    • integer $id - ID авторежима
  • array sape_pr.comment.index(struct $filter = [], integer $page = 1, integer $per_page = 10)
    Возвращает массив комментариев.
    Каждый элемент содержит:
    • id - ID комментария
    • advert_id - ID заявки
    • author - автор комментария
    • text - комментарий
    • created_at - датавремя создания
    • is_read - просмотрен ли комментарий

    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • advert_id - массив ID заявок
      • site_id - массив ID сайтов
      • project_id - массив ID проектов
      • read_state - выводить прочитанные (read) или непрочитанные (unread)
      • created_since - датавремя "с" в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
      • created_till - датавремя "по" в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • void sape_pr.comment.read(array $ids = [])
    Отметить комментарии как прочитанные.
    Описания параметров:
    • array $ids - Список ID комментариев (пустой массив - все комментарии)
  • float sape_pr.billing.money_hold()
    Прогнозируемый баланс по всем заявкам пользователя.
  • array sape_pr.twitter.account.search(struct $filter, integer $page = 1, integer $per_page = 500, struct $order = null)
    Поиск твит-аккаунтов.
    Для каждого сайта будет возвращен массив со следующими параметрами:
    • id - ID твит-аккаунта
    • user_id - ID вебмастера
    • name - название
    • screen_name - screen name
    • followers_count - количество фолловеров (кто подписан на данный аккаунт)
    • friends_count - количество друзей (на кого подписан данный аккаунт)
    • statuses_count - количество твитов у данного аккаунта
    • price_link - цена размещения
    • pr - Google Page Rank

    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • id - ID твит-аккаунта
      • user_id - ID вебмастера
      • name - название
      • screen_name - screen name
      • followers_from - Минимальное количество фолловеров (кто подписан на данный аккаунт)
      • followers_to - максимальное количество фолловеров (кто подписан на данный аккаунт)
      • friends_from - минимальное количество друзей (на кого подписан данный аккаунт)
      • friends_to - максимальное количество друзей (на кого подписан данный аккаунт)
      • price_from - минимальная цена размещения
      • price_to - максимальная цена размещения
      • pr_from - минимальный Google Page Rank
      • pr_to - максимальный Google Page Rank
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
    • struct $order - Массив полей для сортировки по ним списка найденных твит-аккаунтов (1 - по возрастанию, -1 - по убыванию); возможные поля (ключи массива) для сортировки:
      • id
      • user_id
      • name
      • screen_name
      • followers_count
      • friends_count
      • statuses_count
      • price_link
      • pr
  • boolean sape_pr.twitter.advert.send_wm(integer $id)
    Отправить веб-мастеру.
    Описания параметров:
    • integer $id - ID заявки
  • integer sape_pr.twitter.advert.create(string $type, integer $project_id, integer $twaccount_id, struct $param)
    Создаёт твит-заявку.
    Возвращает ID в случае успеха и false в случае ошибки.
    Описания параметров:
    • string $type - Формат размещения заявки (только link)
    • integer $project_id - ID проекта
    • integer $twaccount_id - ID аккаунта Twitter
    • struct $param - Параметры для создания заявки:
      • url - URL для указания в заявке
      • text - Текст заявки
      • duplicate_create - Разрешить создавать дубликаты
      • max_price - максимальная цена покупки (необязательный параметр)
  • array sape_pr.twitter.advert.get(integer $id)
    Получение данных твит-заявки по её id.
    Массив возвращаемых полей:
    • id - ID заявки
    • type - тип ссылки (link, retweet)
    • status - статус заявки
    • tw_account_id - ID твит-аккаунта
    • price - цена
    • text - текст в теле твита
    • url - ссылка в теле твита
    • placement_url - адрес размещения
    • status_at - время смены статуса
    • placed_at - время размещения
    • created_at - время создания

    Описания параметров:
    • integer $id - ID твит-заявки
  • bool sape_pr.twitter.advert.approve(integer $id)
    Одобрить заявку со стороны оптимизатора.
    Описания параметров:
    • integer $id - ID твит-заявки
  • boolean sape_pr.twitter.advert.cancel(integer $id)
    Отменить заявку со стороны оптимизатора.
    Описания параметров:
    • integer $id - ID твит-заявки
  • boolean sape_pr.twitter.advert.add_comment(integer $id, string $text)
    Добавить комментарий для заявки.
    Описания параметров:
    • integer $id - ID твит-заявки
    • string $text - Текст комментария
  • array sape_pr.twitter.advert.get_comments(integer $id)
    Получить комментарии для заявки.
    Описания параметров:
    • integer $id - ID твит-заявки
  • void sape_pr.wizard.advert.force_check_by_moder(integer $id)
    Выставить заявке флаг проверки размещения модератором.
    Меняет только флаг, кто проверяет заявку. Статус не меняется. Если заявка уже настроена на проверку модератором, функция просто ничего не делает (ошибку не возвращает).
    Описания параметров:
    • integer $id - ID заявки
  • array sape_pr.blacklist.seo.get(integer $project_id = null)
    Возвращает список площадок, занесённых в чёрный список проекта или ГБЛ:
    • ID площадки => URL площадки

    Описания параметров:
    • integer $project_id - ID проекта (null - площадки из ГБЛ)
  • integer sape_pr.blacklist.seo.add(array $site_urls_or_ids, integer $project_id = null)
    Добавляет площадки в чёрный список проекта или ГБЛ.
    Возвращает количество добавленных площадок.
    Описания параметров:
    • array $site_urls_or_ids - Массив Url-ов или ID площадок
    • integer $project_id - ID проекта (null - площадки добавляются в ГБЛ)
  • integer sape_pr.blacklist.seo.delete(array $site_urls_or_ids, integer $project_id = null)
    Удаляет площадки из чёрного списка проекта или ГБЛ.
    Возвращает количество удаленных площадок.
    Описания параметров:
    • array $site_urls_or_ids - Массив Url-ов или ID площадок
    • integer $project_id - ID проекта (null - площадки удаляются из ГБЛ)
  • void sape_pr.blacklist.seo.delete_all(integer $project_id = null)
    Удалить все площадки из черного списка или ГБЛ.
    Описания параметров:
    • integer $project_id - ID проекта (null - очищается ГБЛ)
  • array sape_pr.blacklist.wm.get(integer $site_id = null)
    Возвращает список доменов, занесённых в чёрный список площадки или ГБЛ.
    Описания параметров:
    • integer $site_id - ID площадки (null - возвращаются домены из ГБЛ)
  • integer sape_pr.blacklist.wm.add(array $domains_or_urls, integer $site_id = null)
    Добавляет домены в чёрный список площадки или ГБЛ.
    Возвращает количество добавленных доменов.
    Описания параметров:
    • array $domains_or_urls - Массив доменов или URL-ов, содержащих добавляемые в БЛ домены
    • integer $site_id - ID площадки (null - домены добавляются в ГБЛ)
  • integer sape_pr.blacklist.wm.delete(array $domains_or_urls, integer $site_id = null)
    Удаляет домены из чёрного списка площадки или ГБЛ.
    Возвращает количество удалённых доменов.
    Описания параметров:
    • array $domains_or_urls - Массив доменов или URL-ов, содержащих удаляемые из БЛ домены
    • integer $site_id - ID площадки (null - домены удаляются из ГБЛ)
  • void sape_pr.blacklist.wm.delete_all(integer $site_id = null)
    Удалить все домены из черного списка площадки или ГБЛ.
    Описания параметров:
    • integer $site_id - ID площадки (null - очищается ГБЛ)
  • struct sape_pr.whitelist.get_default()
    Получить раздел избранного по-умолчанию:
    • id - ID раздела избранного
    • name - Название раздела избранного
  • array sape_pr.whitelist.get_all()
    Получить список всех разделов избранного:
    • ID раздела => название
  • integer sape_pr.whitelist.create(string $name)
    Создаёт раздел избранного и возвращает его ID.
    Описания параметров:
    • string $name - Название раздела избранного
  • void sape_pr.whitelist.clear(integer $id = null)
    Очистить раздел избранного (удалить все площадки из раздела).
    Описания параметров:
    • integer $id - ID раздела избранного (null - берется раздел избранного по-умолчанию)
  • void sape_pr.whitelist.delete(integer $id)
    Удалить раздел избранного.
    Описания параметров:
    • integer $id - ID раздела избранного
  • void sape_pr.whitelist.rename(integer $id, string $name)
    Переименовать раздел избранного.
    Описания параметров:
    • integer $id - ID раздела избранного
    • string $name - Новое имя раздела избранного
  • array sape_pr.whitelist.get_sites(integer $list_id = null)
    Возвращает список площадок, добавленных в раздел избранного:
    • ID площадки => URL площадки

    Описания параметров:
    • integer $list_id - ID раздела избранного (null - берется раздел избранного по-умолчанию)
  • integer sape_pr.whitelist.add_sites(array $site_urls_or_ids, integer $list_id = null)
    Добавляет площадки в раздел избранного.
    Возвращает количество добавленных площадок.
    Описания параметров:
    • array $site_urls_or_ids - Массив Url-ов или ID площадок
    • integer $list_id - ID раздела избранного (null - берется раздел избранного по-умолчанию)
  • integer sape_pr.whitelist.remove_sites(array $site_urls_or_ids, integer $list_id = null)
    Удаляет площадки из раздела избранного.
    Возвращает количество удаленных площадок.
    Описания параметров:
    • array $site_urls_or_ids - Массив Url-ов или ID площадок
    • integer $list_id - ID раздела избранного (null - берется раздел избранного по-умолчанию)
  • integer sape_pr.article.create(integer $project_id, struct $params)
    Создаёт статью. Возвращает ID созданной статьи.
    Описания параметров:
    • integer $project_id - ID проекта
    • struct $params - Параметры создания статьи:
      Обязательные:
      • title - Заголовок статьи
      • body - Html текст статьи
      • meta_title - META Title
      Необязательные:
      • no_comments - Отключить комментирование
      • meta_keywords - META Keywords
      • meta_description - META Description
      • description - Описание
      • slug - Желаемый вид URL
      • snippet - Текст анонса
  • struct sape_pr.article.get(integer $id)
    Получить данные по статье:
    • id - ID статьи
    • status - Статус
    • project_id - Проект
    • user_id - Владелец
    • links - Ссылки в статье
    • body - Html текст статьи
    • no_comments - Отключить комментирование
    • title - Заголовок статьи
    • meta_keywords - META Keywords
    • meta_title - META Title
    • meta_description - META Description
    • description - Описание
    • slug - Желаемый вид URL
    • snippet - Текст анонса
    • is_archived - Статья в архиве или нет

    Описания параметров:
    • integer $id - ID статьи
  • array sape_pr.article.get_list(struct $filter = null, integer $page = 1, integer $per_page = 500)
    Получить список статей по фильтру.
    Каждый элемент содержит:
    • id - ID статьи
    • status - Статус
    • project_id - Проект
    • user_id - Владелец
    • links - Ссылки в статье
    • body - Html текст статьи
    • no_comments - Отключить комментирование
    • title - Заголовок статьи
    • meta_keywords - META Keywords
    • meta_title - META Title
    • meta_description - META Description
    • description - Описание
    • slug - Желаемый вид URL
    • snippet - Текст анонса
    • is_archived - Статья в архиве или нет

    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • ids - список id статей
      • project_id - ID проекта
      • statuses - список статусов
      • created_from - дата начала диапазона по времени создания в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
      • created_to - дата конца диапазона по времени создания в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
      Возможные коды статусов:
      • 0 - черновик
      • 1 - на модерации
      • 2 - отклонена
      • 3 - промодерирована
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • void sape_pr.article.update(integer $id, struct $params)
    Обновить параметры статьи.
    Описания параметров:
    • integer $id - ID статьи
    • struct $params - Возможные парметры обновления:
      • title - Заголовок статьи
      • body - Html текст статьи
      • meta_title - META Title
      • meta_keywords - META Keywords
      • no_comments - Отключить комментирование
      • meta_description - META Description
      • description - Описание
      • slug - Желаемый вид URL
      • snippet - Текст анонса
      • moderate - Отправить на модерацию
      • unmoderate - Вернуть из модерации
  • array sape_pr.article_order.get_categories(boolean $group = false)
    Получить список возможных тематических категорий.
    При отсутствии группировки результатом являтеся массив всех категорий вида:
    • ID категории => Название категории
    При наличии группировки результатом является массив групповых категорий с вложенными обычными категориями вида:
    • Название группы => подмассив:
      • ID категории => Название категории

    Описания параметров:
    • boolean $group - Группировать ли категории
  • integer sape_pr.article_order.create(integer $project_id, struct $data)
    Создать заказ на статью для проекта.
    Описания параметров:
    • integer $project_id - ID проекта
    • struct $data - Параметры создаваемой статьи:
      • title - Название статьи
      • description - Описание требований
      • keywords - Ключевые слова
        • title - Ключевое слово
        • nof - Количество повторений
        • mod - Можно ли склонять слово
      • links - Ссылки, массив с элементами, каждый из которых содержит:
        • anchor - Анкор
        • url - Ссылка
        • mod - Можно ли склонять анкор
      • categories_list - Массив ID тематических категорий
  • struct sape_pr.article_order.get(integer $id)
    Получить заказ статьи.
    Данные по заказу статьи содержат:
    • id - ID статьи
    • status - Статус
    • status_name - Строковое описание статуса
    • user_id - Владелец заказа
    • project_id - Проект заказа
    • article_id - ID сохраненной статьи
    • title - Название статьи
    • description - Описание требований
    • keywords - Ключевые слова:
      • title - Ключевое слово
      • nof - Количество повторений
      • mod' - Можно ли склонять слово
    • links - Ссылки, массив с элементами, каждый из которых содержит:
      • anchor - Анкор
      • url - Ссылка
      • mod - Можно ли склонять анкор
    • categories_list - Массив ID тематических категорий
    • price - Цена заказа
    • decline_reason - Причина отклонения заказа
    • article_written - Написанная статья:
      • header - Заголовок
      • announcement - Текста анонса статьи
      • article_text - Текст статьи
      • title - META Title
      • keywords - META Keywords
      • description - META Description

    Описания параметров:
    • integer $id - ID статьи
  • array sape_pr.article_order.get_list(struct $filter = null, integer $page = 1, integer $per_page = 500)
    Получить список заказов статей по фильтру.
    Возвращает массив, каждый элемент которого повторяет структуру ответа article_order.get.
    Описания параметров:
    • struct $filter - Необязательный массив фильтров:
      • ids - список id статей
      • project_id - проект
      • statuses - список статусов
      • created_from - дата начала диапазона по времени создания в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
      • created_to - дата конца диапазона по времени создания в формате "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
    • integer $page - Страница результатов (1 min)
    • integer $per_page - Результатов на страницу (500 max)
  • void sape_pr.article_order.cancel(integer $id)
    Отменить заказ.
    Описания параметров:
    • integer $id - ID заказа
  • void sape_pr.article_order.activate(integer $id)
    Активировать заказ.
    Описания параметров:
    • integer $id - ID заказа
  • void sape_pr.article_order.do_correct(integer $id)
    Уточнить заказ.
    Описания параметров:
    • integer $id - ID заказа
  • void sape_pr.article_order.decline(integer $id, string $reason)
    Отклонить заказ.
    Описания параметров:
    • integer $id - ID заказа
    • string $reason - Причина отклонения заказа
  • void sape_pr.article_order.approve(integer $id)
    Утвердить заказ.
    Описания параметров:
    • integer $id - ID заказа

Ограничения вызовов функций

Базовое ограничение: допустимо вызывать любые функции в сумме не больше 60 раз в течение 1 секунды.

Ограничения по функциям (в пределах заданного промежутка времени):

  • sape_pr.advert.place (15 секунд):
    • количество вызовов — 5
  • sape_pr.comment.index (1 час):
    • количество вызовов — 15
  • sape_pr.project.adverts (1 минута):
    • суммарное время выполнения — 60 секунд
    • не более 2 параллельных вызовов
  • sape_pr.project.finance_stats (1 день):
    • суммарное время выполнения — 200 секунд
    • не более 1 параллельного вызова
  • sape_pr.project.index (1 час):
    • суммарное время выполнения — 25 секунд
    • не более 1 параллельного вызова
  • sape_pr.site.adverts (1 минута):
    • суммарное время выполнения — 60 секунд
    • не более 2 параллельных вызовов
  • sape_pr.site.finance_stats (1 день):
    • суммарное время выполнения — 200 секунд
    • не более 1 параллельного вызова
  • sape_pr.site.ownlist (2 часа):
    • суммарное время выполнения — 80 секунд
    • не более 1 параллельного вызова
  • sape_pr.site.search (15 секунд):
    • количество вызовов — 1
  • sape_pr.social.filter_values (1 минута):
    • количество вызовов — 10

Список кодов и расшифровок исключений

Ниже представлен список исключений, которые могут возникнуть в процессе работы с функционалом API.PR.SAPE.RU. Данный список всегда актуален и время от времени меняется.
Возникающее в процессе работы исключение может в зависимости от ситуации содержать в дополнение к стандартному сообщению более подробную информацию (указывается в скобках).
В случае возникновения исключения, код которого здесь не указан, обратитесь в службу технической поддержки.

Код Описание
100200022 Нельзя получить фин. статистику по заявкам: некорректная группировка периодов
100200042 Нельзя получить фин. статистику по стероидам: некорректная группировка периодов
100300021 Проверка гостевого доступа: нет прав для выполнения операции
101200002 Нельзя перенести объект: перенос возможен только на другого пользователя
101400001 Извлечение ссылок: не удалось найти ни одной ссылки в переданном HTML
101400021 Извлечение ссылок: не удалось найти ни одного URL-а в переданном HTML
101400041 Извлечение ссылок: не удалось найти ни одной ссылки в переданном списке
102000001 Загрузка статьи из TXT-файла: не удалось загрузить файл
102000021 Загрузка статей из ZIP-архива: не удалось загрузить архив
102000022 Загрузка статей из ZIP-архива: не удалось разархивировать
102000023 Загрузка статей из ZIP-архива: архив не содержит файлов с расширением .txt
102000042 Чтение файла со статьёй: не задано обязательное поле
102700061 Проверка задания заявки: нет ни одной корректной ссылки
102700062 Проверка задания заявки: URL "site.ru" недопустим
102700063 Проверка задания заявки: не удаётся открыть страницу по URL-у из задания (страница не найдена или доступ к ней ограничен)
102700081 Проверка площадки для размещения: площадка не размещает заявки данного формата
102700082 Проверка площадки для размещения: нельзя создать заявку на собственную площадку
102700083 Проверка площадки для размещения: площадка не принимает новые заявки
102700084 Проверка площадки для размещения: в данный момент на площадке уже размещается максимальное количество заявок
102700085 Проверка площадки для размещения: стоимость размещения превышает разрешённую
102700086 Проверка площадки для размещения: площадка принимает заявки только с размещением ссылок вне текста новости
102700087 Проверка площадки для размещения: превышен бюджет проекта
102700101 Проверка заявки на дубликаты: заявка с такими же ссылками уже есть на другой площадке
102700121 Проверка анкоров ссылок заявки: превышен лимит использования анкора
102700122 Проверка анкоров ссылок заявки: у всех анкоров превышены лимиты использования
102700141 Проверка URL-ов ссылок заявки: присутствует некорректный URL
102700161 Ошибка создания заявки: статья не промодерирована
102700162 Ошибка создания заявки: статья находится в архиве
102700163 Ошибка создания заявки: статья не существует
102700181 Ошибка создания заявки: не указано место размещения (в тексте, вне текста)
102700201 Ошибка создания заявки: у оптимизатора нет права на покупку заявки в рассрочку
102700202 Ошибка создания заявки: площадка не принимает заявки в рассрочку
102700203 Ошибка создания заявки: некорректный тип оплаты
102700204 Ошибка создания заявки: недостаточно средств для блокировки
102700221 Ошибка создания заявки: не удалось найти проект
102700222 Ошибка создания заявки: проект находится в архиве
102700242 Ошибка создания заявки: не удалось найти площадку
102700261 Ошибка создания заявки: в ссылках заявки присутствуют глобально запрещённые слова
102700262 Ошибка создания заявки: бюджет проекта реализован
102700263 Ошибка создания заявки: в ссылках заявки присутствуют запрещённые для площадки слова
102700281 Ошибка создания заявки: опция "любой анкор" недоступна
102700301 Установка ссылок для заявки: домен URL-а ссылки находится в чёрном списке на площадке вебмастера
102800001 Ошибка создания статьи: не удалось найти проект
102800002 Ошибка создания статьи: проект находится в архиве
102800021 Ошибка обновления статьи: не удалось найти статью для данного оптимизатора
102800041 Ошибка создания статьи: нет ни одной корректной ссылки
102800042 Ошибка создания статьи: указаны некорректные данные
102800061 Ошибка обновления статьи: нет ни одной корректной ссылки
102800062 Ошибка обновления статьи: указаны некорректные данные
103000001 Проверка баланса: недостаточно средств для блокировки
103000021 Проверка твиттер-аккаунта для размещения: твиттер-аккаунт не принимает новые твит-заявки
103000022 Проверка твиттер-аккаунта для размещения: твиттер-аккаунт не размещает заявки данного формата
103000023 Проверка твиттер-аккаунта для размещения: нельзя создать твит-заявку на собственном твиттер-аккаунте
103000024 Проверка твиттер-аккаунта для размещения: стоимость размещения превышает разрешённую
103000041 Ошибка создания твит-заявки: не удалось найти проект
103000042 Ошибка создания твит-заявки: проект находится в архиве
103000061 Ошибка создания твит-заявки: задан некорректный URL
103000062 Ошибка создания твит-заявки: в тексте твита не должно быть ни одного URL
103000063 Ошибка создания твит-заявки: URL находится в системном ГБЛ
103000064 Ошибка создания твит-заявки: Домен URL-а находится в твиттер-блэклисте
103000081 Ошибка создания твит-заявки: длина текста твита превышает допустимую
103000101 Ошибка создания твит-заявки: переданы некорректные ID твиттер-аккаунтов
103000102 Ошибка создания твит-заявки: не удалось найти твиттер-аккаунт
103000121 Ошибка создания твит-заявки: бюджет проекта реализован
103000122 Ошибка создания твит-заявки: в тексте твита присутствуют запрещённые слова
103000123 Ошибка создания твит-заявки: попытка создания дубликата ссылки для того же твит-аккаунта
103100001 Нельзя создать заказ статьи: не удалось найти проект
103100002 Нельзя создать заказ статьи: проект находится в архиве
103100003 Нельзя создать заказ статьи: указаны некорректные данные
103100005 Нельзя создать заказ статьи: заявка не найдена
103100006 Нельзя создать заказ статьи: заявка уже имеет заказ
103200001 Нельзя подобрать анкор: проект не содержит ни одного активного анкора
103800001 Ошибка валидации схемы URL-а: некорректный URL
103800002 Ошибка валидации схемы URL-а: недопустимая схема
103800021 Ошибка валидации URL-а: площадка недоступна
103800022 Ошибка валидации URL-а: площадка находится в системном ГБЛ
103800023 Ошибка валидации URL-а: площадка уже зарегистрирована в системе
103800024 Ошибка валидации URL-а: запрос на добавление площадки уже существует
103800041 Не удалось получить ID домена: Некорректное имя домена
120100081 Нельзя гарантировать размещение заявки: размещение заявки уже было гарантировано
120100082 Нельзя гарантировать размещение заявки: заявка находится в некорректном статусе
120100083 Нельзя гарантировать размещение заявки: у оптимизатора ещё есть время для отмены заявки
120100101 Нельзя досрочно оплатить заявку: некорректный статус
120100121 Нельзя подтвердить создание заявки: заявка не находится в статусе требования подтверждения
120100141 Нельзя указать адрес размещения: некорректный статус
120100181 Нельзя отправить заявку на уточнение оптимизатору: только модератор может выполнить операцию для данной заявки
120100182 Нельзя отправить заявку на уточнение оптимизатору: заявка не находится на размещении/доработке у вебмастера
120100202 Нельзя обработать заявку: заявка не находится в статусе проверки размещения
120100204 Нельзя обработать заявку: размещение данной заявки проверяется модератором
120100222 Нельзя отменить заявку: заявка находится на размещении у вебмастера недостаточно долго
120100223 Нельзя отменить заявку: заявка находится на доработке у вебмастера недостаточно долго
120100224 Нельзя отменить заявку: размещение заявки гарантировано
120100225 Нельзя отменить заявку: заявка ожидает индексации недостаточно долго
120100226 Нельзя отменить заявку: некорректный статус
120100241 Нельзя произвести VIP-отмену заявки: заявка не утверждена
120100242 Нельзя произвести VIP-отмену заявки: заявка куплена не в рассрочку
120100261 Нельзя отклонить заявку: некорректный статус
120100262 Нельзя отклонить заявку: были выплаты по рассрочке
120100281 Нельзя отменить заявку из-за долгого нахождения в ошибке: нет ошибки размещения
120100283 Нельзя отменить заявку из-за долгого нахождения в ошибке: некорректный статус
120100301 Нельзя определить заявку к снятию: заявка не утверждена
120100321 Нельзя снять заявку: заявка не определена к снятию
120100322 Нельзя снять заявку: заявка не оплачена
120100323 Нельзя снять заявку: есть неоплаченный стероид снятия
120100324 Нельзя снять заявку: оплаченный стероид снятия уже отмечен применённым
120100381 Нельзя утвердить заявку: некорректный статус
120100442 Нельзя отклонить заявку: некорректный статус
120100443 Нельзя отклонить заявку: были выплаты по рассрочке
120100445 Нельзя отклонить заявку: были выплаты
120100581 Нельзя сделать заказ текста для заявки: заказ уже существует
120100582 Нельзя сделать заказ текста для заявки: заявка в неверном статусе
120100583 Нельзя сделать заказ текста для заявки: тип заявки не предполагает заказ контента
120100584 Нельзя сделать заказ текста для заявки: текущий пользователь не является вебмастером-владельцем заявки; гостевой доступ не поддерживается
120100641 Нельзя отменить снятие заявки: заявка не определена к снятию
120100643 Нельзя отменить снятие заявки: оплата услуги снятия уже была одобрена
120100721 Нельзя создать стероид изменения ссылок для заявки: операция не поддерживается для заявок формата "статья"
120100722 Нельзя создать стероид изменения ссылок для заявки: заявка не утверждена
120100723 Нельзя создать стероид изменения ссылок для заявки: заявка находится в ошибке размещения
120100724 Нельзя создать стероид изменения ссылок для заявки: на площадке запрещено изменение ссылок
120100725 Нельзя создать стероид изменения ссылок для заявки: услуга для данной заявки уже была заказана
120100761 Нельзя отменить стероид изменения ссылок для заявки: операция возможна только для ещё не одобренного стероида (при наличии)
120100762 Нельзя отменить стероид изменения ссылок для заявки: стероид уже виден вебмастеру, но недостаточно долго
120100781 Нельзя отклонить стероид изменения ссылок для заявки: операция возможна только для ещё не одобренного стероида (при наличии)
120100821 Нельзя отклонить стероид изменения ссылок для заявки: задан слишком короткий текст причины отклонения
120100841 Нельзя создать черновики новых ссылок заявки: не заданы параметры черновиков
120100842 Нельзя создать черновики новых ссылок заявки: заявка не найдена
120100843 Нельзя создать черновик новой ссылки заявки: исходная ссылка не найдена в базе
120100844 Нельзя создать черновик новой ссылки заявки: исходная ссылка неактивна
120100846 Нельзя создать черновик новой ссылки заявки: заданные исходные ссылки принадлежат чужой заявке
120100847 Нельзя создать черновик новой ссылки заявки: на площадке запрещено изменение URL-а
120100848 Нельзя создать черновик новой ссылки заявки: на площадке запрещено изменение анкора
120100849 Нельзя создать черновик новой ссылки заявки: не задано ни одного нового URL-а или анкора
120100862 Нельзя отклонить заявку: не указана причина
120100881 Нельзя создать стероид увеличения цены для заявки: заявка не находится в статусе размещения вебмастером
120100882 Нельзя создать стероид увеличения цены для заявки: услуга для данной заявки уже была заказана
120100901 Нельзя создать стероид увеличения цены для заявки: слишком низкая цена
120100902 Нельзя создать стероид увеличения цены для заявки: слишком высокая цена
120100921 Нельзя отправить в обработку стероид увеличения цены для заявки: операция возможна только для услуги в статусе черновика
120100941 Нельзя отменить стероид увеличения цены заявки от лица вебмастера: операция возможна только для услуги в нетерминальном статусе
120100961 Нельзя отклонить стероид увеличения цены заявки от лица оптимизатора: операция возможна только для услуги в статусе черновика
120200041 Слишком короткий комментарий к заявке
120200042 Комментарий к заявке превышает максимальную длину
120300001 Нельзя удалить URL: URL используется в твит-заявках
120300002 Нельзя удалить URL: есть использующиеся анкоры
120300003 Нельзя удалить URL: URL используется в социальных заявках
120300021 URL не задан
120300022 URL не содержит указание протокола
120300023 Некорректный ID проекта
120300041 Некорректный URL
120300061 URL находится в системном ГБЛ
120400001 Нельзя удалить анкор: анкор используется в ссылках заявок
120400002 Нельзя удалить анкор: анкор используется в авторежимах
120400003 Нельзя удалить анкор: анкор используется в твит-заявках
120400004 Нельзя удалить анкор: анкор используется в социальных заявках
120400022 Некорректный ID URL-а
120400023 Некорректный текст анкора
120400024 Некорректный текст анкора: в тексте присутствуют запрещённые слова
120400041 Нельзя архивировать анкор: данный анкор является единственным в активном авторежиме
120400061 Не могу добавить анкор: слишком длинный текст анкора
120500021 Нельзя запустить авторежим: не задано ни одного анкора
120700022 Нельзя архивировать проект: на проекте есть заявки в работе
120700023 Нельзя архивировать проект: проект создан в Wizard.Sape
120700041 Нельзя купить пакет: не определён продвигаемый в проекте домен
120700042 Нельзя купить пакет: проект архивирован
120700043 Нельзя купить пакет: проект создан в системе Wizard.Sape
120700045 Нельзя купить пакет: некорректный тип пакета
120700046 Нельзя купить пакет: для домена проекта не определена тематика; задайте тематику проекта вручную в его настройках
120700047 Нельзя купить пакет: у проекта нет ни одного анкора для твитов или социальных заявок
121200001 Нельзя отправить твит-заявку вебмастеру: твит-заявка не находится на размещении
121200021 Нельзя отправить твит-заявку в работу: некорректный статус
121200041 Нельзя разместить твит-заявку: твит-заявка не находится в работе
121200061 Нельзя одобрить твит-заявку: твит-заявка не находится на проверке размещения
121200081 Нельзя отклонить твит-заявку: некорректный статус
121200121 Нельзя отменить твит-заявку: некорректный статус
121200181 Нельзя разместить твит-заявку: некорректный адрес размещения
121500001 Нельзя удалить статью: статья используется в заявках
121700001 Нельзя отменить заказ: некорректный статус
121700021 Нельзя активировать заказ: некорректный статус
121700041 Нельзя отправить на уточнение заказ : некорректный статус
121700061 Нельзя уточнить заказ: некорректный статус
121700081 Нельзя взять в работу заказ: некорректный статус
121700101 Нельзя выполнить заказ: некорректный статус
121700121 Нельзя отклонить заказ: некорректный статус
121700141 Нельзя подтвердить заказ: некорректный статус
121900001 Нельзя остановить социальную заявку: заявка уже обработана
121900041 Нельзя создать социальную заявку: заданы некорректные параметры
121900042 Нельзя создать социальную заявку: запрошено слишком много лайков/постов
121900043 Нельзя создать социальную заявку: текст содержит запрещённые слова
121900049 Нельзя создать социальную заявку: не задана социальная сеть
121900050 Нельзя создать социальную заявку: задана некорректная социальная сеть
121900051 Нельзя создать социальную заявку: не задан тип размещения
121900052 Нельзя создать социальную заявку: задан некорректный тип размещения
121900085 Нельзя добавить выполнение: слишком длинный уникальный ID выполнения
122000001 Нельзя удалять последний раздел избранного
122000021 Раздел избранного с такими именем уже существует
122100001 Указанные площадки не найдены
122100002 Не указан раздел избранного
122200001 Нельзя создать твиттер-аккаунт: указанный screen_name аккаунта уже существует в системе
122200021 Нельзя изменить screen name у твиттер-аккаунта: screen name не задан
122200022 Нельзя изменить screen name у твиттер-аккаунта: задан тот же screen name, который уже установлен для данного твиттер-аккаунта
122200023 Нельзя изменить screen name у твиттер-аккаунта: аккаунт с заданным screen name уже существует в системе
122300022 Нельзя настроить авторежим социальных заявок: авторежим совершает закупку в данный момент
122300023 Нельзя настроить авторежим социальных заявок: не задано ни одной социальной сети, по которой должна производиться закупка
122300025 Нельзя настроить авторежим социальных заявок: задан слишком маленький бюджет
122300027 Нельзя настроить авторежим социальных заявок: минимальное количество друзей больше максимального
122300061 Нельзя создать авторежим социальных заявок: проект относится к системе Wizard.Sape
122500041 Нельзя создать авторежим твиттер заявок: проект относится к системе Wizard.Sape
122500061 Нельзя закупить твит-заявки: Нет подходящих твит-аккаунтов
122500062 Нельзя закупить твит-заявки: Нет анкоров
122500082 Нельзя настроить авторежим твиттер заявок: авторежим совершает закупку в данный момент
122500083 Нельзя настроить авторежим твиттер заявок: задан слишком маленький бюджет
122700041 Нельзя сохранить авторежим крауд-ссылок: проект относится к системе Wizard.Sape
122700042 Нельзя сохранить авторежим крауд-ссылок: задан слишком маленький бюджет
122700043 Нельзя сохранить авторежим крауд-ссылок: не задан домен
122700061 Нельзя настроить авторежим крауд-ссылок: авторежим совершает закупку в данный момент
122800001 Нельзя добавить instagram-аккаунт: слишком малое число подписчиков
122800011 Нельзя добавить instagram-аккаунт: аккаунт с таким screen name уже существует в системе
122800012 Нельзя добавить instagram-аккаунт: аккаунт с таким Instagram ID уже существует в системе
122900001 Нельзя перевести на размещение instagram-заявку: заявка в непригодном исходном статусе
122900021 Нельзя отправить на уточнение задания instagram-заявку: заявка не находится на размещении
122900041 Нельзя отправить на согласование instagram-заявку: заявка в непригодном исходном статусе
122900042 Нельзя отправить на согласование instagram-заявку: заявка не находится в работе
122900061 Нельзя отправить на доработку размещаемый материал instagram-заявки: заявка в непригодном исходном статусе
122900081 Нельзя отправить на доработку instagram-заявку с размещённым материалом: заявка в непригодном исходном статусе
122900101 Нельзя одобрить instagram-заявку: заявка не находилась на проверке размещения
122900121 Нельзя отклонить instagram-заявку от имени модератора: заявка находится в непригодном исходном статусе или оплачена
122900141 Нельзя отклонить instagram-заявку от имени оптимизатора: заявка находится в непригодном исходном статусе
122900142 Нельзя отклонить instagram-заявку от имени оптимизатора: заявка находится в работе
122900161 Нельзя отклонить instagram-заявку от имени вебмастера: заявка находится в непригодном исходном статусе
122900181 Нельзя отправить на доработку задания instagram-заявку: заявка не находится на размещении
122900182 Нельзя отправить на доработку задания instagram-заявку: заявка находится в работе
122900201 Нельзя разместить instagram-заявку: некорректный адрес размещения
122900281 Нельзя сохранить заявку: задано слишком большое число шагов выполнения
122900301 Нельзя принять заявку в работу: заявка находится в непригодном статусе
122900302 Нельзя принять заявку в работу: заявка уже находится в работе
122900321 Нельзя разместить instagram-заявку: заявка в непригодном исходном статусе
122900322 Нельзя разместить instagram-заявку: заявка не находится в работе
122900341 Нельзя добавить предлагаемый пост: превышен допустимый размер файла изображения
122900342 Нельзя добавить предлагаемый пост: не задан ни текст поста, ни изображение к нему
122900343 Нельзя добавить предлагаемый пост: задан неверный тип изображения
122900361 Нельзя закончить согласование заявки: заявка в непригодном исходном статусе
122900381 Ошибка проверки размещения: не задан URL размещения
122900382 Ошибка проверки размещения: нет доступа к странице размещения
122900384 Ошибка проверки размещения: screen name поста не соответствует screen name площадки
122900385 Ошибка проверки размещения: не найдено хэш-тегов или меншенов из задания
123000001 Проверка баланса: недостаточно средств для блокировки
123000021 Ошибка создания instagram-заявки: не удалось найти проект для данного оптимизатора
123000022 Ошибка создания instagram-заявки: проект находится в архиве
123000061 Проверка instagram-аккаунта для размещения: instagram-аккаунт не принимает новые твит-заявки
123000062 Проверка instagram-аккаунта для размещения: instagram-аккаунт не размещает заявки данного формата
123000063 Проверка instagram-аккаунта для размещения: нельзя создать instagram-заявку на собственном instagram-аккаунте
123000064 Проверка instagram-аккаунта для размещения: стоимость размещения превышает разрешённую
123000081 Ошибка создания instagram-заявки: бюджет проекта исчерпан
123000082 Ошибка создания instagram-заявки: в тексте задания присутствуют запрещённые слова
123000101 Ошибка создания instagram-заявки: переданы некорректные ID instagram-аккаунтов
123000102 Ошибка создания instagram-заявки: не удалось найти instagram-аккаунт
123100043 Нельзя выполнить закупку Instagram-заявок: заблокированные средства по заявкам составляют весь бюджет
123100044 Нельзя выполнить закупку Instagram-заявок: авторежим совершает закупку в данный момент
123100045 Нельзя выполнить закупку Instagram-заявок: авторежим не запущен
123100046 Нельзя выполнить закупку Instagram-заявок: проект относится к системе Wizard.Sape
123100047 Нельзя выполнить закупку Instagram-заявок: проект архивирован
123100048 Нельзя выполнить закупку Instagram-заявок: бюджет авторежима меньше минимальной цены заявки
123100061 Нельзя создать авторежим Instagram-заявок: проект относится к системе Wizard.Sape
123200002 Нельзя добавить изображение: превышен допустимый размер файла
123200003 Нельзя добавить изображение: задан неверный тип изображения
123300040 Ошибка добавления в корзину: такой элемент уже есть
123400001 Нельзя одобрить выполнение: выполнение не находится в подходящем статусе
123400002 Нельзя одобрить выполнение: заявка уже содержит максимальное число одобренных выполнений
123400021 Нельзя отклонить выполнение: выполнение не находится в статусе проверки размещения
123500001 Нельзя добавить комментарий к выполнению: слишком короткий текст
250100006 Ошибка создания заявки: недостаточно средств для блокировки
250100010 Ошибка создания заявки: недостаточно средств, покупка заявки приведёт к SLEEP-у других заявок
250100011 Ошибка создания заявки: сервис загружен. Попробуйте произвести покупку снова через несколько минут.
250101305 Невозможно переблокировать средства для переноса заявки
250200010 Ошибка создания твит-заявки: недостаточно средств, покупка заявки приведёт к SLEEP-у других заявок
250200011 Ошибка создания твит-заявки: недостаточно средств для блокировки
250201305 Невозможно переблокировать средства для переноса твит-заявки
250300006 Недостаточно средств для блокировки
250300010 Недостаточно средств (контроль бюджета; покупка заказа приведёт к SLEEP-у)
250300011 Сервис биллинга загружен (обновляются балансы пользователей)
250301305 Невозможно переблокировать средства для переноса заказа
250600006 Ошибка создания стероида: недостаточно средств для блокировки
250600010 Ошибка создания стероида: недостаточно средств, покупка стероида приведёт к SLEEP-у заявок
250600011 Ошибка создания стероида: сервис загружен. Попробуйте произвести покупку снова через несколько минут.
250701305 Невозможно переблокировать средства для переноса заявки
1300100001 Не удалось найти проект: некорректный ID проекта или владелец
1300100021 Не удалось найти площадку: некорректный ID площадки или владелец
1300100041 Не удалось найти авторежим: некорректный ID авторежима или владелец
1300100061 Не удалось найти заявку: некорректный ID заявки или владелец
1300100081 Не удалось найти заявку на соц. сети: некорректный ID заявки на соц. сети или владелец
1300100121 Не удалось найти твит-аккаунт: некорректный ID аккаунта или владелец
1300100141 Не удалось найти твит-заявку: некорректный ID твит-заявки или владелец
1300100161 Заданы некорректные настройки проекта
1300100181 Нельзя создать заявку формата "статья": не найдена статья
1300100201 Не удалось найти задание заявки: некорректный ID заявки или номер версии
1300100241 Нельзя создать твит-заявку: некорректный формат размещения
1300100242 Нельзя создать твит-заявку: не задан URL
1300100261 Не удалось найти заказ статьи: некорректный ID заказа или владелец
1300100381 Не удалось найти выполнение по социальной заявке: некорректный ID выполнения или владелец
1300200001 Ошибка авторизации: неверный логин или пароль
1300300001 Нельзя запросить добавление новой площадки: заданы некорректные параметры площадки
1300300021 Ошибка поиска площадок: некорректный формат размещения
1300300041 Нельзя обновить площадку: заданы некорректные параметры площадки
1300400001 Ошибка проверки размещения заявки
1300500001 Нельзя создать авторежим: заданы некорректные параметры
1300800001 Нельзя создать твиттер-аккаунт: не указан GUID аккаунта
1300800002 Нельзя создать твиттер-аккаунт: указанный GUID аккаунта уже зарегистрирован в системе
1300800003 Нельзя создать твиттер-аккаунт: не указан screen_name аккаунта
1300800004 Нельзя создать твиттер-аккаунт: указанный screen_name аккаунта уже зарегистрирован в системе
1300800005 Нельзя создать твиттер-аккаунт: слишком длинный Rotapost ID
1300800021 Нельзя получить твиттер-аккаунт: некорректный тип идентификатора
1300800022 Не удалось найти твиттер-аккаунт: некорректный ID аккаунта
1300800041 Нельзя обновить твиттер-аккаунт: заданы некорректные параметры аккаунта
1301000001 Раздел избранного не найден
1301000021 Ошибка создания раздела избранного
1400300011 Нельзя создать социальную заявку: указан некорректный URL
1400300012 Нельзя создать социальную заявку: указано некорректное количество размещений
1400500001 Ошибка при создании заказа контента: не удалось привязать заказ к заявке.<br/> Черновик заказа на написание контента был успешно создан, но из-за временных технических проблем заказ не привязывается к заявке PR.sape и не добавляется в саму заявку. Вы можете найти черновики заказов на странице <a href="http://articles.sape.ru/seo/order/" target="_blank">http://articles.sape.ru/seo/order/</a>. <br/> Приносим извинения за временные неудобства.
1400501100 Ошибка при обработке заказа контента: неверные входные данные
1400501200 Ошибка при обработке заказа контента: ошибка в биллинге
1400501400 Ошибка при обработке заказа контента: действие совершить невозможно
1400501402 Ошибка при обработке заказа контента: заказ уже был создан для данной заявки
1401100511 Общая ошибка: пользователь имеет приватный профиль (невозможно получить данные профиля)