Руководство разработчика
Ресурсы API

Подбор категорий по параметрам

Описание

GET /{version}/categories/match

Возвращает список категорий, соответствующих указанным параметрам.

URL ресурса:

https://api.content.market.yandex.ru/{version}/categories/match

Входные данные

ПараметрПоложе­ниеТипОбяза­тельностьОписание
version PATH Enum Да

Версия API.

format QUERY Enum Нет

Формат выходных данных.

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

  • JSON — выходные данные будут сформированы в формате JSON.
  • XML — выходные данные будут сформированы в формате XML.

Значение по умолчанию: JSON .
Параметры запроса для подбора категории
name QUERY String Да

Имя

category_name QUERY String Нет

Наименование категории.

description QUERY String Нет

Описание модели.

description QUERY String Нет

Описание.

locale QUERY String Нет

Локаль поиска.

locale QUERY String Нет

Локаль.

Значение по умолчанию: RU_ru.
name QUERY String Нет

Название модели.

price QUERY String Нет

Цена модели.

price QUERY Float Нет
shop_name QUERY String Нет

Наименование магазина.

Выходные данные

Структура выходных данных приведена ниже. Порядок следования параметров не гарантируется.

{
  "status
[no-highlight[

Статус обработки запроса.

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

  • OK — операция выполнена успешно.

  • ERROR — произошла ошибка.

]no-highlight]
" : "{enum}", "context
[no-highlight[

Контекст обработки запроса.

]no-highlight]
" : { "region
[no-highlight[

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

]no-highlight]
" : { "id
[no-highlight[

Идентификатор региона.

]no-highlight]
" : {int32}, "name
[no-highlight[

Наименование региона.

]no-highlight]
" : "{string}", "type
[no-highlight[

Тип региона.

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

  • CONTINENT — континент.

  • REGION — регион.

  • COUNTRY — страна.

  • COUNTRY_DISTRICT — федеральный округ.

  • SUBJECT_FEDERATION — субъект федерации.

  • CITY — город.

  • VILLAGE — село.

  • CITY_DISTRICT — район города.

  • METRO_STATION — станиция метро.

  • SUBJECT_FEDERATION_DISTRICT — район субъекта федерации.

  • AIRPORT — аэропорт.

  • OVERSEAS_TERRITORY — отдельная территория какого-либо государства, расположенная в другой части света (например, Ангилья, Гренландия, Бермудские острова и т. д.).

  • SECONDARY_DISTRICT — район города второго уровня (например, для ВАО Москвы районами второго уровня являются Измайлово, Новокосино, Перово и т. д.).

  • MONORAIL_STATION — станция монорельса.

  • RURAL_SETTLEMENT — сельское поселение.

  • OTHER — другой тип населенного пункта.

]no-highlight]
" : "{enum}", "childCount
[no-highlight[

Количество дочерних регионов.

]no-highlight]
" : {int32}, "country
[no-highlight[

Страна, к которой относится регион.

Регион

]no-highlight]
" : { Содержимое объекта } }, "currency
[no-highlight[

Валюта запроса.

]no-highlight]
" : { "id
[no-highlight[

Код валюты.

]no-highlight]
" : "{string}", "name
[no-highlight[

Название валюты.

]no-highlight]
" : "{string}" }, "alternateCurrency
[no-highlight[

Альтернативная валюта запроса.

]no-highlight]
" : { "id
[no-highlight[

Код валюты.

]no-highlight]
" : "{string}", "name
[no-highlight[

Название валюты.

]no-highlight]
" : "{string}" }, "page
[no-highlight[

Информация о параметрах страницы запроса.

]no-highlight]
" : { "number
[no-highlight[

Номер страницы.

]no-highlight]
" : {int32}, "count
[no-highlight[

Размер страницы.

]no-highlight]
" : {int32}, "total
[no-highlight[

Количество страниц в результате.

]no-highlight]
" : {int32}, "last
[no-highlight[

Признак последней страницы.

]no-highlight]
" : {boolean} }, "warnings
[no-highlight[

Список предупреждений, возникших при обработке запроса.

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

]no-highlight]
" : [ { "type
[no-highlight[

Тип предупрежедния.

]no-highlight]
" : "{string}", "code
[no-highlight[

Код предупреждения.

]no-highlight]
" : "{string}", "message
[no-highlight[

Сообщение с описанием предупреждения.

]no-highlight]
" : "{string}" }, ... ], "id
[no-highlight[

Уникальный идентификатор запроса.

]no-highlight]
" : "{string}", "time
[no-highlight[

Дата и время выполнения запроса в формате ISO 8601.

]no-highlight]
" : "{date}", "link
[no-highlight[

Ссылка на текущий запрос.

]no-highlight]
" : "{string}", "marketUrl
[no-highlight[

Ссылка на Яндекс.Маркет.

]no-highlight]
" : "{string}" }, "categories
[no-highlight[

Подобранные категории.

]no-highlight]
" : [ { "id
[no-highlight[

Идентификатор категории.

]no-highlight]
" : {int32}, "name
[no-highlight[

Наименование категории.

]no-highlight]
" : "{string}", "fullName
[no-highlight[

Полное наименование категории.

]no-highlight]
" : "{string}", "parent
[no-highlight[

Идентификатор родительской категории.

]no-highlight]
" : {int32}, "adult
[no-highlight[

Признак категории, имеющей возрастное ограничение (18+).

]no-highlight]
" : {boolean}, "link
[no-highlight[

Ссылка на карточку категории на Яндекс.Маркете.

]no-highlight]
" : "{string}", "childCount
[no-highlight[

Количество дочерних категорий.

]no-highlight]
" : {int32}, "modelCount
[no-highlight[

Количество моделей в категории.

]no-highlight]
" : {int32}, "offerCount
[no-highlight[

Количество товарных предложений в категории.

]no-highlight]
" : {int32}, "advertisingModel
[no-highlight[

Тип размещения товарных предложений в категории.

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

  • CPA — плата за заказы, оформленные прямо на Яндекс.Маркете.

  • CPC — плата только за клики по предложению магазина.

  • HYBRID — возможны оба варианта размещения товарных предложений в категории.

]no-highlight]
" : "{enum}", "viewType
[no-highlight[

Тип отображения товаров в категории.

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

  • LIST — список.

  • GRID — сетка.

]no-highlight]
" : "{enum}", "rank
[no-highlight[

Коэффицент соответствия категории поисковому запросу.

]no-highlight]
" : {double}, "warnings
[no-highlight[

Предупреждения, связанные с категорией.

]no-highlight]
" : [ { "text
[no-highlight[

Текст предупреждения.

]no-highlight]
" : "{string}", "shortText
[no-highlight[

Краткий текст предупреждения.

Предназначен для устройств с узким экраном.

]no-highlight]
" : "{string}", "age
[no-highlight[

Возрастное ограничение для категории.

]no-highlight]
" : {int32} }, ... ] }, ... ] }
<result status
[no-highlight[

Статус обработки запроса.

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

  • OK — операция выполнена успешно.

  • ERROR — произошла ошибка.

]no-highlight]
="{enum}"> <context
[no-highlight[

Контекст обработки запроса.

]no-highlight]
id
[no-highlight[

Уникальный идентификатор запроса.

]no-highlight]
="{string}" time
[no-highlight[

Дата и время выполнения запроса в формате ISO 8601.

]no-highlight]
="{date}" link
[no-highlight[

Ссылка на текущий запрос.

]no-highlight]
="{string}" marketUrl
[no-highlight[

Ссылка на Яндекс.Маркет.

]no-highlight]
="{string}"> <region
[no-highlight[

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

]no-highlight]
id
[no-highlight[

Идентификатор региона.

]no-highlight]
="{int32}" name
[no-highlight[

Наименование региона.

]no-highlight]
="{string}" type
[no-highlight[

Тип региона.

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

  • CONTINENT — континент.

  • REGION — регион.

  • COUNTRY — страна.

  • COUNTRY_DISTRICT — федеральный округ.

  • SUBJECT_FEDERATION — субъект федерации.

  • CITY — город.

  • VILLAGE — село.

  • CITY_DISTRICT — район города.

  • METRO_STATION — станиция метро.

  • SUBJECT_FEDERATION_DISTRICT — район субъекта федерации.

  • AIRPORT — аэропорт.

  • OVERSEAS_TERRITORY — отдельная территория какого-либо государства, расположенная в другой части света (например, Ангилья, Гренландия, Бермудские острова и т. д.).

  • SECONDARY_DISTRICT — район города второго уровня (например, для ВАО Москвы районами второго уровня являются Измайлово, Новокосино, Перово и т. д.).

  • MONORAIL_STATION — станция монорельса.

  • RURAL_SETTLEMENT — сельское поселение.

  • OTHER — другой тип населенного пункта.

]no-highlight]
="{enum}" childCount
[no-highlight[

Количество дочерних регионов.

]no-highlight]
="{int32}"> <country
[no-highlight[

Страна, к которой относится регион.

Регион

]no-highlight]
>Содержимое объекта</country> </region> <currency
[no-highlight[

Валюта запроса.

]no-highlight]
id
[no-highlight[

Код валюты.

]no-highlight]
="{string}" name
[no-highlight[

Название валюты.

]no-highlight]
="{string}"/> <alternateCurrency
[no-highlight[

Альтернативная валюта запроса.

]no-highlight]
id
[no-highlight[

Код валюты.

]no-highlight]
="{string}" name
[no-highlight[

Название валюты.

]no-highlight]
="{string}"/> <page
[no-highlight[

Информация о параметрах страницы запроса.

]no-highlight]
number
[no-highlight[

Номер страницы.

]no-highlight]
="{int32}" count
[no-highlight[

Размер страницы.

]no-highlight]
="{int32}" total
[no-highlight[

Количество страниц в результате.

]no-highlight]
="{int32}" last
[no-highlight[

Признак последней страницы.

]no-highlight]
="{boolean}"/> <warnings
[no-highlight[

Список предупреждений, возникших при обработке запроса.

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

]no-highlight]
> <warning type
[no-highlight[

Тип предупрежедния.

]no-highlight]
="{string}" code
[no-highlight[

Код предупреждения.

]no-highlight]
="{string}" message
[no-highlight[

Сообщение с описанием предупреждения.

]no-highlight]
="{string}"/> ... </warnings> </context> <categories
[no-highlight[

Подобранные категории.

]no-highlight]
> <category id
[no-highlight[

Идентификатор категории.

]no-highlight]
="{int32}" name
[no-highlight[

Наименование категории.

]no-highlight]
="{string}" fullName
[no-highlight[

Полное наименование категории.

]no-highlight]
="{string}" parent
[no-highlight[

Идентификатор родительской категории.

]no-highlight]
="{int32}" adult
[no-highlight[

Признак категории, имеющей возрастное ограничение (18+).

]no-highlight]
="{boolean}" link
[no-highlight[

Ссылка на карточку категории на Яндекс.Маркете.

]no-highlight]
="{string}" childCount
[no-highlight[

Количество дочерних категорий.

]no-highlight]
="{int32}" modelCount
[no-highlight[

Количество моделей в категории.

]no-highlight]
="{int32}" offerCount
[no-highlight[

Количество товарных предложений в категории.

]no-highlight]
="{int32}" advertisingModel
[no-highlight[

Тип размещения товарных предложений в категории.

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

  • CPA — плата за заказы, оформленные прямо на Яндекс.Маркете.

  • CPC — плата только за клики по предложению магазина.

  • HYBRID — возможны оба варианта размещения товарных предложений в категории.

]no-highlight]
="{enum}" viewType
[no-highlight[

Тип отображения товаров в категории.

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

  • LIST — список.

  • GRID — сетка.

]no-highlight]
="{enum}" rank
[no-highlight[

Коэффицент соответствия категории поисковому запросу.

]no-highlight]
="{double}"> <warnings
[no-highlight[

Предупреждения, связанные с категорией.

]no-highlight]
> <warning text
[no-highlight[

Текст предупреждения.

]no-highlight]
="{string}" shortText
[no-highlight[

Краткий текст предупреждения.

Предназначен для устройств с узким экраном.

]no-highlight]
="{string}" age
[no-highlight[

Возрастное ограничение для категории.

]no-highlight]
="{int32}"/> ... </warnings> </category> ... </categories> </result>

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

Параметр для формата JSONПараметр для формата XMLТипОписание
status status

Enum

Статус обработки запроса.

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

  • OK — операция выполнена успешно.

  • ERROR — произошла ошибка.

context context

Object

Контекст обработки запроса.

categories categories

Object list

Подобранные категории.

Параметры, вложенные в context
id id

String

Уникальный идентификатор запроса.

time time

Date

Дата и время выполнения запроса в формате ISO 8601.

link link

String

Ссылка на текущий запрос.

marketUrl marketUrl

String

Ссылка на Яндекс.Маркет.

region region

Object

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

currency currency

Object

Валюта запроса.

alternateCurrency alternateCurrency

Object

Альтернативная валюта запроса.

page page

Object

Информация о параметрах страницы запроса.

warnings warnings

Object list

Список предупреждений, возникших при обработке запроса.

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

Параметры, вложенные в context/region
id id

Int32

Идентификатор региона.

name name

String

Наименование региона.

type type

Enum

Тип региона.

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

  • CONTINENT — континент.

  • REGION — регион.

  • COUNTRY — страна.

  • COUNTRY_DISTRICT — федеральный округ.

  • SUBJECT_FEDERATION — субъект федерации.

  • CITY — город.

  • VILLAGE — село.

  • CITY_DISTRICT — район города.

  • METRO_STATION — станиция метро.

  • SUBJECT_FEDERATION_DISTRICT — район субъекта федерации.

  • AIRPORT — аэропорт.

  • OVERSEAS_TERRITORY — отдельная территория какого-либо государства, расположенная в другой части света (например, Ангилья, Гренландия, Бермудские острова и т. д.).

  • SECONDARY_DISTRICT — район города второго уровня (например, для ВАО Москвы районами второго уровня являются Измайлово, Новокосино, Перово и т. д.).

  • MONORAIL_STATION — станция монорельса.

  • RURAL_SETTLEMENT — сельское поселение.

  • OTHER — другой тип населенного пункта.

childCount childCount

Int32

Количество дочерних регионов.

country country

Object

Страна, к которой относится регион.

Регион

Параметры, вложенные в context/currency, context/alternateCurrency
id id

String

Код валюты.

name name

String

Название валюты.

Параметры, вложенные в context/page
number number

Int32

Номер страницы.

count count

Int32

Размер страницы.

total total

Int32

Количество страниц в результате.

last last

Boolean

Признак последней страницы.

Параметры, вложенные в context/warnings
type type

String

Тип предупрежедния.

code code

String

Код предупреждения.

message message

String

Сообщение с описанием предупреждения.

Параметры, вложенные в categories
id id

Int32

Идентификатор категории.

name name

String

Наименование категории.

fullName fullName

String

Полное наименование категории.

parent parent

Int32

Идентификатор родительской категории.

adult adult

Boolean

Признак категории, имеющей возрастное ограничение (18+).

link link

String

Ссылка на карточку категории на Яндекс.Маркете.

childCount childCount

Int32

Количество дочерних категорий.

modelCount modelCount

Int32

Количество моделей в категории.

offerCount offerCount

Int32

Количество товарных предложений в категории.

advertisingModel advertisingModel

Enum

Тип размещения товарных предложений в категории.

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

  • CPA — плата за заказы, оформленные прямо на Яндекс.Маркете.

  • CPC — плата только за клики по предложению магазина.

  • HYBRID — возможны оба варианта размещения товарных предложений в категории.

viewType viewType

Enum

Тип отображения товаров в категории.

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

  • LIST — список.

  • GRID — сетка.

rank rank

Double

Коэффицент соответствия категории поисковому запросу.

warnings warnings

Object list

Предупреждения, связанные с категорией.

Параметры, вложенные в categories/warnings
text text

String

Текст предупреждения.

shortText shortText

String

Краткий текст предупреждения.

Предназначен для устройств с узким экраном.

age age

Int32

Возрастное ограничение для категории.

Возможные ошибки

В случае возникновения ошибочной ситуации сервер возвращает HTTP-статус ответа и сообщение об ошибке. Описание ошибок приведено в разделе Сообщения об ошибках.

/{version}/categories/match Подбор категорий по параметрам Категории