Все предложения магазина
Deprecated
Этот метод устарел. Не используйте его.
Позволяет максимально быстро получить информацию обо всех предложениях магазина, размещенных на Маркете. Возвращает результат в виде сегментов нефиксированного размера.
В ответе на запрос для каждого найденного предложения указывается URL и наименование этого предложения, его цена и валюта, в которой она указана, карточка модели Яндекс Маркета, с которой соотнесено предложение, а также аукционные ставки на него.
Примечание
Количество предложений считается по данным за последние семь дней (не включая сегодня).
Для новых магазинов, еще не разместивших предложения, ограничение равно 0 и пересчитывается на следующий день после размещения первых предложений.
⚙️ Лимит: рассчитывается по формуле |
---|
Request
GET
https://api.partner.market.yandex.ru/campaigns/{campaignId}/offers/all
Path parameters
Name |
Type |
Description |
campaignId* |
integer<int64> |
Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете. Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns. |
Query parameters
Name |
Type |
Description |
feedId |
integer<int64> |
Идентификатор прайс-листа. |
chunk |
integer<int32> |
Номер сегмента с результатами. Значение по умолчанию: Примечание Номера сегментов запрашиваются последовательно, пока не будет получен сегмент с пустым ответом. Пустой ответ означает, что все предложения магазина получены. Внимание Нумерация начинается с 0. Чтобы запросить первую страницу, необходимо указать |
Responses
200 OK
Предложения магазина
Body
{
"offers": [
{
"price": 0,
"feedId": 0,
"id": "string",
"shopCategoryId": "string",
"marketCategoryId": 0,
"preDiscountPrice": 0,
"discount": 0,
"cutPrice": false,
"url": "string",
"modelId": 0,
"name": "string",
"currency": "RUR",
"bid": 0,
"cbid": 0,
"fee": 0,
"blocked": false
}
]
}
Name |
Type |
Description |
offers |
OfferDTO[] |
Список предложений магазина. |
OfferDTO
Предложение.
Name |
Type |
Description |
price |
number |
Цена предложения. До версии 2.0 партнерского API у параметра был тип String. |
feedId |
integer<int64> |
Идентификатор прайс-листа, содержащего предложение. Параметр доступен начиная с версии 2.0 партнерского API. |
id |
string |
Идентификатор предложения из прайс-листа. Параметр выводится, если в прайс-листе задан уникальный идентификатор. Если в прайс-листе содержится несколько предложений с одинаковыми идентификаторами, параметр Параметр доступен начиная с версии 2.0 партнерского API. |
shopCategoryId |
string |
Идентификатор категории предложения, указанный магазином в прайс-листе. Параметр выводится только для предложений, у которых указана категория в прайс-листе. Параметр доступен начиная с версии 2.0 партнерского API. |
marketCategoryId |
integer<int32> |
Идентификатор категории предложения в дереве категорий Маркета. Параметр доступен начиная с версии 2.0 партнерского API. |
preDiscountPrice |
number |
Цена предложения без скидки. |
discount |
integer<int32> |
Скидка на предложение, в %. |
cutPrice |
boolean |
Является ли предложение уцененным:
Параметр доступен начиная с версии 2.58 партнерского API. |
url |
string |
URL-адрес предложения на сайте магазина. |
modelId* |
integer<int64> |
Идентификатор модели Маркета, с которой соотнесено предложение. Если предложение не соотнесено ни с какой карточкой модели, то параметр Примечание Идентификатор модели присутствует в URL карточки модели в виде значения параметра |
name |
string |
Наименование предложения. |
currency |
Валюта, в которой указана цена предложения. Возможные значения:
|
|
bid |
number |
Ставка на клик. deprecated. |
cbid |
number |
Ставка на клик. deprecated. |
fee |
number |
Процент комиссии на товар при продаже по CPA. deprecated. |
blocked |
boolean |
Признак блокировки предложения. Возможные значения:
|
CurrencyType
Коды валют. Возможные значения:
BYR
— белорусский рубль.KZT
— казахстанский тенге.RUR
— российский рубль.UAH
— украинская гривна.
Type |
Description |
Enum: |
400 Bad Request
Запрос содержит неправильные данные.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
ApiErrorDTO
Общий формат ошибки.
Name |
Type |
Description |
code* |
string |
Код ошибки. |
message |
string |
Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
404 Not Found
Запрашиваемый ресурс не найден.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
среднее количество таваров в каталоге за неделю * 25
товаров в сутки