Описание

Создает заказ на раскрутку. В случае успешного выполнения вернет ответ с 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 - на паузу
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.
Только для автоматических типов заданий
Специфические параметры
insurance Страховка.
При включении данной опции, в случаях санкций со стороны ВКонтакте к вашему сообществу, мы обязуемся компенсировать потраченные средства.
Может принимать следующие значения:
  • on - включена
  • off - выключена
По умолчанию - off.
Только для заданий с типом vk_community
vote_type Тип голосования
Может принимать следующие значения:
  • custom - указанные варианты
  • any - любой вариант голосования
По умолчанию - custom
Только для заданий с типом vk_poll
votes Номера вариантов голосования и количество голосующих
Должен передаваться массив в формате HTTP Array, для упрощения пример в формате JSON:
[ { index: 1, users_limit: 10 }, { index: 2, users_limit: 33 } ]
тут находятся следующие данные:
  • index - номер варианта голосования от начала
  • users_limit - количество требуемых голосов
Только для заданий с типом vk_poll
comments_type Тип комментариев
Возможные значения По умолчанию - any

Только для заказов с типами:
  • vk_comment
  • instagram_comment
  • tiktok_comment
comments Комментарии для публикации
Должен передаваться массив в формате HTTP Array, для упрощения пример в формате JSON:
[ { text: 'первый комментарий' }, { text: 'второй комментарий' } ]
тут находятся следующие данные:
  • text - текст комментария

Только для заказов с типами:
  • vk_comment
  • instagram_comment
  • tiktok_comment
like_comment_user Юзернейм комментируемого пользователя, комментарий которого нужно лайкнуть
Только для заданий с типом instagram_like
stories_to_view Количество историй для просмотра
Только для заданий с типом instagram_view_history
telegram_bot_check Проверка ботом позволяет максимально точно определять, подписался ли исполнитель на канал/группу. Если опция отключена, мы используем иные алгоритмы проверки выполнения задания, которые могут быть недостаточно точными.

Для включения опции необходимо добавить нашего бота StatisticsChannelsBot в список администраторов канала/группы. Чтобы бот был добавлен, достаточно установить ему минимальное право – Добавление подписчиков (возможно другое название этого пункта – “Добавление пользователей”, это зависит от платформы, на которой установлен Telegram).

Это безопасно, так как боту не нужно иметь никаких прав, кроме минимального. Включение опции позволяет максимально точно отслеживать, подписался ли исполнитель на канал/группу.

Может принимать следующие значения:
  • 0 - выключить
  • 1 - включить
По умолчанию - 0

Только для заданий с типом telegram_follower
Параметры таргетинга
sex Пол аудитории.
Может принимать следующие значения:
  • 0 - любой
  • 1 - женский
  • 2 - мужской
По умолчанию - 0
relation Семейное положение. Передается в виде массива.
Возможные значения По умолчанию - 0
Можно указать несколько значений
Параметр доступен только для заданий ВКонтакте
age_from Минимальный возраст исполнителя
По умолчанию - 0
age_to Максимальный возраст исполнителя
По умолчанию - 999
friends_from Минимальное количество друзей или подписчиков у исполнителя
По умолчанию - 0
Параметр доступен только для заданий:
  • ВКонтакте
  • Instagram
  • TikTok
friends_to Максимальное количество друзей или подписчиков у исполнителя
у исполнителя
По умолчанию - 9999
Параметр доступен только для заданий:
  • ВКонтакте
  • Instagram
  • TikTok
subscribes_from Минимальное количество подписок исполнителя
По умолчанию - 0
Параметр доступен только для заданий:
  • Instagram
  • TikTok
subscribes_to Максимальное количество подписок у исполнителя
По умолчанию - 99999
Параметр доступен только для заданий:
  • Instagram
  • TikTok
profile_photos_from Минимальное количество фотографий профиля у исполнителя
По умолчанию - 0
Только для заданий ВКонтакте
profile_photos_to Максимальное количество фотографий профиля у исполнителя
По умолчанию - 999
Только для заданий ВКонтакте
records_from Минимальное количество записей на странице или публикаций исполнителя
По умолчанию - 0
Параметр доступен только для заданий:
  • ВКонтакте
  • Instagram
  • TikTok
records_to Максимальное количество записей на странице или публикаций исполнителя
По умолчанию - 99999
Параметр доступен только для заданий:
  • ВКонтакте
  • Instagram
  • TikTok
reg_type Тип времени с момента регистрации исполнителя
По умолчанию - month
Может принимать следующие значения:
  • month - месяц
  • year - год
Параметр доступен только для заданий:
  • ВКонтакте
  • Instagram
reg_num Количество месяцев/лет с момента регистрации исполнителя
По умолчанию - 0
Параметр доступен только для заданий ВКонтакте и Instagram
country_id ID страны исполнителя. Передается в виде массива
Список ID стран можно получить методом util.getCountries
Можно указать до 20 стран
city_id ID городов исполнителя. Передается в виде массива. При передаче 2-х и более стран в параметре country_id параметр city_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 Достигнут лимит количества новых записей