Дерево категорий
Метод доступен для всех моделей.
Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке
- inventory-and-order-processing — Обработка заказов и учёт товаров
- inventory-and-order-processing:read-only — Просмотр информации о заказах
- pricing — Управление ценами
- pricing:read-only — Просмотр цен
- offers-and-cards-management — Управление товарами и карточками
- offers-and-cards-management:read-only — Просмотр товаров и карточек
- promotion — Продвижение товаров
- promotion:read-only — Просмотр информации о продвижении товаров
- finance-and-accounting — Просмотр финансовой информации и отчётности
- communication — Общение с покупателями
- settings-management — Настройка магазинов
- supplies-management:read-only — Получение информации по FBY-заявкам
- all-methods — Полное управление кабинетом
- all-methods:read-only — Просмотр всех данных
Возвращает дерево категорий Маркета.
⚙️ Лимит без подписки: 50 запросов в час ⭐️ Лимит с подпиской Медиум: 100 запросов в час до 18.05.2026 действует старый лимит: ⚙️ Лимит: 500 запросов в час |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/categories/tree
Body
application/json
{
"language": "RU"
}
|
Name |
Description |
|
language |
Type: LanguageType Язык категорий. Язык:
Enum: |
LanguageType
Язык:
-
RU— русский. -
EN— английский.
Type: string
Enum: RU, EN
Responses
200 OK
Категории Маркета.
Body
application/json
{
"status": "OK",
"result": {
"id": 0,
"name": "example",
"children": [
null
]
}
}
Type: object
All of 2 types
-
Type: ApiResponse
Стандартная обертка для ответов сервера.
Example
{ "status": "OK" } -
Type: object
result
Type: CategoryDTO
Информация о категории.
Категория считается листовой, если у нее нет дочерних категорий.
Example
{ "id": 0, "name": "example", "children": [ null ] }Example
{ "result": { "id": 0, "name": "example", "children": [ null ] } }
ApiResponseStatusType
Тип ответа. Возможные значения:
OK— ошибок нет.ERROR— при обработке запроса произошла ошибка.
Type: string
Enum: OK, ERROR
ApiResponse
Стандартная обертка для ответов сервера.
|
Name |
Description |
|
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
Example
{
"status": "OK"
}
CategoryDTO
Информация о категории.
Категория считается листовой, если у нее нет дочерних категорий.
|
Name |
Description |
|
id |
Type: integer Идентификатор категории. |
|
name |
Type: string Название категории. Example: |
|
children |
Type: CategoryDTO[] | null Дочерние категории. Min items: Example |
Example
{
"id": 0,
"name": "example",
"children": [
{
"id": 0,
"name": "example",
"children": [
null
]
}
]
}
400 Bad Request
Запрос содержит неправильные данные. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }
ApiErrorDTO
Общий формат ошибки.
|
Name |
Description |
|
code |
Type: string Код ошибки. Example: |
|
message |
Type: string Описание ошибки. Example: |
Example
{
"code": "example",
"message": "example"
}
ApiErrorResponse
Стандартная обертка для ошибок сервера.
Type: object
All of 2 types
-
Type: ApiResponse
Стандартная обертка для ответов сервера.
Example
{ "status": "OK" } -
Type: object
errors
Type: ApiErrorDTO[] | null
Список ошибок.
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
Example
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
401 Unauthorized
В запросе не указаны данные для авторизации. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }
404 Not Found
Запрашиваемый ресурс не найден. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }
420 Method Failure
Превышено ограничение на доступ к ресурсу. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }
500 Internal Server Error
Внутренняя ошибка Маркета. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }