Получить категории и их атрибуты

Получите категорийное дерево LAliExpress с помощью метода POST /api/v1/categories/top. Сопоставьте ваши категории товаров с категориями платформы.
Рекурсивно вызывайте метод POST /api/v1/categories/get для каждой дочерней категории из поля children_ids, пока не получите необходимую категорию нижнего уровня.

Получить категории верхнего уровня

POST /api/v1/categories/top

Возвращает категорийное дерево LAliExpress.

В запросе укажите следующие заголовки:

Заголовок	Описание
x-auth-token	Ваш jwt токен для авторизации.
x-request-locale	Язык ответа и сообщения об ошибке. Укажите значение ru_RU

Параметры запроса

В запросе нет обязательных входящих параметров.

Пример запроса

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/categories/top' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--header 'x-request-locale: ru_RU' \
--data-raw '{}'

Параметры ответа

Параметр	Тип	Описание
categories	array of objects	Список категорий.
↳ id	string	Индентификатор категории на LAliExpress.
↳ name	string	Название категории.
↳ children_ids	array of strings	Идентификаторы дочерних категорий.
↳ sku_properties	array of objects	Атрибуты вариации товара.
↳ id	string	Идентификатор атрибута.
↳ name	string	Название атрибута.
↳ is_required	boolean	Является ли атрибут обязательным.
↳ is_key	boolean	Является ли ключевым атрибутом. Это значит, что его рекомендуется заполнить, так как он может влиять на выдачу в поиске и фильтры.
↳ is_brand	boolean	Является ли атрибут брендом.
↳ is_enum_prop	boolean	Является ли атрибут справочным.
↳ is_multi_select	boolean	Можно ли выбрать несколько значений атрибута.
↳ is_input_prop	boolean	Является ли значение атрибута произвольным.
↳ has_unit	boolean	Имеет ли атрибут единицы измерения.
↳ has_customized_pic	boolean	Можно ли загрузить изображение.
↳ has_customized_name	boolean	Есть ли другое название.
↳ units	array of objects	Массив единиц измерения атрибута (для числовых).
↳ rate	int	Значение единицы измерения.
↳ name	string	Название единицы измерения.
↳ properties	array of objects	Атрибуты категории.
↳ id	string	Идентификатор атрибута.
↳ name	string	Название атрибута.
↳ is_required	boolean	Является ли атрибут обязательным.
↳ is_key	boolean	Является ли ключевым атрибутом. Это значит, что его рекомендуется заполнить, так как он может влиять на выдачу в поиске и фильтры.
↳ is_brand	boolean	Является ли атрибут брендом.
↳ is_enum_prop	boolean	Является ли атрибут справочным.
↳ is_multi_select	boolean	Можно ли выбрать несколько значений атрибута.
↳ is_input_prop	boolean	Является ли значение атрибута произвольным.
↳ has_unit	boolean	Имеет ли атрибут единицы измерения.
↳ has_customized_pic	boolean	Можно ли загрузить изображение.
↳ has_customized_name	boolean	Есть ли другое название.
↳ units	array of objects	Массив единиц измерения атрибута (для числовых).
↳ rate	number(double)	Значение единицы измерения.
↳ name	string	Название единицы измерения.

Пример ответа

{
  "categories": [
    {
      "id": "2",
      "name": "Продукты питания",
      "children_ids": [
        "200001321",
        "201248407",
        "200001317",
        "201248804",
        "201248805",
        "201249506",
        "200180142",
        "200183144",
        "200003573",
        "201253905",
        "201254306",
        "201254404",
        "200001238",
        "200001287",
        "100007269",
        "201345805",
        "201373004",
        "201374104",
        "201376204",
        "201376702",
        "201376903",
        "201378002",
        "201378103",
        "201379402",
        "201379801",
        "201379901"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "3",
      "name": "Одежда и аксессуары",
      "children_ids": [
        "200003274"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "6",
      "name": "Бытовая техника",
      "children_ids": [
        "200165142",
        "628",
        "100000039",
        "100000041",
        "200235142",
        "200293142",
        "200294142"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "7",
      "name": "Компьютеры и офис",
      "children_ids": [
        "200001074",
        "200001076",
        "200001077",
        "200001081",
        "200001083",
        "200001085",
        "200001086",
        "200318143",
        "701",
        "702",
        "703",
        "70803003",
        "200048142",
        "100005329",
        "100005330",
        "201610101",
        "200003782",
        "200154144",
        "708022"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "13",
      "name": "Ремонт и обустройство",
      "children_ids": [
        "5",
        "42",
        "12504",
        "200001382",
        "1312",
        "1315",
        "1330",
        "1333",
        "201303704",
        "200321150",
        "200366148",
        "100005265",
        "200066142",
        "100005281",
        "100005310",
        "100005320",
        "100005335",
        "200066144",
        "200071142",
        "200072142",
        "100006266",
        "100006285",
        "100007064",
        "100007071",
        "100007082",
        "100007099",
        "200001751",
        "131207",
        "131210",
        "131211",
        "200264142",
        "200282142"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "15",
      "name": "Дом и сад",
      "children_ids": [
        "200003937",
        "125",
        "405",
        "200033149",
        "200003998",
        "100001824",
        "100006664",
        "1541",
        "3710",
        "200000920"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "18",
      "name": "Спорт и развлечения",
      "children_ids": [
        "200003500",
        "200003538",
        "200003540",
        "200003541",
        "200003543",
        "200004194",
        "200004217",
        "100005360",
        "100005371",
        "100005481",
        "200378143",
        "100005529",
        "100005537",
        "100005551",
        "100005563",
        "100005571",
        "100005657",
        "200297143",
        "100005880"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "21",
      "name": "Канцтовары для офиса и дома",
      "children_ids": [
        "201236701",
        "200001562",
        "211106",
        "201330702",
        "200652001",
        "211111",
        "100003125",
        "100003129",
        "100003131",
        "100003134",
        "100003135",
        "100003155",
        "200004276",
        "201338004",
        "200001743",
        "212002",
        "2112",
        "2139",
        "2202",
        "2209",
        "2213"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "26",
      "name": "Игрушки и хобби",
      "children_ids": [
        "200001383",
        "200001384",
        "200001385",
        "200001387",
        "200001388",
        "200001389",
        "201534605",
        "200001725",
        "200001726",
        "200246142",
        "200386159",
        "200388154",
        "200389146",
        "200389156",
        "200389159",
        "100001698",
        "100001714",
        "100001715",
        "100001716",
        "100001719",
        "201292714"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "30",
      "name": "Безопасность и защита",
      "children_ids": [
        "200001791",
        "200004309",
        "200004310",
        "200004311",
        "200004343",
        "200327196",
        "200327211",
        "200327212",
        "200327231",
        "200328217",
        "200328267",
        "200330186",
        "3007",
        "3009",
        "3011",
        "3015",
        "3030",
        "200332185"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "34",
      "name": "Автомобили и мотоциклы",
      "children_ids": [
        "200004043",
        "200003427",
        "200004218",
        "200002005",
        "200259142",
        "200260142",
        "200000285",
        "201268984",
        "200000212",
        "200003411"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "36",
      "name": "Украшения и аксессуары",
      "children_ids": [
        "201238105",
        "201239108",
        "200001478",
        "200001479",
        "200370154",
        "1509",
        "200001680"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "39",
      "name": "Лампы и освещение",
      "children_ids": [
        "200001067",
        "530",
        "200001493",
        "200326144",
        "39050508",
        "1504",
        "200001704",
        "390501",
        "390503",
        "3999",
        "150401",
        "150402",
        "150403"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "44",
      "name": "Электроника",
      "children_ids": [
        "629",
        "200003561",
        "200003803",
        "100000305",
        "100000306",
        "100000308",
        "100000310"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "66",
      "name": "Красота и здоровье",
      "children_ids": [
        "200001147",
        "201248902",
        "200001355",
        "200001508",
        "200001168",
        "200001187",
        "200001221",
        "200001288",
        "1513",
        "200001976",
        "100000616",
        "201169002",
        "3305",
        "3306",
        "660103",
        "660302",
        "201217706"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "320",
      "name": "Всё для свадеб и торжеств",
      "children_ids": [
        "201238406",
        "32005",
        "201236002",
        "100005787",
        "200000410",
        "200000749"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "322",
      "name": "Обувь",
      "children_ids": [
        "200001000",
        "32210",
        "32299",
        "200131145",
        "200133142"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "502",
      "name": "Электронные компоненты и принадлежности",
      "children_ids": [
        "504",
        "4004",
        "4003",
        "4002",
        "4001",
        "150412",
        "150407",
        "515",
        "4099",
        "4005"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "509",
      "name": "Телефоны и аксессуары",
      "children_ids": [
        "100001205",
        "100001204",
        "5090301",
        "200380144",
        "201084002",
        "200001598",
        "50906"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "1420",
      "name": "Инструменты",
      "children_ids": [
        "142099",
        "200003955",
        "12503",
        "200183146",
        "1417",
        "1427",
        "1428",
        "1431",
        "1440",
        "201252405",
        "100006468",
        "100006471",
        "100007188",
        "100007485",
        "100007498",
        "1537",
        "4204",
        "4338",
        "142001",
        "142003",
        "142016"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "1501",
      "name": "Мать и ребенок",
      "children_ids": [
        "311",
        "200000947",
        "200002039",
        "200000500",
        "200000937",
        "200332157",
        "200332158",
        "201273175",
        "201293501",
        "310",
        "200002038",
        "200329142",
        "200002006",
        "200328149",
        "200328147",
        "201678201",
        "201671802",
        "100003020",
        "200364142",
        "200001330"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "1503",
      "name": "Мебель",
      "children_ids": [
        "100003019",
        "3708",
        "3712",
        "150301",
        "150302",
        "150303",
        "150304",
        "150399",
        "100001029",
        "200130145"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "1511",
      "name": "Наручные часы",
      "children_ids": [
        "200362145",
        "200362143",
        "200362144",
        "200362146",
        "200000121",
        "200000126"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "1524",
      "name": "Багаж и сумки",
      "children_ids": [
        "201336907",
        "152499",
        "152409",
        "152404",
        "152402",
        "201296102",
        "201295902",
        "201294604",
        "201376929",
        "3806",
        "3805",
        "201296801",
        "3803",
        "380520",
        "201337808",
        "201401303",
        "201396505",
        "201298604",
        "152401"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "200000297",
      "name": "Аксессуары одежды",
      "children_ids": [
        "201159809",
        "201532001",
        "201303301",
        "33906",
        "200346143",
        "201531601",
        "200301150",
        "201196803",
        "3280111",
        "200392144",
        "200295143",
        "200295142",
        "200000440",
        "200000402",
        "200000400",
        "200000399",
        "200000395",
        "200000394",
        "200000393",
        "200000392",
        "200000306",
        "200000305",
        "200000298",
        "201161809"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "200000343",
      "name": "Мужская одежда",
      "children_ids": [
        "348",
        "201236604",
        "201515601",
        "201240601",
        "200003495",
        "200001819",
        "200001860",
        "200001877",
        "200005141",
        "200128143",
        "200000344",
        "200000378",
        "200000779",
        "200000795"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "200000345",
      "name": "Женская одежда",
      "children_ids": [
        "200003494",
        "349",
        "201240602",
        "201241002",
        "201515701",
        "201303001",
        "201516501",
        "201531101",
        "201771210",
        "200001908",
        "200001909",
        "200001911",
        "200001912",
        "200001918",
        "200003908",
        "200128142",
        "200129142",
        "200000346",
        "200000347",
        "200000348",
        "200000361",
        "200000362",
        "200000366",
        "200000367",
        "200000373",
        "200000778",
        "200000796",
        "200000865"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "200000532",
      "name": "Униформа и необычные костюмы",
      "children_ids": [
        "201302006",
        "200000740",
        "200000668",
        "200000666",
        "200000663",
        "100005769"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "200001075",
      "name": "Специальная категория",
      "children_ids": [
        "200004358",
        "200726001",
        "201355115",
        "200003864",
        "200003892",
        "201174708",
        "200001627",
        "200003560",
        "201252004",
        "200376142",
        "200004270",
        "201600601",
        "200024143",
        "201350802",
        "200001078",
        "200001079",
        "200165143",
        "201249605",
        "201303705",
        "200001620",
        "200001621",
        "200001623"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "200165144",
      "name": "Пряди для наращивания и парики",
      "children_ids": [
        "200396142",
        "127886013",
        "200166144",
        "200167144",
        "200168146",
        "200317142",
        "200319142",
        "201303603"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "200574005",
      "name": "Нижнее белье",
      "children_ids": [
        "200000854",
        "200001865",
        "200001866",
        "200001894",
        "200000349",
        "200000384",
        "200001813"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "201169612",
      "name": "Цифровые товары",
      "children_ids": [
        "201352363",
        "201353146",
        "201377714",
        "201360737",
        "201356254",
        "201355944",
        "201354843",
        "201508601"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "201355758",
      "name": "Мотоциклы и оборудование",
      "children_ids": [
        "201352950",
        "201352247",
        "201371802",
        "201359843",
        "201359147",
        "201357051",
        "201377402"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "201520802",
      "name": "Б/у",
      "children_ids": [
        "201523301"
      ],
      "sku_properties": [],
      "properties": []
    },
    {
      "id": "201768104",
      "name": "",
      "children_ids": [
        "301",
        "201445239",
        "200000950",
        "200046142"
      ],
      "sku_properties": [],
      "properties": []
    }
  ]
}

Получить атрибуты категории

POST /api/v1/categories/get

Возвращает для заданной категории массив дочерних категорий с атрибутами.

В запросе укажите следующие заголовки:

Заголовок	Описание
x-auth-token	Ваш jwt токен для авторизации.
x-request-locale	Язык ответа и сообщения об ошибке. Укажите значение ru_RU

Параметры запроса

Параметр	Тип	Обязательный	Описание
ids	array of strings	Да	Массив идентификаторов категорий. В запросе можно передать до 20 идентификаторов.

Пример запроса

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/categories/get' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--header 'x-request-locale: ru_RU' \
--data-raw '{
  "ids": [
    "13004"
  ]
}'

Параметры ответа

Параметр	Тип	Описание
id	string(int)	Индентификатор категории на LAliExpress.
parent_id	string(int)	Идентификатор категории более высокого уровня.
name	string	Название категории
children_ids	array of strings	Идентификаторы дочерних категорий.
is_visible	boolean	Является ли категория активной на LAliExpress.
sku_properties	object	Атрибуты вариации товара.
↳ id	string(int)	Идентификатор атрибута.
↳ name	string	Название атрибута.
↳ is_required	boolean	Атрибут является обязательным.
↳ is_key	boolean	Является ли ключевым атрибутом. Это значит, что его рекомендуется заполнить, так как он может влиять на выдачу в поиске и фильтры.
↳ is_brand	boolean	Является ли атрибут брендом.
↳ is_enum_prop	boolean	Является ли атрибут справочным.
↳ is_multi_select	boolean	Можно ли выбрать несколько значений атрибута.
↳ is_input_prop	boolean	Является ли значение атрибута произвольным.
↳ has_unit	boolean	Есть единица измерения.
↳ has_customized_pic	boolean	Можно ли загрузить изображение.
↳ has_customized_name	boolean	Есть другое название.
↳ units	array of object	Массив единиц измерения атрибута (для числовых).
↳ rate	number(double)	Значение единицы измерения.
↳ name	string	Название единицы измерения.
properties	object	Атрибуты категории.
↳ id	string(int)	Идентификатор атрибута.
↳ name	string	Название атрибута.
↳ is_required	boolean	Атрибут является обязательным.
↳ is_key	boolean	Является ли ключевым атрибутом. Это значит, что его рекомендуется заполнить, так как он может влиять на выдачу в поиске и фильтры.
↳ is_brand	boolean	Является ли атрибут брендом.
↳ is_enum_prop	boolean	Является ли атрибут справочным.
↳ is_multi_select	boolean	Можно ли выбрать несколько значений атрибута.
↳ is_input_prop	boolean	Является ли значение атрибута произвольным.
↳ has_unit	boolean	Есть единица измерения.
↳ has_customized_pic	boolean	Можно ли загрузить изображение.
↳ has_customized_name	boolean	Есть другое название.
↳ units	array of object	Массив единиц измерения атрибута (для числовых).
↳ rate	number(double)	Значение единицы измерения.
↳ name	string	Название единицы измерения.

Пример ответа

{
  "categories": [
    {
      "id": "13004",
      "parent_id": "100005537",
      "name": "Рыболовные канаты",
      "children_ids": [],
      "is_visible": true,
      "sku_properties": [
        {
          "id": "14",
          "name": "Цвет",
          "is_required": false,
          "is_key": false,
          "is_brand": false,
          "is_enum_prop": true,
          "is_multi_select": true,
          "is_input_prop": false,
          "has_unit": false,
          "has_customized_pic": true,
          "has_customized_name": true,
          "units": []
        },
        {
          "id": "200007763",
          "name": "Доставка из",
          "is_required": false,
          "is_key": false,
          "is_brand": false,
          "is_enum_prop": true,
          "is_multi_select": true,
          "is_input_prop": false,
          "has_unit": false,
          "has_customized_pic": false,
          "has_customized_name": false,
          "units": []
        }
      ],
      "properties": [
        {
          "id": "166",
          "name": "Диаметр",
          "is_required": false,
          "is_key": false,
          "is_brand": false,
          "is_enum_prop": false,
          "is_multi_select": false,
          "is_input_prop": true,
          "has_unit": false,
          "has_customized_pic": false,
          "has_customized_name": false,
          "units": []
        },
        {
          "id": "2",
          "name": "Название бренда",
          "is_required": true,
          "is_key": false,
          "is_brand": true,
          "is_enum_prop": true,
          "is_multi_select": false,
          "is_input_prop": false,
          "has_unit": false,
          "has_customized_pic": false,
          "has_customized_name": false,
          "units": []
        },
        {
          "id": "3",
          "name": "Номер модели",
          "is_required": false,
          "is_key": false,
          "is_brand": false,
          "is_enum_prop": false,
          "is_multi_select": false,
          "is_input_prop": false,
          "has_unit": false,
          "has_customized_pic": false,
          "has_customized_name": false,
          "units": []
        },
        {
          "id": "10",
          "name": "Материал",
          "is_required": false,
          "is_key": false,
          "is_brand": false,
          "is_enum_prop": false,
          "is_multi_select": false,
          "is_input_prop": false,
          "has_unit": false,
          "has_customized_pic": false,
          "has_customized_name": false,
          "units": []
        },
        {
          "id": "219",
          "name": "Происхождение",
          "is_required": true,
          "is_key": false,
          "is_brand": false,
          "is_enum_prop": true,
          "is_multi_select": false,
          "is_input_prop": false,
          "has_unit": false,
          "has_customized_pic": false,
          "has_customized_name": false,
          "units": []
        },
        {
          "id": "521",
          "name": "Назначение",
          "is_required": false,
          "is_key": false,
          "is_brand": false,
          "is_enum_prop": true,
          "is_multi_select": false,
          "is_input_prop": false,
          "has_unit": false,
          "has_customized_pic": false,
          "has_customized_name": false,
          "units": []
        },
        {
          "id": "1238",
          "name": "Тип продукта",
          "is_required": false,
          "is_key": false,
          "is_brand": false,
          "is_enum_prop": true,
          "is_multi_select": false,
          "is_input_prop": false,
          "has_unit": false,
          "has_customized_pic": false,
          "has_customized_name": false,
          "units": []
        }
      ]
    }
  ]
}

Получить информацию о значениях атрибута

POST /api/v1/categories/values-dictionary

Возвращает текстовое значение атрибута по его идентификатору.

В запросе укажите следующие заголовки:

Заголовок	Описание
x-auth-token	Ваш jwt токен для авторизации.
x-request-locale	Язык ответа и сообщения об ошибке. Укажите значение ru_RU

Параметры запроса

Параметр	Тип	Обязательный	Описание
category_id	string(int)	Да	Идентификатор категории на LAliExpress.
property_id	string(int)	Да	Идентификатор атрибута.
is_sku_property	boolean	Да	Искать в атрибутах вариаций товара.
shipping_template_id	string(int)	Нет	Идентификатор шаблона доставки. Передайте значение параметра data.template_id из ответа метода GET /api/v1/sellercenter/get-count-product-on-onboarding-template.

Пример запроса

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/categories/values-dictionary' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>>' \
--header 'x-request-locale: ru_RU' \
--data-raw '{
  "category_id": "50906",
  "property_id": "14",
  "is_sku_property": true,
  "shipping_template_id": "34000326344"
}'

Параметры ответа

Параметр	Тип	Описание
values	array of object	Массив атрибутов категории.
↳ id	string(int)	Идентификатор значения атрибута.
↳ name	string	Название значения атрибута.
error	object	Описание ошибки.

Пример ответа

{
  "values": [
    {
      "id": "4",
      "name": "Другое"
    },
    {
      "id": "10",
      "name": "Красный"
    },
    {
      "id": "29",
      "name": "Белый"
    },
    {
      "id": "173",
      "name": "Синий"
    },
    {
      "id": "175",
      "name": "Зелёный"
    }
    ],
  "error": null
}