A list of offers for several models

Deprecated

Info

Console

The method is available for the DBS model.

Not yet available for Market Yandex Go sellers.

If you are using an API Key token, one of the accesses in the list is required to call the method

offers-and-cards-management — Manage products and cards
offers-and-cards-management:read-only — View products and cards
all-methods — Full account management
all-methods:read-only — View all data

Returns information about the first ten offers located on the model cards whose IDs are specified in the request.

Offers are issued for a specific region and are arranged in the same order in which they are shown in the Market output on the model card.

Suggestions are not supported for group models. The IDs of the group models are ignored.

In one request, you can get information about offers for up to 100 models.

For methods GET models/{modelId}/offers and POST models/offers The group resource limit is in effect. The limit is imposed on the total number of models, information about which is requested using these methods.

, Limit: 100,000 offers per hour

Request

POST

https://api.partner.market.yandex.ru/models/offers

Query parameters

Name	Description
regionId*	Type: integer<int64> ID of the region. You can get the region ID using a request GET regions.
currency	Type: CurrencyType The currency in which the prices of offers are displayed on the search results pages. Possible values: `BYN` — Belarusian ruble. `KZT` — Kazakhstani tenge. `RUR` — Russian ruble. `UAH` — the Ukrainian hryvnia. Default value: the national currency of the store is used (the national currency of the store's country of origin).
orderByPrice	Type: SortOrderType The direction of sorting by price. Possible values: `ASC` — sort in ascending order. `DESC` — sort in descending order. Default value: the sentences are displayed in any order.

CurrencyType

Currency codes:

RUR — Russian ruble.
UAH — the Ukrainian hryvnia.
BYR — Belarusian ruble.
KZT — Kazakhstani tenge.
UZS — Uzbek sum.

Type

Description

CurrencyType

Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

SortOrderType

Sorting direction:

ASC — sort in ascending order.
DESC — sort in descending order.

Type	Description
SortOrderType	Enum: `ASC`, `DESC`

Body

application/json

{
    "models": [
        0
    ]
}

Name

Description

models*

Type: integer<int64>[]

List of models.
The model ID.

Min value (exclusive): 0

Min items: 1

Unique items

Responses

200 OK

A list of offers for models.

Body

application/json

{
    "models": [
        {
            "id": 0,
            "name": "string",
            "prices": {
                "avg": 0,
                "max": 0,
                "min": 0
            },
            "offers": [
                {
                    "discount": 0,
                    "name": "string",
                    "pos": 0,
                    "preDiscountPrice": 0,
                    "price": 0,
                    "regionId": 0,
                    "shippingCost": 0,
                    "shopName": "string",
                    "shopRating": 0,
                    "inStock": 0
                }
            ],
            "offlineOffers": 0,
            "onlineOffers": 0
        }
    ],
    "currency": "RUR",
    "regionId": 0
}

Name	Description
models*	Type: EnrichedModelDTO[] List of product models. The product model. The product model.
currency	Type: CurrencyType Currency codes: `RUR` — Russian ruble. `UAH` — the Ukrainian hryvnia. `BYR` — Belarusian ruble. `KZT` — Kazakhstani tenge. `UZS` — Uzbek sum. Enum: `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
regionId	Type: integer<int64> ID of the region for which information about the model's offers (delivered to this region) is displayed. You can get information about the region by ID using a request. GET regions/{regionId}.

EnrichedModelDTO

The product model.

Name	Description
id	Type: integer<int64> The product model ID.
name	Type: string The name of the product model.
offers	Type: ModelOfferDTO[] A list of the first ten offers located on the model's card. In response to the request, offers from various stores are returned. If there are several offers from the same store, the response displays only one, the most relevant of them. Information about the offer. Min items: `1`
offlineOffers	Type: integer<int32> The total number of offers in retail stores in the region. All offers from each store are taken into account.
onlineOffers	Type: integer<int32> The total number of offers in online stores in the region. All offers from each store are taken into account.
prices	Type: ModelPriceDTO Information about prices for the product model.

ModelOfferDTO

Information about the offer.

Name	Description
discount	Type: integer<int32> Percentage discount on the offer.
inStock ⦸	Type: integer<int32> Do not use this option.
name	Type: string The name of the offer.
pos	Type: integer<int32> The position of the offer in the Market output on the model card.
preDiscountPrice	Type: number The offer price without the store's discount.
price	Type: number The offer price without the discount that the buyer receives when paying via Yandex Pay.
regionId	Type: integer<int64> The identifier of the region of the offer (the region from where the product is delivered). First, the offers delivered from the region specified in the request parameter are shown. `regionId`. Offers delivered from other regions are shown after them.
shippingCost	Type: number The cost of shipping the product to the region: `0` — you don't need to pay for the delivery. `-1` — the store does not deliver this product (pickup). If the shipping cost is unknown, the parameter is not displayed.
shopName	Type: string The name of the store (as displayed on the Market).
shopRating	Type: integer<int32> The store's rating. Possible values: `-1` — for stores that have recently appeared on the Market, the rating does not appear immediately. The value is returned for such stores until the rating appears. `-1`. `1`. `2`. `3`. `4`. `5`.

ModelPriceDTO

Information about prices for the product model.

Name	Description
avg	Type: number The average offer price for the model in the region.
max	Type: number The maximum offer price for a model in the region.
min	Type: number The minimum offer price for the model in the region.

400 Bad Request

The request contains incorrect data. More information about the error

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

ApiErrorDTO

The general error format.

Name

Description

code*

Type: string

The error code.

message

Type: string

Description of the error.

ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Type	Description
ApiResponseStatusType	Enum: `OK`, `ERROR`

401 Unauthorized

The authorization data is not specified in the request. More information about the error

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

403 Forbidden

The authorization data is incorrect or access to the resource is prohibited. More information about the error

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

404 Not Found

The requested resource was not found. More information about the error

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

420 Method Failure

The resource access limit has been exceeded. More information about the error

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

500 Internal Server Error

Internal error in Yandex. Market. More information about the error

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

Was the article helpful?

One model

Product model search