Описание
Получение списка заказов.
Пример запроса:
https://vkserfing.ru/api/campaign.get?token=a56a7e1rwr358ee0c14c0e58d992da436
Пример ответа:
{
"status": "success",
"data": {
"total": 1,
"count": 1,
"list": [
{
"id": "363187",
"parent_id": "0",
"name": "ere",
"type": "vk_community",
"insurance": "off",
"link": "https://vk.com/public23414124",
"adult": "off",
"time": "2018-06-05 19:31:13",
"status": "pause",
"vote_type": "custom",
"votes": [
{ "index": 3, "votes": 10 },
{ "index": 5, "votes": 20 },
],
"comments_type": "custom",
"comments": [
{ "text": "test comment" }
],
"targeting": {
"sex": "0",
"relation": "0",
"age_from": "0",
"age_to": "999",
"friends_from": "0",
"friends_to": "9999",
"subscribes_from": "0",
"subscribes_to": "9999",
"profile_photos_from": "0",
"profile_photos_to": "999",
"records_from": "0",
"records_to": "99999",
"month_reg_period": "0",
"limit_per_day": "480",
"automatic_records_limit": "0",
"country": {
"id": "1",
"name": "Россия"
},
"city": null
},
"money": {
"spent": "5",
"per_user": "0.5"
},
"users": {
"limit_total": "100",
"current": "10",
"limit_system_per_hour": "20",
"users_limit_random": "off",
"automatic_current": "0",
"automatic_records": "0"
},
"project": null
}
]
}
}Параметры
| Название | Описание |
|---|---|
| count | Количество записей, необходимое получить. Не может превышать значение 200. По умолчанию 10 |
| offset | Смещение, необходимое для выборки определенного подмножества записей. По умолчанию 0 |
| id |
Поиск по ID заказа. Можно указывать как единичный ID, так и перечисление. Для передачи нескольких ID они должны быть разделены запятой. Пример: 345440,827230,52542 |
| parent_id | ID главного задания (автозаказы), от которого создаются автоматические подзадания |
| platform |
Соцсеть задания
Может принимать следующие значения:
|
| type |
Тип заданий.
|
| project_id | ID папки. Выводит задания которые вложены в указанную папку |
| status |
Статус фильтруемых заказов. Допустимые значения:
|
| insurance |
Страховка. Возможные значения
|
| adult |
Материалы для взрослых (18+). Может принимать следующие значения:
|
| users_from | Минимальное значение человек которое выполнило задания |
| users_to | Максимальное значение человек которое выполнило задания |
| date_from | Минимальная дата создания задания. Формат DD.MM.YYYY |
| date_to | Максимальная дата создания задания. Формат DD.MM.YYYY |
| fields |
Дополнительные поля. Перечисляются через запятую. Список дополнительных полей:
|
Параметры ответа
| Название | Описание |
|---|---|
| total | Общее количество найденных результатов. Используется для организации постраничного вывода |
| count | Количество возращаемых результатов |
| Объект списка (list). Общая информация. | |
| id | ID заказа |
| parent_id | ID главного задания (автозадания), от которого создаются автоматические подзадания |
| name | Название |
| type |
Тип задания.
|
| insurance |
Страховка.
Может принимать следующие значения:
|
| adult |
Материалы для взрослых (18+).
Может принимать следующие значения:
|
| time | Дата создания заказа. |
| status |
Статус заказа.
Может принимать следующие значения:
|
| link | Ссылка на задание |
| vote_type |
Тип голосования Может принимать следующие значения:
|
| votes |
Номера вариантов голосования и количество голосующих Пример массива:
|
| comments_type |
Тип комментариев Может принимать следующие значения:
|
| comments |
Комментарии для публикации Пример массива:
|
| like_comment_user |
Юзернейм комментируемого пользователя, комментарий которого нужно лайкнуть Только для заданий с типом instagram_like |
| stories_to_view |
Количество сторис для просмотра Только для заданий с типом instagram_view_history |
| Объект таргетинга (list — targeting). Параметры таргетирования. | |
| sex |
Пол аудитории.
Может принимать следующие значения:
|
| relation |
Семейное положение.
Может принимать следующие значения:
|
| age_from | Минимальный возраст исполнителя |
| age_to | Максимальный возраст исполнителя |
| friends_from | Минимальное количество друзей у исполнителя |
| friends_to | Максимальное количество друзей у исполнителя |
| subscribes_from | Минимальное количество подписок у исполнителя |
| subscribes_to | Максимальное количество подписок у исполнителя |
| profile_photos_from | Минимальное количество фотографий профиля у исполнителя |
| profile_photos_to | Максимальное количество фотографий профиля у исполнителя |
| records_from | Минимальное количество записей на странице исполнителя |
| records_to | Максимальное количество записей на странице исполнителя |
| month_reg_period | Минимальное количество месяцев с момента регистрации исполнителя |
| limit_per_day | Лимит исполнителей в сутки |
| automatic_records_limit |
Количество новых постов 0 - без ограничений Только для автоматических типов заказов |
| Объект средств (list — money). Информация о расходе средств. | |
| spent | Израсходовано средств |
| per_user | Стоимость одного исполнителя |
| Объект исполнителей (list — users). Информация о выполнении. | |
| limit_total | Количество исполнителей |
| limit_system_per_hour | Системная скорость исполнителей в час |
| current | Текущее количество выполнений |
| left | Количество оставшихся выполнений |
| users_limit_random |
Варьировать количество исполнителей Значения:
|
| automatic_current | Суммарное количество выполнений по всем подзаданиям Только для автоматических типов заданий |
| automatic_records | Количество созданных позаданий Только для автоматических типов заданий |
| members_before |
Количество пользователей по ссылке до начала выполнения заказа Опциональное поле. Выводится при указании его в параметре fields |
| preview |
Превью заказа (изображение профиля/группы/страницы) Опциональное поле. Выводится при указании его в параметре fields |
| Объект папки проекта (list — project) | |
| id | ID папки |
| name | Название папки |