Маркетинг и продвижение (promotion)

Узнать больше о маркетинге и продвижении можно в справочном центре

Методы маркетинга и продвижения позволяют:

Получать информацию о кампаниях продвижения и медиакампаниях.
Создавать и управлять кампаниями.
Настраивать параметры кампаний — кластеры фраз, продвигаемые товары и так далее.
Управлять финансами кампаний.
Выгружать статистику кампаний продвижения и медиакампаний.
Работать с календарём акций.

Данные синхронизируются с базой раз в 3 минуты. Статусы кампаний меняются раз в минуту. Ставки кампаний меняются раз в 30 секунд.

Маркетинг и продвижение

Узнать больше о маркетинге и продвижении можно в справочном центре

Методы маркетинга и продвижения позволяют:

Получать информацию о кампаниях продвижения и медиакампаниях.
Создавать и управлять кампаниями.
Настраивать параметры кампаний — кластеры фраз, продвигаемые товары и так далее.
Управлять финансами кампаний.
Выгружать статистику кампаний продвижения и медиакампаний.
Работать с календарём акций.

Данные синхронизируются с базой раз в 3 минуты. Статусы кампаний меняются раз в минуту. Ставки кампаний меняются раз в 30 секунд.

Кампании

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

Методы получения списков рекламных кампаний, информации о кампаниях и информации о кампаниях с ручной ставкой

Списки кампаний{{ /adv/v1/promotion/count }}

Описание метода

Метод возвращает списки всех рекламных кампаний продавца с их ID. Кампании сгруппированы по типу и статусу, у каждой указана дата последнего изменения.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	5 запросов	200 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

Responses

Response samples

200
401
429

Content type

application/json

{"adverts": [{"type": 4,
"status": 8,
"count": 3,
"advert_list": [{"advertId": 6485174,
"changeTime": "2023-05-10T12:12:52.676254+03:00"
},
{"advertId": 6500443,
"changeTime": "2023-05-10T17:08:46.370656+03:00"
},
{"advertId": 7936341,
"changeTime": "2023-07-12T15:51:08.367478+03:00"
}
]
}
],
"all": 3
}

Информация о кампаниях{{ /adv/v1/promotion/adverts }}

Описание метода

Метод возвращает информацию о рекламных кампаниях по их статусам, типам и ID.

Для получения информации о кампаниях с ручной ставкой используйте отдельный метод.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	5 запросов	200 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

query Parameters

status	integer Enum: -1 4 7 8 9 11 Статус кампании: `-1` — удалена, процесс удаления будет завершён в течение 10 минут `4` — готова к запуску `7` — завершена `8` — отменена `9` — активна `11` — на паузе
type	integer Enum: 4 5 6 7 8 Тип кампании: `4` — в каталоге (устаревший тип) `5` — в карточке товара (устаревший тип) `6` — в поиске (устаревший тип) `7` — в рекомендациях на главной странице (устаревший тип) `8` — единая ставка
order required	string Enum: "create" "change" "id" Порядок: `create` — по времени создания кампании `change` — по времени последнего изменения кампании `id` — по ID кампании
direction	string Enum: "desc" "asc" Направление: `desc` — от большего к меньшему `asc` — от меньшего к большему

Request Body schema: application/json
required

Array

integer

Список ID кампаний. Максимум 50.

Получить ID кампаний можно методом Списки кампаний

Responses

Request samples

Payload

Content type

application/json

[1234567,
63453471
]

Response samples

200
400
401
422
429

Content type

application/json

Example

ResponseInfoAdvertType8

[{"endTime": "2023-10-05T21:37:37.226021+03:00",
"createTime": "2023-08-21T13:45:31.121172+03:00",
"changeTime": "2023-08-21T14:59:33.622594+03:00",
"startTime": "2023-08-21T13:45:31.147601+03:00",
"autoParams": {"subject": {"name": "Обложки",
"id": 342
},
"sets": [{"name": "для женщин",
"id": 623
}
],
"nms": [1234567
],
"active": {"carousel": true,
"recom": true,
"booster": true
},
"nmCPM": [{"nm": 1234567,
"cpm": 150
}
]
},
"name": "Кампания1",
"dailyBudget": 0,
"advertId": 11111111,
"status": 7,
"type": 8,
"paymentType": "cpm"
}
]

Информация о кампаниях с ручной ставкой{{ /adv/v0/auction/adverts }}

Описание метода

Метод возвращает информацию о рекламных кампаниях с ручной ставкой по их статусам, типам оплаты и ID.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	5 запросов	200 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

query Parameters

ids	Array of strings [ 1 .. 50 ] items Example: ids=12345,23456,34567,45678,56789 ID кампаний
statuses	Array of strings Example: statuses=-1,4,8 Статусы кампаний: `-1` — удалена, процесс удаления будет завершён в течение 10 минут `4` — готова к запуску `7` — завершена `8` — отменена `9` — активна `11` — на паузе
payment_type	string Enum: "cpm" "cpc" Тип оплаты: `cpm` — за показы `cpc` — за клик

Responses

Response samples

200
400
401
429

Content type

application/json

{"adverts": [{"id": 18298989,
"nm_settings": [{"bids": {"recommendations": 0,
"search": 150
},
"subject": {"id": 69,
"name": "платья"
},
"nm_id": 139312996
}
],
"settings": {"name": "Кампания 34",
"payment_type": "cpc",
"placements": {"recommendations": false,
"search": true
}
},
"status": 7,
"timestamps": {"created": "2024-06-28T15:49:02.031402+03:00",
"deleted": "2024-07-03T13:53:42.260198+03:00",
"started": "2024-07-01T23:32:09.083098+03:00",
"updated": "2025-07-30T10:23:55.719721+03:00"
}
}
]
}

Создание кампаний

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

Методы создания кампаний с единой или ручной ставкой, а также получения:

Конфигурационные значения Продвижения{{ /adv/v0/config }} Deprecated

Описание метода

Метод возвращает допустимые значения основных параметров конфигурации кампаний: например, минимальные ставки, доступные категории и максимальное количество товаров, которые можно добавить в кампанию.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	1 запрос	1 минута	1 запрос

Authorizations:

HeaderApiKey

Responses

Response samples

200
401
429

Content type

application/json

{"categories": [{"id": 760,
"name": "Автомобильные товары",
"cpm_min": 112
}
],
"config": [{"description": "Минимальный бюджет кампании",
"name": "budget_min",
"value": "1000"
},
{"description": "Максимальный период в днях, за который можно получить статистику",
"name": "api_fullstat_day_depth",
"value": "31"
},
{"description": "Минимальная ставка CPM для кампаний с ручной ставкой",
"name": "cpm_min_booster",
"value": "100"
},
{"description": "Минимальная ставка CPM для кампаний с единой ставкой",
"name": "cpm_min_search_catalog",
"value": "150"
},
{"description": "Максимальное количество товаров для кампаний с ручной ставкой",
"name": "max_nm_count",
"value": "50"
},
{"description": "Максимальное количество товаров для кампаний с единой ставкой",
"name": "max_auto_nms",
"value": "100"
}
]
}

Минимальные ставки для карточек товаров{{ /adv/v0/bids/min }}

Описание метода

Метод возвращает минимальные ставки для карточек товаров по типу оплаты и зонам показа кампании.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	20 запросов	3 секунды	5 запросов

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

advert_id required	integer <int64> ID кампании
nm_ids required	Array of integers <int64> [ 1 .. 100 ] characters [ items <int64 > ] Список артикулов WB
payment_type required	string Enum: "cpm" "cpc" Тип оплаты: - `cpm` — за показы - `cpc` — за клик
placement_types required	Array of strings Items Enum: "combined" "search" "recommendation" Зоны показов: `search` — поиск `recommendation` — рекомендации `combined` — поиск и рекомендации

Responses

Request samples

Payload

Content type

application/json

{"advert_id": 98765432,
"nm_ids": [12345678,
87654321
],
"payment_type": "cpm",
"placement_types": ["combined",
"search",
"recommendation"
]
}

Response samples

200
400
401
429

Content type

application/json

{"bids": [{"bids": [{"type": "combined",
"value": 155
},
{"type": "search",
"value": 250
},
{"type": "recommendation",
"value": 250
}
],
"nm_id": 12345678
},
{"bids": [{"type": "combined",
"value": 155
},
{"type": "search",
"value": 250
},
{"type": "recommendation",
"value": 250
}
],
"nm_id": 87654321
}
]
}

Создать кампанию с единой ставкой{{ /adv/v1/save-ad }} Deprecated

Описание метода

Метод создаёт кампанию с единой ставкой для продвижения товаров в:

каталоге
поиске
карточках товаров
рекомендациях на главной странице WB

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
20 секунд	1 запрос	20 секунд	5 запросов

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

type	integer Тип кампании с единой ставкой: `8`
name	string Название кампании (max. 128 символов)
subjectId	integer ID предмета, для которого создается кампания. Существующие у продавца ID можно получить методом из раздела "Контент / Просмотр" — "Список НМ", поле ответа — `subjectID`.
sum	integer Сумма пополнения
btype	integer Tип списания: `0` — Счёт `1` — Баланс `3` — Бонусы
on_pause	boolean Кампания после создания: `true` — будет на паузе. Запуск кампании будет доступен через 3 минуты после создания кампании. `false` — будет сразу запущена
nms	Array of integers Массив артикулов WB. Максимум 100 артикулов.
cpm	integer Ставка. Если будет указана ставка меньше допустимого размера, то автоматически установится ставка минимально допустимого размера.

Responses

Request samples

Payload

Content type

application/json

{"type": 8,
"name": "Парашюты",
"subjectId": 270,
"sum": 500,
"btype": 1,
"on_pause": true,
"nms": [9178363,
9178364
],
"cpm": 10
}

Response samples

200
400
401
422
429

Content type

application/json

"9008917"

Создать кампанию{{ /adv/v2/seacat/save-ad }}

Описание метода

Метод создаёт кампанию:

с ручной ставкой для продвижения товаров в поиске и/или рекомендациях
с единой ставкой для продвижения товаров одновременно в поиске и рекомендациях

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	5 запросов	12 секунд	5 запросов

Authorizations:

HeaderApiKey

Request Body schema: application/json

name	string Название кампании
nms	Array of integers Карточки товаров для кампании. Доступные карточки товаров можно получить с помощью метода Карточки товаров для кампаний. Максимум 50 товаров (`nm`)
bid_type	string Default: "manual" Enum: "manual" "unified" Тип ставки: `manual` — ручная `unified` — единая
placement_types	Array of strings Default: "search" Items Enum: "search" "recommendations" Зоны показов: `search` — в поиске `recommendations` — в рекомендациях Укажите только для кампании с ручной ставкой

Responses

Request samples

Payload

Content type

application/json

{"name": "Телефоны",
"nms": [146168367,
200425104
],
"bid_type": "manual",
"placement_types": ["search",
"recommendations"
]
}

Response samples

200
400
401
429

Content type

application/json

1234567

Предметы для кампаний{{ /adv/v1/supplier/subjects }}

Описание метода

Метод возвращает список предметов, которые можно добавить в рекламную кампанию.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
12 секунд	1 запрос	12 секунд	5 запросов

Authorizations:

HeaderApiKey

Responses

Response samples

200
401
429

Content type

application/json

Example

Array

[{"name": "3D очки",
"id": 2560,
"count": 1899
}
]

Карточки товаров для кампаний{{ /adv/v2/supplier/nms }}

Описание метода

Метод возвращает список карточек товаров, которые можно добавить в рекламную кампанию. Для получения карточек необходимы ID предметов, также доступных для добавления в кампанию.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	5 запросов	12 секунд	5 запросов

Authorizations:

HeaderApiKey

Request Body schema: application/json

ID предметов, для которых нужно получить карточки товаров

Array

integer

Responses

Request samples

Payload

Content type

application/json

[123,
456,
765,
321
]

Response samples

200
400
401
429

Content type

application/json

[{"title": "Плед",
"nm": 146168367,
"subjectId": 765
}
]

Управление кампаниями

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

С помощью методов управления кампаниями вы можете:

Удалить кампанию
Переименовать кампанию
Запустить кампанию
Поставить кампанию на паузу
Завершить кампанию
Изменить ставки в кампаниях
Изменить места размещения в кампаниях с ручной ставкой
Изменить ставки в кампаниях с ручной ставкой

Удаление кампании{{ /adv/v0/delete }}

Описание метода

Метод удаляет кампании в статусе 4 — готова к запуску.

После удаления кампания некоторое время будет находиться в статусе -1 — кампания в процессе удаления. Полное удаление кампании занимает от 3 до 10 минут.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	5 запросов	200 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

ID кампании

Responses

Response samples

400
401
429

Content type

application/json

Некорректный ID кампании

{"error": "Некорректный ID кампании"
}

Переименование кампании{{ /adv/v0/rename }}

Описание метода

Метод меняет название кампании. Это можно сделать в любой момент существования кампании.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	5 запросов	200 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

Request Body schema: application/json

advertId required	integer ID кампании, в которой меняется название
name required	string Новое название (максимум 100 символов)

Responses

Request samples

Payload

Content type

application/json

{"advertId": 2233344,
"name": "newnmame"
}

Response samples

400
401
422
429

Content type

text/plain

Example

InvalidRcIdAdv

Некорректный ID РК

Запуск кампании{{ /adv/v0/start }}

Описание метода

Метод запускает кампании в статусах 4 — готово к запуску — или 11 — пауза.

Чтобы запустить кампанию со статусом 4, необходимо выполнить два условия:

После создания кампании в кабинете WB. Продвижение нажать кнопку Применить изменения.
Установить бюджет — максимальную сумму затрат на кампанию.

Чтобы запустить кампанию со статусом 11, проверьте ее бюджет. Если бюджета недостаточно, пополните его.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	5 запросов	200 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1234

ID кампании

Responses

Response samples

400
401
422
429

Content type

application/json

Example

IncorrectId

Некорректный ID кампании

{"error": "Invalid Advert: invalid advert"
}

Пауза кампании{{ /adv/v0/pause }}

Описание метода

Метод ставит кампании в статусе 9 — активна — на паузу.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	5 запросов	200 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1234

ID кампании

Responses

Response samples

400
401
422
429

Content type

application/json

Example

IncorrectId

Некорректный ID кампании

{"error": "Invalid Advert: invalid advert"
}

Завершение кампании{{ /adv/v0/stop }}

Описание метода

Метод завершает кампании в статусах:

4 — готово к запуску
9 — активна
11 — пауза

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	5 запросов	200 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1234

ID кампании

Responses

Response samples

400
401
422
429

Content type

application/json

Example

IncorrectId

Некорректный ID кампании

{"error": "Invalid Advert: invalid advert"
}

Изменение ставок{{ /adv/v0/bids }}

Описание метода

Метод меняет ставки карточек товаров по артикулам WB в кампаниях с единой ставкой.

Для кампаний в статусах 4, 9 и 11.

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

Минимально допустимые ставки вы можете получить в ответе метода получения минимальных ставок для карточек товаров.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	5 запросов	200 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

required

Array of objects (V0AdvertMultibid) <= 20 items

Responses

Request samples

Payload

Content type

application/json

{"bids": [{"advert_id": 6348555,
"nm_bids": [{"nm": 3462354,
"bid": 500
}
]
}
]
}

Response samples

400
401
429

Content type

application/json

Example

CampaignIsNotUnique

Повторяется ID кампании.
В .bids[n] указана позиция кампании в массиве запроса bids

{"errors": [{"detail": "advert 1234567 is not unique",
"field": ".bids[2]"
}
],
"request_id": "2c991dcab0fe971e8c0321c340a8c7fd",
"status": 400,
"title": "invalid payload",
"type": "Bad Request"
}

Изменение мест размещения в кампаниях с ручной ставкой{{ /adv/v0/auction/placements }}

Описание метода

Метод меняет места размещения в кампаниях с ручной ставкой.

Для кампаний в статусах 4, 9 и 11.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	1 запрос	1 секунда	1 запрос

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

required

Array of objects <= 50 items

Места размещения в кампаниях

Responses

Request samples

Payload

Content type

application/json

{"placements": [{"advert_id": 12345,
"placements": {"search": true,
"recommendations": true
}
}
]
}

Response samples

400
401
429

Content type

application/json

{"detail": "can not deserialize response body",
"origin": "camp-api-public-cache",
"request_id": "9a929a81ea9dc1601fcc4be81f32c1cb",
"status": 400,
"title": "invalid payload"
}

Изменение ставок в кампаниях с ручной ставкой{{ /adv/v0/auction/bids }}

Описание метода

Метод меняет ставки карточек товаров по артикулам WB в разных местах размещения в кампаниях с ручной ставкой.

Для кампаний в статусах 4, 9 и 11.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	5 запросов	200 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

required

Array of objects <= 50 items

Ставки в кампаниях

Responses

Request samples

Payload

Content type

application/json

{"bids": [{"advert_id": 12345,
"nm_bids": [{"nm_id": 13335157,
"bid": 250,
"placement": "recommendations"
}
]
}
]
}

Response samples

200
400
401
429

Content type

application/json

{"bids": [{"advert_id": 12345,
"nm_bids": [{"nm_id": 13335157,
"bid": 250,
"placement": "recommendations"
}
]
}
]
}

Параметры кампаний

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

Методы управления параметрами рекламных кампаний после их запуска:

Управление активностью и установка/удаление фиксированных фраз.
Установка/удаление минус-фраз:
1. В поиске
2. Для кампании с единой ставкой
Получение и изменение списка карточек товаров в кампаниях с единой ставкой.
Изменение списка карточек товаров в кампаниях с ручной ставкой.

Управление активностью фиксированных фраз{{ /adv/v1/search/set-plus }}

Описание метода

Метод делает активными или неактивными фиксированные фразы в кампаниях с ручной ставкой. Фиксированные фразы нужны, чтобы товар отображался в поиске только по определенным поисковым запросам.

Установить или удалить фиксированные фразы можно через отдельный метод.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
500 миллисекунд	1 запрос	500 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

query Parameters

id required	integer Example: id=1234567 ID кампании
fixed	boolean Новое состояние (`false` — сделать неактивными, `true` — сделать активными)

Responses

Response samples

401
429

Content type

application/json

{"title": "unauthorized",
"detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
"code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
"requestId": "7b80742415072fe8b6b7f7761f1d1211",
"origin": "s2s-api-auth-catalog",
"status": 401,
"statusText": "Unauthorized",
"timestamp": "2024-09-30T06:52:38Z"
}

Установка/удаление фиксированных фраз{{ /adv/v1/search/set-plus }}

Описание метода

Метод устанавливает и удаляет фиксированные фразы в кампаниях с ручной ставкой. Фиксированные фразы можно выбрать в списке ключевых фраз кампании, который формируется после запуска.

Отправка пустого массива в методе удаляет все фиксированные фразы и отключает активность всех фиксированных фраз кампании.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
500 миллисекунд	1 запрос	500 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1234567

ID кампании

Request Body schema: application/json
required

pluse

Array of strings

Список фиксированных фраз (max. 100)

Responses

Request samples

Payload

Content type

application/json

{"pluse": ["Фраза 1",
"Фраза 2"
]
}

Response samples

200
401
429

Content type

application/json

["Фраза 1",
"Фраза 2"
]

Установка/удаление минус-фраз фразового соответствия{{ /adv/v1/search/set-phrase }} Deprecated

Описание метода

Метод будет отключен 30 сентября

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	2 запроса	500 миллисекунд	2 запроса

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1234567

ID кампании

Request Body schema: application/json
required

phrase

Array of strings

Минус-фразы (макс. 1000 шт.)

Responses

Request samples

Payload

Content type

application/json

{"phrase": ["сло",
"гу"
]
}

Response samples

401
429

Content type

application/json

{"title": "unauthorized",
"detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
"code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
"requestId": "7b80742415072fe8b6b7f7761f1d1211",
"origin": "s2s-api-auth-catalog",
"status": 401,
"statusText": "Unauthorized",
"timestamp": "2024-09-30T06:52:38Z"
}

Установка/удаление минус-фраз точного соответствия{{ /adv/v1/search/set-strong }} Deprecated

Описание метода

Метод будет отключен 30 сентября

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	2 запроса	500 миллисекунд	2 запроса

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1234567

ID кампании

Request Body schema: application/json
required

strong

Array of strings

Минус-фразы (макс. 1000 шт.)

Responses

Request samples

Payload

Content type

application/json

{"strong": ["стоять",
"лопата"
]
}

Response samples

401
429

Content type

application/json

{"title": "unauthorized",
"detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
"code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
"requestId": "7b80742415072fe8b6b7f7761f1d1211",
"origin": "s2s-api-auth-catalog",
"status": 401,
"statusText": "Unauthorized",
"timestamp": "2024-09-30T06:52:38Z"
}

Установка/удаление минус-фраз в поиске{{ /adv/v1/search/set-excluded }}

Описание метода

Метод устанавливает и удаляет минус-фразы в поиске, в кампаниях с ручной ставкой.

Данные фразы можно выбрать из списка запросов, по которым покупатели находили ваш товар. Список запросов можно получить в статистике ключевых фраз.
Максимально допустимое количество минус-фраз в кампании — 1000.

Отправка пустого массива удаляет все минус-фразы из поиска из кампании.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	2 запроса	500 миллисекунд	2 запроса

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1234567

ID кампании

Request Body schema: application/json
required

excluded

Array of strings

Список минус-фраз, до 1000 фраз

Responses

Request samples

Payload

Content type

application/json

{"excluded": ["что-то синее",
"картошечка"
]
}

Response samples

401
429

Content type

application/json

{"title": "unauthorized",
"detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
"code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
"requestId": "7b80742415072fe8b6b7f7761f1d1211",
"origin": "s2s-api-auth-catalog",
"status": 401,
"statusText": "Unauthorized",
"timestamp": "2024-09-30T06:52:38Z"
}

Установка/удаление минус-фраз для кампании с единой ставкой{{ /adv/v1/auto/set-excluded }}

Описание метода

Метод устанавливает и удаляет минус-фразы для кампании с единой ставкой.

Данные фразы можно выбрать из списка запросов, по которым покупатели находили ваш товар. Список запросов можно получить в статистике ключевых фраз.

Отправка пустого массива удаляет все минус-фразы из кампании.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
6 секунд	1 запрос	6 секунд	5 запросов

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1234567

ID кампании

Request Body schema: application/json
required

excluded

Array of strings

Список минус-фраз, до 1000 фраз

Responses

Request samples

Payload

Content type

application/json

Example

SettingMinusPhrase

Установка минус-фраз

{"excluded": ["первая фраза",
"вторая фраза"
]
}

Response samples

400
401
429

Content type

application/json

Example

InvalidCampaignId

Некорректный ID кампании

{"error": "Invalid Params: invalid advert ID"
}

Список карточек товаров для кампании с единой ставкой{{ /adv/v1/auto/getnmtoadd }}

Описание метода

Метод формирует список карточек товаров, которые можно добавить в кампанию с единой ставкой.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	1 запрос	1 секунда	5 запросов

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1

ID кампании

Responses

Response samples

200
400
401
429

Content type

application/json

[1111111111,
2222222222,
3333333333,
4444444444
]

Изменение списка карточек товаров в кампании с единой ставкой{{ /adv/v1/auto/updatenm }}

Описание метода

Метод добавляет и удаляет карточки товаров в кампании с единой ставкой.

Добавить можно только те карточки товаров, которые вернутся в списке карточек товаров для кампании с единой ставкой.
Удалить единственную карточку товара из кампании нельзя.

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

Если пришел ответ со статус-кодом 200, а изменений не произошло, проверьте, чтобы запрос соответствовал документации.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	60 запросов	1 секунда	5 запросов

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1

ID кампании

Request Body schema: application/json
required

add	Array of integers Карточки товаров, которые необходимо добавить
delete	Array of integers Карточки товаров, которые необходимо удалить

Responses

Request samples

Payload

Content type

application/json

{"add": [11111111,
44444444
],
"delete": [55555555
]
}

Response samples

400
401
429

Content type

application/json

{"error": "Не найдено"
}

Изменение списка карточек товаров в кампаниях с ручной ставкой{{ /adv/v0/auction/nms }}

Описание метода

Метод добавляет и удаляет карточки товаров в кампаниях с ручной ставкой.

Для кампаний в статусах 4, 9 и 11.

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

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	1 запрос	1 секунда	1 запрос

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

required

Array of objects <= 20 items

Карточки товаров в кампаниях

Responses

Request samples

Payload

Content type

application/json

{"nms": [{"advert_id": 12345,
"nms": {"add": [11111111,
44444444
],
"delete": [55555555
]
}
}
]
}

Response samples

200
400
401
429

Content type

application/json

{"nms": [{"advert_id": 12345,
"nms": {"added": [11111111,
44444444
],
"deleted": [55555555
]
}
}
]
}

Финансы

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

Вы можете посмотреть ваш баланс и бюджет ваших рекламных кампаний. Бюджет рекламных кампаний можно пополнить.

Также вы можете узнать историю ваших затрат и пополнений счёта.

Баланс{{ /adv/v1/balance }}

Описание метода

Метод возвращает информацию о:

счёте кабинета Продвижения WB. Его пополняет продавец.
балансе — максимальной сумме для оплаты камапнии по взаиморасчету: удержании средств из будущих продаж. Баланс пополнить нельзя, он рассчитывается автоматически на основе отчётов по продвижению.
бонусных начислениях WB.

Информацию о бюджете кампаний можно получить в отдельном методе.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	1 запрос	1 секунда	5 запросов

Authorizations:

HeaderApiKey

Responses

Response samples

200
400
401
429

Content type

application/json

{"balance": 11083,
"net": 0,
"bonus": 15187,
"cashbacks": [{"sum": 10672,
"percent": 50,
"expiration_date": "2026-04-17T10:46:02.176174Z"
}
]
}

Бюджет кампании{{ /adv/v1/budget }}

Описание метода

Метод возвращает информацию о бюджете кампании — максимальной сумме затрат на кампанию. Бюджет кампании можно пополнить.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	4 запроса	250 миллисекунд	4 запроса

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1

ID кампании

Responses

Response samples

200
400
401
429

Content type

application/json

{"cash": 0,
"netting": 0,
"total": 500
}

Пополнение бюджета кампании{{ /adv/v1/budget/deposit }}

Описание метода

Метод пополняет бюджет кампании. Можно использовать, чтобы запустить кампанию в статусе 11 — пауза.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	1 запрос	1 секунда	5 запросов

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1234567

ID кампании

Request Body schema: application/json
required

sum	integer Общая сумма пополнения бюджета
cashback_sum	integer Сумма пополнения бюджета промо-бонусами. Пополнить можно только определённый процент от общей суммы, указанный в поле `percent` ответа метода получения баланса. Оставшаяся часть общей суммы спишется с указанного источника пополнения. Пополнить можно только определённый процент от общей суммы, указанный в поле `percent` ответа метода получения баланса. Оставшаяся часть общей суммы спишется с указанного источника пополнения. Списать промо-бонусы можно только для источников пополнения: `0` — счёт `1` — баланс
cashback_percent	integer Процент от суммы пополнения, который можно пополнить промо-бонусами. Нужно указать значение поля percent из ответа метода получения баланса Если вы указали `cashback_sum`, параметр `cashback_percent` становится обязательным
type	integer Тип источника пополнения: `0` — Счёт `1` — Баланс `3` — Бонусы
return	boolean Флаг возврата ответа (`true` — в ответе вернется обновлённый размер бюджета кампании, `false` или не указать параметр вообще — не вернётся.)

Responses

Request samples

Payload

Content type

application/json

{"sum": 5000,
"cashback_sum": 1000,
"cashback_percent": 50,
"type": 1,
"return": true
}

Response samples

200
400
401
429

Content type

application/json

Ответ при return=true

{"total": 7289
}

Получение истории затрат{{ /adv/v1/upd }}

Описание метода

Метод формирует список фактических затрат на рекламные кампании за заданный период.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	1 запрос	1 секунда	5 запросов

Authorizations:

HeaderApiKey

query Parameters

from required	string <date> Example: from=2023-07-31 Начало интервала
to required	string <date> Example: to=2023-08-02 Конец интервала. (Минимальный интервал 1 день, максимальный 31)

Responses

Response samples

200
400
401
429

Content type

application/json

[{"updNum": 0,
"updTime": "2023-07-31T12:12:54.060536+03:00",
"updSum": 24,
"advertId": 3355881,
"campName": "лук лучок",
"advertType": 6,
"paymentType": "Баланс",
"advertStatus": 9
},
{"updNum": 0,
"updTime": null,
"updSum": 107,
"advertId": 3366882,
"campName": "золотая луковица",
"advertType": 8,
"paymentType": "Счет",
"advertStatus": 11
}
]

Получение истории пополнений счёта{{ /adv/v1/payments }}

Описание метода

Метод возвращает историю пополнений счёта WB Продвижение за заданный период.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	1 запрос	1 секунда	5 запросов

Authorizations:

HeaderApiKey

query Parameters

from	string <date> Example: from=2023-07-31 Начало интервала
to	string <date> Example: to=2023-08-02 Конец интервала. (Минимальный интервал 1 день, максимальный 31)

Responses

Response samples

200
400
401
429

Content type

application/json

[{"id": 1036666,
"date": "2022-02-04T09:06:47.985843Z",
"sum": 600,
"type": 0,
"statusId": 1,
"cardStatus": ""
},
{"id": 55261296,
"date": "2023-04-13T10:07:42",
"sum": 1500,
"type": 3,
"statusId": 1,
"cardStatus": "succeeded"
}
]

Медиа

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

Узнать больше о WB Медиа можно в справочном центре

Методы для получения данных кампаний WB Медиа:

Количество медиакампаний{{ /adv/v1/count }}

Описание метода

Метод возвращает количество медиакампаний продавца с группировкой по статусам.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	10 запросов	100 миллисекунд	10 запросов

Authorizations:

HeaderApiKey

Responses

Response samples

200
401
429

Content type

application/json

{"all": 6,
"adverts": {"type": 2,
"status": 7,
"count": 2
}
}

Список медиакампаний{{ /adv/v1/adverts }}

Описание метода

Метод возвращает список всех медиакампаний продавца по их типам и статусам.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	10 запросов	100 миллисекунд	10 запросов

Authorizations:

HeaderApiKey

query Parameters

status	integer Example: status=1 Статус медиакампании: `1` — черновик `2` — модерация `3` — отклонена (с возможностью вернуть на модерацию) `4` — готова к запуску `5` — запланирована `6` — на показах `7` — завершена `8` — отменена `9` — приостановлена продавцом `10` — пауза по дневному лимиту `11` — пауза
type	integer Example: type=1 Тип медиакампании: `1` — размещение по дням `2` — размещение по просмотрам
limit	integer Example: limit=1 Количество кампаний в ответе
offset	integer Example: offset=1 Смещение относительно первой медиакампании
order	string Example: order=id Порядок вывода ответа: `create` — по времени создания медиакампании `id` — по ID медиакампании
direction	string Example: direction=desc Порядок сортировки: `desc` — от большего к меньшему `asc` — от меньшего к большему

Responses

Response samples

200
401
429

Content type

application/json

[{"advertId": 123456,
"name": "тост",
"brand": "goosb",
"type": 2,
"status": 8,
"createTime": "2023-03-25T20:35:57.116943+03:00"
},
{"advertId": 54321,
"name": "тест",
"brand": "bobr",
"type": 1,
"status": 7,
"createTime": "2023-07-24T16:48:20.935599+03:00",
"endTime": "2023-07-25T20:35:50.104978Z"
}
]

Информация о медиакампании{{ /adv/v1/advert }}

Описание метода

Метод возвращает информацию о кампании WB Медиа. Вместо карточек товаров в медиакампаниях продвигаются рекламные баннеры продавца на сайте и в приложении WB.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	10 запросов	100 миллисекунд	10 запросов

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=23569

ID медиакампании

Responses

Response samples

200
401
429

Content type

application/json

{"advertId": 23569,
"name": "Реклама денег принеси",
"brand": "Plank",
"type": 2,
"status": 11,
"createTime": "2023-07-19T11:13:41.195138+03:00",
"extended": {"reason": "Для возобновления показов пополните бюджет медиакампании",
"expenses": 10000,
"from": "2023-07-19T12:05:35.847348Z",
"to": "2123-07-20T08:14:13.079176+03:00",
"updated_at": "2023-07-21T13:25:31.129766+03:00",
"price": 0,
"budget": 0,
"operation": 1,
"contract_id": 0
},
"items": [{"id": 68080,
"name": "Унисон",
"status": 7,
"place": 2,
"budget": 650000,
"daily_limit": 500,
"category_name": "Главная",
"cpm": 351,
"url": "https://www.wildberries.ru/promotions/ssylka-na-akciyou",
"advert_type": 1,
"created_at": "2023-11-01T15:40:46.86165+03:00",
"updated_at": "2023-11-08T23:44:33.248229+03:00",
"date_from": "2023-11-01T16:05:22.286002Z",
"date_to": "2023-11-09T17:27:32.745869+03:00",
"nms": [123456,
11111111
],
"bottomText1": "string",
"bottomText2": "string",
"message": "string",
"additionalSettings": 1,
"receiversCount": 1,
"subject_id": 6945,
"subject_name": "Бельё",
"action_name": "Распродажа! Создай себе домашний уют!",
"show_hours": [{"From": 7,
"To": 8
}
],
"Erid": "string"
}
]
}

Статистика

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

Методы получения статистики, в частности:

Статистика кампаний{{ /adv/v2/fullstats }} Deprecated

Описание метода

Метод будет отключён 30 сентября. Используйте актуальный метод.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	1 запрос	1 минута	5 запросов

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

Array

One of

id required	integer ID кампании
dates required	Array of strings <date> [ items <date > ] Даты, за которые нужно получить информацию

Responses

Request samples

Payload

Content type

application/json

Example

RequestWithDate

Запрос с датами

[{"id": 8960367,
"dates": ["2023-10-07",
"2023-10-06"
]
},
{"id": 9876543,
"dates": ["2023-10-07",
"2023-12-06"
]
}
]

Response samples

200
400
401
429

Content type

application/json

Example

ResponseWithDate

Ответ при запросе с полем date

[{"views": 1052,
"clicks": 2,
"ctr": 0.19,
"cpc": 0.09,
"sum": 177.7,
"atbs": 0,
"orders": 0,
"cr": 0,
"shks": 0,
"sum_price": 0,
"dates": ["2023-10-07",
"2023-10-06"
],
"days": [{"date": "2023-10-06T03:00:00+03:00",
"views": 414,
"clicks": 1,
"ctr": 0.24,
"cpc": 70,
"sum": 70,
"atbs": 0,
"orders": 0,
"cr": 0,
"shks": 0,
"sum_price": 0,
"apps": [{"views": 228,
"clicks": 0,
"ctr": 0,
"cpc": 0,
"sum": 38.71,
"atbs": 0,
"orders": 0,
"cr": 0,
"shks": 0,
"sum_price": 0,
"nm": [{"views": 25,
"clicks": 0,
"ctr": 0,
"cpc": 0,
"sum": 4,
"atbs": 0,
"orders": 0,
"cr": 0,
"shks": 0,
"sum_price": 0,
"name": "Тапочки",
"nmId": 111111111111
}
],
"appType": 1
}
]
}
],
"boosterStats": [{"date": "2023-10-07T00:00:00Z",
"nm": 170095908,
"avg_position": 348
}
],
"advertId": 10524818
}
]

Статистика кампаний{{ /adv/v3/fullstats }}

Описание метода

Метод формирует статистику для кампаний независимо от типа.

Максимальный период в запросе — 31 день.

Для кампаний в статусах 7, 9 и 11.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 минута	1 запрос	1 минута	1 запрос

Authorizations:

HeaderApiKey

query Parameters

ids required	Array of strings [ 1 .. 100 ] items Example: ids=22161678,28449281,28155229 ID кампаний
beginDate required	string <date> Example: beginDate=2025-09-07 Дата начала интервала
endDate required	string <date> Example: endDate=2025-09-08 Дата окончания интервала

Responses

Response samples

200
400
401
429

Content type

application/json

[{"advertId": 22161678,
"atbs": 9,
"boosterStats": [{"avg_position": 24,
"date": "2025-09-07",
"nm": 221725278
},
{"avg_position": 35,
"date": "2025-09-08",
"nm": 221725278
}
],
"canceled": 0,
"clicks": 139,
"cpc": 4.76,
"cr": 0,
"ctr": 10.12,
"days": [{"apps": [{"appType": 1,
"atbs": 0,
"canceled": 0,
"clicks": 1,
"cpc": 10.19,
"cr": 0,
"ctr": 4.76,
"nms": [{"atbs": 0,
"canceled": 0,
"clicks": 1,
"cpc": 10.19,
"cr": 0,
"ctr": 4.76,
"name": "постер 2",
"nmId": 221725278,
"orders": 0,
"shks": 0,
"sum": 10.19,
"sum_price": 0,
"views": 21
}
],
"orders": 0,
"shks": 0,
"sum": 10.19,
"sum_price": 0,
"views": 21
},
{"appType": 32,
"atbs": 1,
"canceled": 0,
"clicks": 54,
"cpc": 4.26,
"cr": 0,
"ctr": 11.37,
"nms": [{"atbs": 1,
"canceled": 0,
"clicks": 54,
"cpc": 4.26,
"cr": 0,
"ctr": 11.37,
"name": "постер 2",
"nmId": 221725278,
"orders": 0,
"shks": 0,
"sum": 230.08,
"sum_price": 0,
"views": 475
}
],
"orders": 0,
"shks": 0,
"sum": 230.08,
"sum_price": 0,
"views": 475
},
{"appType": 64,
"atbs": 1,
"canceled": 0,
"clicks": 20,
"cpc": 6.91,
"cr": 0,
"ctr": 6.94,
"nms": [{"atbs": 1,
"canceled": 0,
"clicks": 20,
"cpc": 6.91,
"cr": 0,
"ctr": 6.94,
"name": "постер 2",
"nmId": 221725278,
"orders": 0,
"shks": 0,
"sum": 138.23,
"sum_price": 0,
"views": 288
}
],
"orders": 0,
"shks": 0,
"sum": 138.23,
"sum_price": 0,
"views": 288
}
],
"atbs": 2,
"canceled": 0,
"clicks": 75,
"cpc": 5.05,
"cr": 0,
"ctr": 9.57,
"date": "2025-09-07T00:00:00Z",
"orders": 0,
"shks": 0,
"sum": 378.49,
"sum_price": 0,
"views": 784
},
{"apps": [{"appType": 32,
"atbs": 5,
"canceled": 0,
"clicks": 45,
"cpc": 3.58,
"cr": 0,
"ctr": 13.43,
"nms": [{"atbs": 5,
"canceled": 0,
"clicks": 45,
"cpc": 3.58,
"cr": 0,
"ctr": 13.43,
"name": "постер 2",
"nmId": 221725278,
"orders": 0,
"shks": 0,
"sum": 161.02,
"sum_price": 0,
"views": 335
}
],
"orders": 0,
"shks": 0,
"sum": 161.02,
"sum_price": 0,
"views": 335
},
{"appType": 64,
"atbs": 2,
"canceled": 0,
"clicks": 19,
"cpc": 6.05,
"cr": 0,
"ctr": 8.02,
"nms": [{"atbs": 2,
"canceled": 0,
"clicks": 19,
"cpc": 6.05,
"cr": 0,
"ctr": 8.02,
"name": "постер 2",
"nmId": 221725278,
"orders": 0,
"shks": 0,
"sum": 114.95,
"sum_price": 0,
"views": 237
}
],
"orders": 0,
"shks": 0,
"sum": 114.95,
"sum_price": 0,
"views": 237
},
{"appType": 1,
"atbs": 0,
"canceled": 0,
"clicks": 0,
"cpc": 0,
"cr": 0,
"ctr": 0,
"nms": [{"atbs": 0,
"canceled": 0,
"clicks": 0,
"cpc": 0,
"cr": 0,
"ctr": 0,
"name": "постер 2",
"nmId": 221725278,
"orders": 0,
"shks": 0,
"sum": 6.79,
"sum_price": 0,
"views": 17
}
],
"orders": 0,
"shks": 0,
"sum": 6.79,
"sum_price": 0,
"views": 17
}
],
"atbs": 7,
"canceled": 0,
"clicks": 64,
"cpc": 4.42,
"cr": 0,
"ctr": 10.87,
"date": "2025-09-08T00:00:00Z",
"orders": 0,
"shks": 0,
"sum": 282.76,
"sum_price": 0,
"views": 589
}
],
"orders": 0,
"shks": 0,
"sum": 661.25,
"sum_price": 0,
"views": 1373
},
{"advertId": 28449281,
"atbs": 1,
"canceled": 0,
"clicks": 9,
"cpc": 35.94,
"cr": 11.11,
"ctr": 1.76,
"days": [{"apps": [{"appType": 32,
"atbs": 1,
"canceled": 0,
"clicks": 7,
"cpc": 26.31,
"cr": 14.29,
"ctr": 2.41,
"nms": [{"atbs": 1,
"canceled": 0,
"clicks": 5,
"cpc": 33.02,
"cr": 20,
"ctr": 1.92,
"name": "Футболка желтая",
"nmId": 398309059,
"orders": 1,
"shks": 1,
"sum": 165.1,
"sum_price": 500,
"views": 260
},
{"atbs": 0,
"canceled": 0,
"clicks": 2,
"cpc": 9.53,
"cr": 0,
"ctr": 6.67,
"name": "Футболка салатовая",
"nmId": 301957154,
"orders": 0,
"shks": 0,
"sum": 19.05,
"sum_price": 0,
"views": 30
}
],
"orders": 1,
"shks": 1,
"sum": 184.15,
"sum_price": 500,
"views": 290
},
{"appType": 64,
"atbs": 0,
"canceled": 0,
"clicks": 2,
"cpc": 62.87,
"cr": 0,
"ctr": 1.01,
"nms": [{"atbs": 0,
"canceled": 0,
"clicks": 1,
"cpc": 12.7,
"cr": 0,
"ctr": 5,
"name": "Футболка салатовая",
"nmId": 301957154,
"orders": 0,
"shks": 0,
"sum": 12.7,
"sum_price": 0,
"views": 20
},
{"atbs": 0,
"canceled": 0,
"clicks": 1,
"cpc": 113.03,
"cr": 0,
"ctr": 0.56,
"name": "Футболка желтая",
"nmId": 398309059,
"orders": 0,
"shks": 0,
"sum": 113.03,
"sum_price": 0,
"views": 178
}
],
"orders": 0,
"shks": 0,
"sum": 125.73,
"sum_price": 0,
"views": 198
},
{"appType": 1,
"atbs": 0,
"canceled": 0,
"clicks": 0,
"cpc": 0,
"cr": 0,
"ctr": 0,
"nms": [{"atbs": 0,
"canceled": 0,
"clicks": 0,
"cpc": 0,
"cr": 0,
"ctr": 0,
"name": "Футболка желтая",
"nmId": 398309059,
"orders": 0,
"shks": 0,
"sum": 13.59,
"sum_price": 0,
"views": 22
}
],
"orders": 0,
"shks": 0,
"sum": 13.59,
"sum_price": 0,
"views": 22
}
],
"atbs": 1,
"canceled": 0,
"clicks": 9,
"cpc": 35.94,
"cr": 11.11,
"ctr": 1.76,
"date": "2025-09-08T00:00:00Z",
"orders": 1,
"shks": 1,
"sum": 323.47,
"sum_price": 500,
"views": 510
}
],
"orders": 1,
"shks": 1,
"sum": 323.47,
"sum_price": 500,
"views": 510
}
]

Статистика кампании с единой ставкой по кластерам фраз{{ /adv/v2/auto/stat-words }}

Описание метода

Метод формирует кластеры ключевых — то есть, наборы похожих — фраз из поисковой строки, если по ним хотя бы один раз были показаны товары из кампании. В ответе метода также указано количество показов этих товаров.

Информация обновляется каждые 15 минут.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	4 запроса	250 миллисекунд	4 запроса

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1234

ID кампании

Responses

Response samples

200
400
401
429

Content type

application/json

{"excluded": ["Samsung",
"Xiaomi"
],
"clusters": [{"cluster": "Телефон",
"count": 100,
"keywords": ["Телефон",
"Мобильный телефон"
]
}
]
}

Статистика кампании c ручной ставкой по ключевым фразам{{ /adv/v1/stat/words }}

Описание метода

Метод формирует статистику кампании c ручной ставкой по ключевым фразам из поисковой строки: количество просмотров товара и затраты по одной ключевой фразе.

Информация обновляется каждые 30 минут.

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

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	4 запроса	250 миллисекунд	4 запроса

Authorizations:

HeaderApiKey

query Parameters

id

required

integer

Example: id=1

ID кампании

Responses

Response samples

200
401
429

Content type

application/json

{"words": {"phrase": [ ],
"strong": [ ],
"excluded": [ ],
"pluse": ["детское постельное белье для мальчика 1.5"
],
"keywords": [{"keyword": "постельное белье 1.5",
"count": 772
}
],
"fixed": true
},
"stat": [{"advertId": 7703570,
"keyword": "Всего по кампании",
"advertName": "",
"campaignName": "Бельё",
"begin": "2023-07-03T15:15:38.287441+03:00",
"end": "2023-07-03T15:15:38.287441+03:00",
"views": 1846,
"clicks": 73,
"frq": 1,
"ctr": 3.95,
"cpc": 7.88,
"duration": 769159,
"sum": 575.6
},
{"advertId": 7703570,
"keyword": "постельное белье 1.5 детское",
"advertName": "",
"campaignName": "Бельё",
"begin": "2023-07-03T15:15:38.287441+03:00",
"end": "2023-07-03T15:15:38.287441+03:00",
"views": 1846,
"clicks": 73,
"frq": 1,
"ctr": 3.95,
"cpc": 7.88,
"duration": 769159,
"sum": 575.6
}
]
}

Статистика по ключевым фразам{{ /adv/v0/stats/keywords }}

Описание метода

Метод формирует статистику по ключевым фразам из поисковой строки: количество просмотров товара и затраты по одной ключевой фразе. Подходит для кампаний c единой и ручной ставкой.

Статистика формируется за каждый день, когда кампания была активна. В одном запросе можно получить данные максимум за 7 дней.
Данные обновляются каждый час.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	4 запроса	250 миллисекунд	4 запроса

Authorizations:

HeaderApiKey

query Parameters

advert_id required	integer Example: advert_id=123456789 ID кампании
from required	string <date> Example: from=2024-08-10 Начало периода
to required	string <date> Example: to=2024-08-12 Конец периода

Responses

Response samples

200
400
401
404
429

Content type

application/json

{"keywords": [{"date": "2024-08-12",
"stats": [{"clicks": 68,
"ctr": 3.73,
"keyword": "светильники",
"sum": 565.75,
"views": 1825
}
]
}
]
}

Статистика медиакампаний{{ /adv/v1/stats }}

Описание метода

Метод формирует статистику кампаний сервиса WB Медиа. Статистику можно группировать по датам и/или интервалам.

Лимит запросов на один аккаунт продавца:

Период	Лимит	Интервал	Всплеск
1 секунда	10 запросов	100 миллисекунд	10 запросов

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

Array ([ 1 .. 100 ] items)

One of

id required	integer ID кампании
dates required	Array of strings <date> [ items <date > ] Даты, за которые нужно получить информацию

Responses

Request samples

Payload

Content type

application/json

Example

RequestWithDate

Запрос с датами

[{"id": 8960367,
"dates": ["2023-10-07",
"2023-10-06"
]
},
{"id": 9876543,
"dates": ["2023-10-07",
"2023-12-06"
]
}
]

Response samples

200
400
401
429

Content type

application/json

Example

RespStatMediaInterval

Ответ при запросе с интервалами

[{"interval": {"begin": "2023-10-21",
"end": "2023-10-25"
},
"stats": [{"item_id": 62237,
"item_name": "Gloria Jeans",
"category_name": "Детям",
"advert_type": 1,
"place": 2,
"views": 11849,
"clicks": 209,
"cr": 0.48,
"ctr": 1.76,
"date_from": "2023-10-21T00:00:00+03:00",
"date_to": "2023-10-27T23:59:59+03:00",
"subject_name": "Одежда",
"atbs": 4,
"orders": 1,
"price": 175000,
"cpc": 837.32,
"status": 6,
"daily_stats": [{"date": "2023-10-21T00:00:00+03:00",
"app_type_stats": [{"app_type": 1,
"stats": [{"views": 2017,
"clicks": 27,
"atbs": 1,
"ctr": 1.34
}
]
}
]
}
],
"expenses": 175000,
"cr1": 1.91,
"cr2": 25
}
]
}
]

Календарь акций

Для доступа к методам используйте токен для категории Цены и скидки

Узнать больше о календаре акций можно в справочном центре

С помощью этих методов можно получить:

Также можно добавить товар для участия в акции.

Список акций{{ /api/v1/calendar/promotions }}

Описание метода

Метод возвращает список акций в WB с датами и временем проведения.

Лимит запросов на один аккаунт продавца для всех методов категории Календарь акций:

Период	Лимит	Интервал	Всплеск
6 секунд	10 запросов	600 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

query Parameters

startDateTime required	string <RFC3339> Example: startDateTime=2023-09-01T00:00:00Z Начало периода, формат `YYYY-MM-DDTHH:MM:SSZ`
endDateTime required	string <RFC3339> Example: endDateTime=2024-08-01T23:59:59Z Конец периода, формат `YYYY-MM-DDTHH:MM:SSZ`
allPromo required	boolean Default: false Показать акции: `false` — доступные для участия `true` — все акции
limit	integer <uint> [ 1 .. 1000 ] Example: limit=10 Количество запрашиваемых акций
offset	integer <uint> >= 0 Example: offset=0 После какого элемента выдавать данные

Responses

Response samples

200
400
401
429

Content type

application/json

{"data": {"promotions": [{"id": 123,
"name": "скидки",
"startDateTime": "2023-06-05T21:00:00Z",
"endDateTime": "2023-06-05T21:00:00Z",
"type": "regular"
}
]
}
}

Детальная информация об акциях{{ /api/v1/calendar/promotions/details }}

Описание метода

Метод возвращает подробную информацию об акции по ID.

Лимит запросов на один аккаунт продавца для всех методов категории Календарь акций:

Период	Лимит	Интервал	Всплеск
6 секунд	10 запросов	600 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

query Parameters

promotionIDs

required

string [ 1 .. 100 ] items unique

Example: promotionIDs=1&promotionIDs=3&promotionIDs=64

ID акций, по которым нужно вернуть информацию

Responses

Response samples

200
400
401
429

Content type

application/json

{"data": {"promotions": [{"id": 123,
"name": "ХИТЫ ГОДА",
"description": "В акции принимают участие самые популярные товары 2023 года. Карточки товаров будут выделены плашкой «ХИТ ГОДА», чтобы покупатели замечали эти товары среди других. Также они будут размещены под баннерами на главной странице и примут участие в PUSH-уведомлениях. С ценами для вступления в акцию вы можете ознакомиться ниже.",
"advantages": ["Плашка",
"Баннер",
"Топ выдачи товаров"
],
"startDateTime": "2023-06-05T21:00:00Z",
"endDateTime": "2023-06-05T21:00:00Z",
"inPromoActionLeftovers": 45,
"inPromoActionTotal": 123,
"notInPromoActionLeftovers": 3,
"notInPromoActionTotal": 10,
"participationPercentage": 10,
"type": "auto",
"exceptionProductsCount": 10,
"ranging": [{"condition": "productsInPromotion",
"participationRate": 10,
"boost": 7
},
{"condition": "calculateProducts",
"participationRate": 20,
"boost": 17
},
{"condition": "allProducts",
"participationRate": 35,
"boost": 30
}
]
}
]
}
}

Список товаров для участия в акции{{ /api/v1/calendar/promotions/nomenclatures }}

Описание метода

Метод формирует список товаров, подходящих для участия в акции. Эти товары можно добавить в акцию с помощью отдельного метода.

Данный метод неприменим для автоакций.

Лимит запросов на один аккаунт продавца для всех методов категории Календарь акций:

Период	Лимит	Интервал	Всплеск
6 секунд	10 запросов	600 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

query Parameters

promotionID required	integer Example: promotionID=1 ID акции
inAction required	boolean Default: false Example: inAction=true Участвует в акции: `true` — да `false` — нет
limit	integer <uint> [ 1 .. 1000 ] Example: limit=10 Количество запрашиваемых товаров
offset	integer <uint> >= 0 Example: offset=0 После какого элемента выдавать данные

Responses

Response samples

200
400
401
422
429

Content type

application/json

{"data": {"nomenclatures": [{"id": 162579635,
"inAction": true,
"price": 1500,
"currencyCode": "RUB",
"planPrice": 1000,
"discount": 15,
"planDiscount": 34
}
]
}
}

Добавить товар в акцию{{ /api/v1/calendar/promotions/upload }}

Описание метода

Метод создаёт задание на загрузку товара в акцию.
Состояние загрузки можно проверить с помощью отдельных методов.

Данный метод неприменим для автоакций.

Лимит запросов на один аккаунт продавца для всех методов категории Календарь акций:

Период	Лимит	Интервал	Всплеск
6 секунд	10 запросов	600 миллисекунд	5 запросов

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

object

Данные запроса

Responses

Request samples

Payload

Content type

application/json

{"data": {"promotionID": 1,
"uploadNow": true,
"nomenclatures": [75632091,
31322455,
642080796
]
}
}

Response samples

200
400
401
422
429

Content type

application/json

{"data": {"alreadyExists": false,
"uploadID": 11
}
}

Маркетинг и продвижение (promotion)

Маркетинг и продвижение

Кампании

Списки кампаний{{ /adv/v1/promotion/count }}

Authorizations:

Responses

Response samples

Информация о кампаниях{{ /adv/v1/promotion/adverts }}

Authorizations:

query Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Информация о кампаниях с ручной ставкой{{ /adv/v0/auction/adverts }}

Authorizations:

query Parameters

Responses

Response samples

Создание кампаний

Конфигурационные значения Продвижения{{ /adv/v0/config }} Deprecated

Authorizations:

Responses

Response samples

Минимальные ставки для карточек товаров{{ /adv/v0/bids/min }}

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Создать кампанию с единой ставкой{{ /adv/v1/save-ad }} Deprecated

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Создать кампанию{{ /adv/v2/seacat/save-ad }}

Authorizations:

Request Body schema: application/json

Responses

Request samples

Response samples

Предметы для кампаний{{ /adv/v1/supplier/subjects }}

Authorizations:

Responses

Response samples

Карточки товаров для кампаний{{ /adv/v2/supplier/nms }}

Authorizations:

Request Body schema: application/json

Responses

Request samples

Response samples

Управление кампаниями

Удаление кампании{{ /adv/v0/delete }}

Authorizations:

query Parameters

Responses

Response samples

Переименование кампании{{ /adv/v0/rename }}

Authorizations:

Request Body schema: application/json

Responses

Request samples

Response samples

Запуск кампании{{ /adv/v0/start }}

Authorizations:

query Parameters

Responses

Response samples

Пауза кампании{{ /adv/v0/pause }}

Authorizations:

query Parameters

Responses

Response samples

Завершение кампании{{ /adv/v0/stop }}

Authorizations:

query Parameters

Responses

Response samples

Изменение ставок{{ /adv/v0/bids }}

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required