Описание

Создает заказ на раскрутку. В случае успешного выполнения вернет ответ с ID созданного заказа.

Пример запроса:

https://vkserfing.ru/api/campaign.add?token=a56a7e1rwr358ee0c14c0e58d992da436&link=http://vk.com/club31231231&type=vk_community&status=on

Пример запроса с указанием нескольких значений городов и семейного положения:

https://vkserfing.ru/api/campaign.add?token=a56a7e1rwr358ee0c14c0e58d992da436&link=http://vk.com/club31231231&type=vk_community&relation[]=1&relation[]=2&city[]=1&city[]=2

Пример ответа:

{
    status: 'success',
    data: { id: 23432 }
}
Параметры
Название Описание
name Название
type
обязательный параметр
Тип задания.
Возможные значения
project_id ID папки
link
обязательный параметр
Ссылка на задание.
status
обязательный параметр
Статус заказа.
Может принимать следующие значения:
  • on - запустить
  • pause - на паузу
insurance Страховка.
При включении данной опции, в случаях санкций со стороны ВКонтакте к вашему сообществу, мы обязуемся компенсировать потраченные средства.
Может принимать следующие значения:
  • on - включена
  • off - выключена
По умолчанию - off.
adult Материалы для взрослых (18+).
Может принимать следующие значения:
  • on - содержит
  • off - не содержит
По умолчанию - off.
amount_users_limit
обязательный параметр для всех типов заданий кроме vk_poll
Количество исполнителей.
amount_users_limit_of_day Лимит исполнителей в сутки.
По умолчанию - 480
users_limit_random Варьировать количество исполнителей
По умолчанию - off
Допустимые значения:
  • on - включено
  • off - выключено
Только для автоматических типов заданий
amount_automatic_records_limit Количество новых постов (лимит, определяющий сколько заданий будет создано)
  • пустое значение или параметр не передан - без ограничений
  • 0 - новые публикации сканироваться не будут
Только для автоматических типов заданий
amount_automatic_old_records_limit Количество существующих публикаций, на которые будут созданы автозадания.
Параметр может принимать значения от 0 до 100.
vote_type Тип голосования
Может принимать следующие значения:
  • custom - указанные варианты
  • any - любой вариант голосования
По умолчанию - custom
votes Номера вариантов голосования и количество голосующих
Должен передаваться массив в формате HTTP Array, для упрощения пример в формате JSON:
[ { index: 1, users_limit: 10 }, { index: 2, users_limit: 33 } ]
тут находятся следующие данные:
  • index - номер варианта голосования от начала
  • users_limit - количество требуемых голосов
comments_type Тип комментариев
Возможные значения По умолчанию - any
comments Комментарии для публикации
Должен передаваться массив в формате HTTP Array, для упрощения пример в формате JSON:
[ { text: 'первый комментарий' }, { text: 'второй комментарий' } ]
тут находятся следующие данные:
  • text - текст комментария
like_comment_user Юзернейм комментируемого пользователя, комментарий которого нужно лайкнуть
Только для заданий с типом instagram_like
stories_to_view Количество сторис для просмотра
Только для заданий с типом instagram_view_history
sex Пол аудитории.
Может принимать следующие значения:
  • 0 - любой
  • 1 - женский
  • 2 - мужской
По умолчанию - 0
relation Семейное положение. Передается в виде массива.
Возможные значения По умолчанию - 0
Можно указать несколько значений
age_from Минимальный возраст исполнителя
По умолчанию - 0
age_to Максимальный возраст исполнителя
По умолчанию - 999
friends_from Минимальное количество друзей у исполнителя
По умолчанию - 0
friends_to Максимальное количество друзей у исполнителя
По умолчанию - 9999
subscribes_from Минимальное количество подписок исполнителя
По умолчанию - 0
Только для заданий Instagram
subscribes_to Максимальное количество подписок у исполнителя
По умолчанию - 99999
Только для заданий Instagram
profile_photos_from Минимальное количество фотографий профиля у исполнителя
По умолчанию - 0
profile_photos_to Максимальное количество фотографий профиля у исполнителя
По умолчанию - 999
records_from Минимальное количество записей на странице/публикаций/пр. исполнителя
По умолчанию - 0
records_to Максимальное количество записей на странице/публикаций/пр. исполнителя
По умолчанию - 99999
reg_type Тип времени с момента регистрации исполнителя
По умолчанию - month
  • month
  • year
reg_num Количество месяцев/лет с момента регистрации исполнителя
По умолчанию - 0
country_id ID страны исполнителя
Список ID стран можно получить методом util.getCountries
city_id ID городов исполнителя. Передается в виде массива
Список ID городов можно получить на util.getCities
Можно указать до 50 городов
Ошибки
Название Описание
NOT_AVAILABLE Недостаточно прав для проведения операции. Возможно, вам была отключена возможность создавать заказы
INCORRECT_LINK Некорректная ссылка заказа. Ссылка должна соотвествовать выбранному типу задания
EXIST_CAMPAIGN Такой заказ уже существует
BANNED_CAMPAIGN Такой заказ заблокирован
MODERATE_CAMPAIGNS У вас есть заказы на модерации, для создания новых необходимо дождаться их рассмотрения
USER_THIS_CAMPAIGN_ON У вас уже имеется такая же запущенный заказ
ALL_THIS_CAMPAIGN_ON В базе всех заказов уже имеется такая же запущенный заказ
NOT_EXIST_COMMUNITY Такого сообщества не существует
DELETED_COMMUNITY Такого сообщества не существует или удалено
REQUIRED_PUBLIC_COMMUNITY Сообщество должно быть открытым
REQUIRED_PHOTO_COMMUNITY У сообщества должна быть установлена главная фотография (аватарка)
REQUIRED_WALL_ITEMS_COMMUNITY В сообществе должно быть не менее 5 записей
NOT_EXIST_USER Такого пользователя не существует
DELETED_USER Такого пользователя не существует либо он удален или заблокирован
NOT_AVAILABLE_WALL_ITEM Чтобы создать задание, в настройках приватности страницы https://vk.com/settings?act=privacy (страницы, относящейся к указываемой записи) в параметре "Кому в интернете видна моя страница" установите значение "Всем"
NOT_AVAILABLE_PHOTO_ITEM Фото не существует или скрыто настройками приватности или находится в папке "Сохраненные фотографии"
USERS_LIMIT Достигнут лимит исполнителей для этого заказа
NEW_RECORDS_LIMIT Достигнут лимит количества новых записей