Request
- Path parameters
- Query parameters
Responses
200 OK
400 Bad Request
- Body
- ApiErrorDTO
401 Unauthorized
- Body
403 Forbidden
- Body
404 Not Found
- Body
420 Method Failure
- Body
500 Internal Server Error
- Body

Новые и обновленные отзывы о магазине

Info

Console

Возвращает новые и обновленные отзывы о магазине на Маркете.

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

⚙️ Лимит: 100 запросов в час

Request

GET

https://api.partner.market.yandex.ru/campaigns/{campaignId}/feedback/updates

Path parameters

Name

Type

Description

campaignId*

integer<int64>

Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете.

Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns.

ℹ️ Что такое кабинет и магазин на Маркете

Query parameters

Name	Type	Description
page_token	string	Идентификатор страницы c результатами. Если параметр не указан, возвращается самая старая страница. Рекомендуется передавать значение выходного параметра `nextPageToken`, полученное при последнем запросе. Если задан `page_token`, параметры `offset`, `page_number` и `page_size` игнорируются. Example: `eyBuZXh0SWQ6IDIzNDIgfQ==`
limit	integer<int32>	Количество товаров на одной странице. Example: `20`
from_date	string<date>	Начальная дата обновления отзывов. Если параметр указан, возвращаются отзывы, которые были написаны или обновлены с этой даты. Формат даты: `ГГГГ-ММ-ДД`.

200 OK

Список отзывов для магазина.

Body

application/json

{
    "status": "OK",
    "result": {
        "paging": {
            "nextPageToken": "string",
            "prevPageToken": "string"
        },
        "feedbackList": [
            {
                "id": 0,
                "createdAt": "2022-12-29T18:02:01Z",
                "text": "string",
                "state": "LAST",
                "author": {
                    "name": "string",
                    "region": {
                        "id": 0,
                        "name": "string",
                        "type": "OTHER",
                        "parent": {
                            "id": 0,
                            "name": "string",
                            "type": "OTHER",
                            "children": [
                                {
                                    "id": 0,
                                    "name": "string",
                                    "type": "OTHER",
                                    "children": [
                                        null
                                    ]
                                }
                            ]
                        },
                        "children": [
                            {
                                "id": 0,
                                "name": "string",
                                "type": "OTHER",
                                "parent": {
                                    "id": 0,
                                    "name": "string",
                                    "type": "OTHER",
                                    "children": [
                                        null
                                    ]
                                },
                                "children": [
                                    null
                                ]
                            }
                        ]
                    }
                },
                "pro": "string",
                "contra": "string",
                "comments": [
                    {
                        "id": 0,
                        "parentId": 0,
                        "body": "string",
                        "createdAt": "2022-12-29T18:02:01Z",
                        "updatedAt": "2022-12-29T18:02:01Z",
                        "author": {
                            "type": "USER",
                            "name": "string"
                        },
                        "children": [
                            null
                        ]
                    }
                ],
                "shop": {
                    "name": "string"
                },
                "resolved": false,
                "verified": false,
                "recommend": false,
                "grades": {
                    "average": 0,
                    "agreeCount": 0,
                    "rejectCount": 0,
                    "factors": [
                        {
                            "id": 0,
                            "title": "string",
                            "description": "string",
                            "value": 0
                        }
                    ]
                },
                "order": {
                    "shopOrderId": "string",
                    "delivery": "DELIVERY"
                }
            }
        ]
    }
}

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
result	FeedbackListDTO	Отзывы пользователей Яндекс.Маркета об указанном магазине.

ApiResponseStatusType

Тип ответа.

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

FeedbackListDTO

Отзывы пользователей Яндекс.Маркета об указанном магазине.

Name

Type

Description

paging

ScrollingPagerDTO

Информация о страницах результатов.
Ссылка на следующую страницу.

feedbackList

FeedbackDTO[]

Список отзывов.

Содержит не более 20 отзывов.
Отзыв пользователя Яндекс.Маркета об указанном магазине.

ScrollingPagerDTO

Информация о страницах результатов.

Name	Type	Description
nextPageToken	string	Идентификатор следующей страницы результатов.
prevPageToken	string	Идентификатор предыдущей страницы результатов.

FeedbackDTO

Отзыв пользователя Яндекс.Маркета об указанном магазине.

Name	Type	Description
id	integer<int64>	Идентификатор отзыва.
createdAt	string<date-time>	Дата и время создания отзыва. Формат даты: ISO 8601 со смещением относительно UTC. Например, `2017-11-21T00:00:00+03:00`.
text	string	Комментарий автора отзыва.
state	FeedbackStateType	Статус отзыва: `LAST` — актуален. `PREVIOUS` — устарел. `DELETED` — удален. Enum: `LAST`, `PREVIOUS`, `DELETED`
author	FeedbackAuthorDTO	Информация об авторе отзыва. Если отзыв оставлен анонимно, параметр не возвращается.
pro	string	Достоинства магазина, описанные в отзыве.
contra	string	Недостатки магазина, описанные в отзыве.
comments	FeedbackCommentDTO[]	Переписка автора отзыва с магазином. Комментарий к отзыву на магазин.
shop	FeedbackShopDTO	Информация о магазине.
resolved	boolean	Решена ли проблема автора отзыва: `true` — да. `false` — нет. Если проблема решена, около отзыва на странице магазина появляется соответствующая надпись.
verified	boolean	Является ли отзыв рекомендованным: `true` — да. `false` — нет. Внимание Параметр устарел и не рекомендуется к использованию.
recommend	boolean	Купил бы автор отзыва в магазине снова: `true` — да. `false` — нет.
grades	FeedbackGradesDTO	Информация об оценках, которые поставил автор отзыва магазину, и об оценках полезности отзыва от других пользователей Маркета.
order	FeedbackOrderDTO	Информация о заказе, указанная в отзыве.

FeedbackStateType

Статус отзыва:

LAST — актуален.
PREVIOUS — устарел.
DELETED — удален.

Type	Description
FeedbackStateType	Enum: `LAST`, `PREVIOUS`, `DELETED`

FeedbackAuthorDTO

Информация об авторе отзыва.

Если отзыв оставлен анонимно, параметр не возвращается.

Name	Type	Description
name	string	Имя автора отзыва.
region	RegionDTO	Информация о регионе автора отзыва.

FeedbackCommentDTO

Комментарий к отзыву на магазин.

Name	Type	Description
id	integer<int64>	Идентификатор ответа.
parentId	integer<int64>	Идентификатор родительского ответа.
body	string	Текст ответа.
createdAt	string<date-time>	Дата и время создания ответа. Формат даты: ISO 8601 со смещением относительно UTC. Например, `2017-11-21T00:00:00+03:00`.
updatedAt	string<date-time>	Дата и время изменения ответа. Формат даты: ISO 8601 со смещением относительно UTC. Например, `2017-11-21T00:00:00+03:00`.
author	FeedbackCommentAuthorDTO	Информация об авторе ответа.
children	FeedbackCommentDTO[]	Дочерние ответы. Комментарий к отзыву на магазин.

FeedbackShopDTO

Информация о магазине.

Name	Type	Description
name	string	Название магазина.

FeedbackGradesDTO

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

Name	Type	Description
average	number	Общая оценка, указанная в отзыве: от `1` («Ужасный магазин») до `5` («Отличный магазин»).
agreeCount	integer<int64>	Количество пользователей, считающих отзыв полезным.
rejectCount	integer<int64>	Количество пользователей, считающих отзыв бесполезным.
factors	FeedbackFactorDTO[]	Информация об оценках по параметрам, указанных в отзыве. При создании отзыва автору предлагается поставить оценки магазину по нескольким параметрам: например, за скорость обработки заказа или удобство самовывоза. Набор параметров зависит от того, какой способ покупки (параметр `delivery`) указал автор. Информация об оценках по параметрам, указанных в отзыве. При создании отзыва автору предлагается поставить оценки магазину по нескольким параметрам: например, за скорость обработки заказа или удобство самовывоза. Набор параметров зависит от того, какой способ покупки (параметр `delivery`) указал автор.

FeedbackOrderDTO

Информация о заказе, указанная в отзыве.

Name	Type	Description
shopOrderId	string	Номер заказа, указанный в отзыве.
delivery	FeedbackDeliveryType	Способ покупки, указанный в отзыве. Enum: `DELIVERY`, `PICKUP`, `INSTORE`

RegionDTO

Регион доставки.

Name	Type	Description
id	integer<int64>	Идентификатор региона.
name*	string	Название региона.
type*	RegionType	Тип региона. Enum: `OTHER`, `CONTINENT`, `REGION`, `COUNTRY`, `COUNTRY_DISTRICT`, `REPUBLIC`, `CITY`, `VILLAGE`, `CITY_DISTRICT`, `SUBWAY_STATION`, `REPUBLIC_AREA`
parent	RegionDTO	Информация о родительском регионе. Указываются родительские регионы до уровня страны.
children	RegionDTO[]	Дочерние регионы. Регион доставки.

FeedbackCommentAuthorDTO

Информация об авторе ответа.

Name

Type

Description

type

FeedbackCommentAuthorType

Тип автора ответа:

USER — пользователь.
SHOP — магазин.

Enum: USER, SHOP

name

string

Имя автора отзыва или название магазина.

FeedbackFactorDTO

Информация об оценках по параметрам, указанных в отзыве.

При создании отзыва автору предлагается поставить оценки магазину по нескольким параметрам: например, за скорость обработки заказа или удобство самовывоза. Набор параметров зависит от того, какой способ покупки (параметр delivery) указал автор.

Name	Type	Description
id	integer<int64>	Идентификатор параметра.
title	string	Название параметра. Например, `Скорость обработки заказа`.
description	string	Описание параметра. Например, `Как быстро с вами связались для подтверждения заказа?`.
value	integer<int32>	Оценка по параметру, указанная в отзыве: от `1` (низшая оценка) до `5` (высшая оценка).

FeedbackDeliveryType

Способ покупки, указанный в отзыве:

DELIVERY — доставка.
PICKUP — самовывоз.
INSTORE — в магазине.

Type	Description
FeedbackDeliveryType	Enum: `DELIVERY`, `PICKUP`, `INSTORE`

RegionType

Тип региона.

Возможные значения:

CITY_DISTRICT — район города.
CITY — крупный город.
CONTINENT — континент.
COUNTRY_DISTRICT — область.
COUNTRY — страна.
REGION — регион.
REPUBLIC_AREA — район субъекта федерации.
REPUBLIC — субъект федерации.
SUBWAY_STATION — станция метро.
VILLAGE — город.
OTHER — неизвестный регион.

Type	Description
RegionType	Enum: `OTHER`, `CONTINENT`, `REGION`, `COUNTRY`, `COUNTRY_DISTRICT`, `REPUBLIC`, `CITY`, `VILLAGE`, `CITY_DISTRICT`, `SUBWAY_STATION`, `REPUBLIC_AREA`

FeedbackCommentAuthorType

Тип автора ответа:

USER — пользователь.
SHOP — магазин.

Type	Description
FeedbackCommentAuthorType	Enum: `USER`, `SHOP`

400 Bad Request

Запрос содержит неправильные данные.

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

ApiErrorDTO

Общий формат ошибки.

Name	Type	Description
code*	string	Код ошибки.
message	string	Описание ошибки.

401 Unauthorized

В запросе не указаны данные для авторизации.

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

403 Forbidden

Данные для авторизации неверны или доступ к ресурсу запрещен.

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

404 Not Found

Запрашиваемый ресурс не найден.

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

420 Method Failure

Превышено ограничение на доступ к ресурсу.

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

Новые и обновленные отзывы о магазине

RequestRequest

Path parametersPath parameters

Query parametersQuery parameters

ResponsesResponses

200 OK200 OK

BodyBody

ApiResponseStatusTypeApiResponseStatusType

FeedbackListDTOFeedbackListDTO

ScrollingPagerDTOScrollingPagerDTO

FeedbackDTOFeedbackDTO

FeedbackStateTypeFeedbackStateType

FeedbackAuthorDTOFeedbackAuthorDTO

FeedbackCommentDTOFeedbackCommentDTO

FeedbackShopDTOFeedbackShopDTO

FeedbackGradesDTOFeedbackGradesDTO

FeedbackOrderDTOFeedbackOrderDTO

RegionDTORegionDTO

FeedbackCommentAuthorDTOFeedbackCommentAuthorDTO

FeedbackFactorDTOFeedbackFactorDTO

FeedbackDeliveryTypeFeedbackDeliveryType

RegionTypeRegionType

FeedbackCommentAuthorTypeFeedbackCommentAuthorType

400 Bad Request400 Bad Request

BodyBody

ApiErrorDTOApiErrorDTO

401 Unauthorized401 Unauthorized

BodyBody

403 Forbidden403 Forbidden

BodyBody

404 Not Found404 Not Found

BodyBody

420 Method Failure420 Method Failure

BodyBody

500 Internal Server Error500 Internal Server Error

BodyBody

Была ли статья полезна?

Request

Path parameters

Query parameters

Responses

200 OK

Body

ApiResponseStatusType

FeedbackListDTO

ScrollingPagerDTO

FeedbackDTO

FeedbackStateType

FeedbackAuthorDTO

FeedbackCommentDTO

FeedbackShopDTO

FeedbackGradesDTO

FeedbackOrderDTO

RegionDTO

FeedbackCommentAuthorDTO

FeedbackFactorDTO

FeedbackDeliveryType

RegionType

FeedbackCommentAuthorType

400 Bad Request

Body

ApiErrorDTO

401 Unauthorized

Body

403 Forbidden

Body

404 Not Found

Body

420 Method Failure

Body

500 Internal Server Error

Body