Получить информацию о товарах

Чтобы получить все товары магазина, передайте в параметре last_product_id идентификатор (id) последнего найденного в предыдущем запросе товара. В ответе будут следующие n-товаров, где n — количество отображаемых позиций, заданных в поле limit.

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

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

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

Параметр	Тип	Обязательный	Описание
filter	object	Нет	Параметры фильтрации или поиска по списку товаров.
↳ top_category_ids	array of strings	Нет	Идентификаторы категорий верхнего уровня.
↳ leaf_category_ids	array of strings	Нет	Идентификаторы категорий, не имеющих подкатегорий.
↳ owner_id	string	Нет	Идентификатор владельца/менеджера товара.
↳ shipping_template_ids	array of strings	Нет	Список идентификаторов шаблонов доставки.
↳ status	string	Нет	Статус товара на LAliExpress: ONLINE (В продаже), OFFLINE (Сняты с продажи).
↳ group_ids	array of strings	Нет, Устаревший	Идентификаторы групп товаров на LAliExpress.
↳ has_quantity	boolean	Нет	Есть ли товар в наличии: true, false - нет.
↳ search_content	object	Нет	Параметры для поиска.
↳ content_values	array of strings	Нет	Значение содержимого, указанного в поле content_type.
↳ content_type	string	Нет	Поиск по: ID товара (PRODUCT_ID), Названию товара (PRODUCT_TITLE), Артикулу товара (SKU_SELLER_SKU).
↳ time_range_condition	object	Нет	Период для поиска товаров.
↳ begin_time	string	Нет	Время начала, формат: YYYY-MM-DDThh:mm:ssZ.
↳ end_time	string	Нет	Время окончания, формат: YYYY-MM-DDThh:mm:ssZ.
↳ time_type	string	Нет	Поиск по времени: Создания (PRODUCT_CREATE_TIME), Изменения(PRODUCT_LAST_MODIFIED).
↳ offline_reason	string	Нет	Причина снятия с продажи: user_offline (Вручную), expire_offline (Истёк срок действия), punish_offline (Штрафные санкции), violate_offline (С нарушениями), degrade_offline (Понижено).
last_product_id	string	Нет	Идентификатор последнего найденного товара. Из поиска исключаются товары с ID меньше или равным переданному значению.
limit	string	Да	Лимит количества результатов на странице.

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

Поиск по ID товара

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/scroll-short-product-by-filter' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--header 'Content-Type: application/json' \
--header 'x-request-locale: ru_RU' \
--data-raw '{
    "filter": {
        "search_content": {
            "content_values": [
                "1005004019321370"
            ],
            "content_type": "PRODUCT_ID"
        }
    },
    "limit": 10
}'

Поиск по наименованию товара

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/scroll-short-product-by-filter' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--header 'Content-Type: application/json' \
--header 'x-request-locale: ru_RU' \
--data-raw '{
    "filter": {
        "search_content": {
            "content_values": [
                "Product test name"
            ],
            "content_type": "PRODUCT_TITLE"
        }
    },
    "limit": 10
}'

Поиск по артикулу продавца

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/scroll-short-product-by-filter' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--header 'Content-Type: application/json' \
--header 'x-request-locale: ru_RU' \
--data-raw '{
    "filter": {
        "search_content": {
            "content_values": [
                "АРТ001"
            ],
            "content_type": "SKU_SELLER_SKU"
        }
    },
    "limit": 10
}'

Поиск товаров с остатком в продаже

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/scroll-short-product-by-filter' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--header 'x-request-locale: ru_RU' \
--data-raw '{
    "filter": {
        "status": "ONLINE",
        "has_quantity": true
    },
    "limit": "50"
}'

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

Параметр	Тип	Описание
data	object	Список товаров, удовлетворяющих запросу.
↳ id	string(int)	Идентификатор товара.
↳ ali_created_at	string	Время создания товара на платформе. Формат: YYY-MM-DDThh:mm:ssZ.
↳ ali_updated_at	string	Время редактирования товара на платформе. Формат: YYY-MM-DDThh:mm:ssZ.
↳ category_id	string(int)	Идентификатор категории на LAliExpress.
↳ currency_code	string	Код валюты.
↳ delivery_time	string	Число дней доставки товара.
↳ owner_member_id	string	Логин продавца на LAliExpress.
↳ owner_member_seq	string	Идентификатор продавца на LAliExpress.
↳ freight_template_id	string(int)	Идентификатор шаблона доставки.
↳ group_ids	array of string(int)	Идентификаторы групп товаров на LAliExpress, Устаревший.
↳ main__url	string	Ссылка на главное изображение товара.
↳ main__urls	array of strings	Ссылки на допольнительные изображения товара.
↳ sku	object	Характеристики вариаций товара.
↳ id	string	Составной идентификатор вариации товара, формируется из характеристик по маске name_id:value_id с разделителем ";", например, 200007763:201336103;_Размер:4ГБ;цвет:Красный;доставка из:РФ;Комплект:Упаковка из 5_
↳ sku_id	string(int)	Идентификатор вариации товара.
↳ code	string	Артикул вариации (задаётся продавцом).
↳ price	string	Цена вариации товара.
↳ discount_price	string	Цена со скидкой.
↳ ipm_sku_stock	string	Остаток товара на складе.
↳ subject	string	Название товара на разных языках.
↳ error	object	Ошибка.
↳ code	string	Код ошибки.
↳ message	string	Сообщение об ошибке.
↳ details	object	Подробное описание ошибки.

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

{
    "data": [
        {
            "id": "1005004449114979",
            "ali_created_at": "2022-06-24T11:16:27Z",
            "ali_updated_at": "2022-08-10T13:44:04Z",
            "category_id": "200001133",
            "currency_code": "RUB",
            "delivery_time": "24",
            "owner_member_id": "ru2167674831xhcae",
            "owner_member_seq": "3768546739",
            "freight_template_id": "34007612003",
            "group_ids": [],
            "main_image_url": "https://ae01.alicdn.com/kf/A2c4137699d0e4a0f9eaa113fc12ec9131.jpeg",
            "main_image_urls": [
                "https://ae01.alicdn.com/kf/A2c4137699d0e4a0f9eaa113fc12ec9131.jpeg"
            ],
            "sku": [
                {
                    "id": "14:734637",
                    "sku_id": "12000029215286768",
                    "code": "00734637",
                    "price": "423.000000",
                    "discount_price": "0.000000",
                    "ipm_sku_stock": "71"
                }
            ],
            "Subject": "Vivienne Sabo Тушь для ресниц Provocation 6 мл"
        },
        {
            "id": "1005004449114989",
            "ali_created_at": "2022-06-24T11:16:51Z",
            "ali_updated_at": "2022-08-10T13:44:08Z",
            "category_id": "200001133",
            "currency_code": "RUB",
            "delivery_time": "2",
            "owner_member_id": "ru2167674831xhcae",
            "owner_member_seq": "3768546739",
            "freight_template_id": "34007612003",
            "group_ids": [],
            "main_image_url": "https://ae01.alicdn.com/kf/Ac76a2932b25a460ab84d3a84d613ad05U.jpg",
            "main_image_urls": [
                "https://ae01.alicdn.com/kf/Ac76a2932b25a460ab84d3a84d613ad05U.jpg"
            ],
            "sku": [
                {
                    "id": "200001176:193",
                    "sku_id": "12000029273124639",
                    "code": "00723240",
                    "price": "423.000000",
                    "discount_price": "0.000000",
                    "ipm_sku_stock": "19"
                }
            ],
            "Subject": "Vivienne Sabo тушь со сценическим эффектом водостойкая cabaret premiere 9 мл"
        },
        {
            "id": "1005004449121849",
            "ali_created_at": "2022-06-24T11:17:32Z",
            "ali_updated_at": "2022-08-10T13:44:18Z",
            "category_id": "200001129",
            "currency_code": "RUB",
            "delivery_time": "24",
            "owner_member_id": "ru2167674831xhcae",
            "owner_member_seq": "3768546739",
            "freight_template_id": "34007612003",
            "group_ids": [],
            "main_image_url": "https://ae01.alicdn.com/kf/A5b3ab7cbc4574302b76376a97a8306d8m.jpeg",
            "main_image_urls": [
                "https://ae01.alicdn.com/kf/A5b3ab7cbc4574302b76376a97a8306d8m.jpeg"
            ],
            "sku": [
                {
                    "id": "<none>",
                    "sku_id": "12000029215373140",
                    "code": "00735979",
                    "price": "739.000000",
                    "discount_price": "0.000000",
                    "ipm_sku_stock": "21"
                }
            ],
            "Subject": "Vivienne Sabo тени для глаз Le Cristal"
        }
    ],
    "error": null
}

Получить информацию о товаре

POST /api/v1/product/get-seller-product

Возвращает информацию о товаре по его идентификатору.

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

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

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

Параметр	Тип	Обязательный	Описание
product_id	string(int)	Да	Идентификатор товара на LAliExpress.

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

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/product/get-seller-product' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_TOKEN>' \
--data-raw '{
  "product_id": "1005004449114979"
}'

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

Параметр	Тип	Описание
data	object	Информация по товару, идентификатор которого указан в запросе.
↳ id	string(int)	Идентификатор товара.
↳ ali_created_at	string	Время создания товара на платформе. Формат: YYY-MM-DDThh:mm:ssZ.
↳ ali_updated_at	string	Время редактирования товара на платформе. Формат: YYY-MM-DDThh:mm:ssZ.
↳ owner_member_id	string	Логин продавца на LAliExpress.
↳ owner_member_seq	string	Идентификатор продавца на LAliExpress.
↳ bulk_discount	int	Процент скидки для оптовой продажи.
↳ bulk_order	int	Минимальное количество заказов для оптовой продажи.
↳ base_unit	string	Единица измерения.
↳ add_unit	string	Дополнительная единица измерения товара.
↳ add_weight	int	Вес добавляемых единиц товаров.
↳ category_id	string(int)	Идентификатор категории на LAliExpress.
↳ currency_code	string	Код валюты.
↳ delivery_time	string	Максимальное время сборки заказа в днях. Рекомендуем указывать не более 5, чтобы покупатели реже отменяли заказы.
↳ freight_template_id	string	Идентификатор шаблона доставки.
↳ package_height	string	Высота упаковки в сантиметрах.
↳ package_length	string	Длина упаковки в сантиметрах.
↳ package_width	string	Ширина упаковки в сантиметрах.
↳ lot_num	string	Количество товаров в упаковке.
↳ price	string	Цена товара.
↳ property	object	Атрибуты товара.
↳ name_id	string	Идентификатор атрибута.
↳ name	string	Название атрибута.
↳ value_id	string	Идентификатор значения атрибута.
↳ value	string	Значение атрибута.
↳ unit_name	string	Название единиц измерения (cm, inch).
↳ status_type	string	Статус товара на LAliExpress: onSelling (В продаже), offline (Сняты с продажи).
↳ unit	string	Единица измерения товара: 100000013 — пара, 100000014 — упаĸовĸа/упаĸовĸи, 100000015 — штуĸа/штуĸи, 100000017 — ĸомплеĸт/ĸомплеĸты, 100000019 — ĸвадратный метр.
↳ promise_template_id	string	Идентификатор шаблона, с которым связан товар.
↳ product_reduce_strategy	string	Стратегия сокращения остатков: place_order_withhold — уменьшение запаса после оформления заказа, payment_success_deduct — уменьшение запаса после оплаты.
↳ gross_weight	int minimum: 0.01 maximum: 700	Общий вес товара в упаковке в кг.
↳ sizechart_id	string	Идентификатор шаблона таблицы размеров.
↳ ws_offline_date	string	Устаревшее поле.
↳ ws_display	string	Устаревшее поле.
↳ ws_valid_num	string	Устаревшее поле.
↳ package_type	boolean	Метод продажи: true — упаковками, false — штуками.
↳ descriptions	array of objects	Описания на разных языках.
↳ locale	string	Язык описания.
↳ mobile_detail	string	Описание товара для мобильных устройств.
↳ web_detail	string	Описание товара для desktop-версии.
↳ media	object	Медиа-информация товара.
↳ ali_member_id	string	Устаревшее поле.
↳ media_id	string	Устаревшее поле.
↳ media_status	string	Устаревшее поле.
↳ media_type	string	Тип медиа (video)
↳ url	string	Ссылка на изображение или видео товара.
↳ sku	object	Характеристики вариаций товара.
↳ id	string	Составной идентификатор вариации товара, формируется из характеристик по маске name_id:value_id с разделителем ";", например, Размер:4ГБ;цвет:Красный;доставка из:РФ;Комплект:Упаковка из 5
↳ code	string	Артикул вариации, заданный продавцом.
↳ property	object	Характеристики вариации.
↳ name_id	string	Идентификатор названия характеристики.
↳ name	string	Название характеристики.
↳ value_id	string	Идентификатор значения характеристики.
↳ value	string	Значение характеристики.
↳ _url	string	Ссылка на изображение вариации товара.
↳ value_definition	string	Описание вариации товара, заданное продавцом.
↳ price	string	Цена экземляра товара.
↳ discount_price	string	Цена со скидкой экземляра товара.
↳ barcode	string	Штрихкод, устаревшее поле.
↳ currency_code	string	Код валюты.
↳ ipm_sku_stock	string	Устаревшее поле.
↳ stock	boolean	Остаток товара, устаревшее поле.
↳ gtin	string	Глобальный номер товарной продуĸции в единой международной базе товаров GS1.
↳ sku_id	string	Идентификатор вариации товара.
↳ classifier_codes	object	Коды внешних классификаторов для определения признака маркировки.
↳ type	string	Тип: tnved okpd2
↳ value	string	Значение.
↳ ticket_group	string	Идентификатор группы кода.
↳ subject	object	Список названий товара на разных языках.
↳ locale	string	Язык названия.
↳ name	string	Название товара.
↳ marketing_s	object	Рекламные изображения товара.
↳ url	string	Ссылка на рекламное изображение.
↳ type	int	Тип медиафайла.
↳ keywords	array of strings	Ключевые слова.
↳ gtin	string	Глобальный номер товарной продуĸции в единой международной базе товаров GS1.
↳ classifier_codes	object	Коды внешних классифкаторов, для определения признака маркировки.
↳ type	string	Тип: tnved, okpd2
↳ value	string	Значение.
↳ detail	string	Описание товара.
↳ mobile_detail	string	Описание товара для мобильных устройств.
↳ group_ids	array of strings	Категории товаров в магазине продавца. Устаревший.
↳ ticket_allocate_type	string	Тип источника кода.
↳ video	object	Видео товара.
↳ video_id	string	Идентификатор ранее загруженного видео товара.
↳ preview_url	string	Ссылка на видео, используется в качестве стоп-кадра в карточке товара.
↳ is_approved	boolean	Показывается ли видео в карточке товара. TRUE — показывается.

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

{
    "data": {
        "id": "1005004449114979",
        "ali_created_at": "2022-06-24T11:16:27Z",
        "ali_updated_at": "2022-08-10T13:44:04Z",
        "owner_member_id": "ru2167674831xhcae",
        "owner_member_seq": "3768546739",
        "bulk_discount": 0,
        "bulk_order": 0,
        "base_unit": "0",
        "add_unit": "0",
        "add_weight": 0,
        "category_id": "200001133",
        "currency_code": "RUB",
        "delivery_time": "24",
        "freight_template_id": "34007612003",
        "package_height": "12",
        "package_length": "2",
        "package_width": "2",
        "lot_num": "1",
        "price": "423.00",
        "property": [
            {
                "name_id": "2",
                "name": "Brand Name",
                "value_id": "202505034",
                "value": "Vivienne Sabo",
                "unit_name": ""
            }
        ],
        "status_type": "onSelling",
        "unit": "100000015",
        "promise_template_id": "0",
        "product_reduce_strategy": "payment_success_deduct",
        "gross_weight": 0.009,
        "sizechart_id": "0",
        "ws_offline_date": "0001-01-01T00:00:00Z",
        "ws_display": "",
        "ws_valid_num": "30",
        "package_type": false,
        "descriptions": [
            {
                "locale": "ru_RU",
                "mobile_detail": "",
                "web_detail": "БРОСИТЬ ВЫЗОВ?\nОни слишком большие, чтобы быть настоящими! Готовы услышать такое о своих ресницах?\nТушь PROVOCATION создает эффект пышных, объемных, соблазнительных ресниц.\nМягкая ворсовая щеточка создает невероятно пушистый объем и выразительную длину в одно мгновение, а легкая кремовая масса подчеркивает соблазнительный изгиб ресниц."
            },
            {
                "locale": "en_US",
                "mobile_detail": "",
                "web_detail": "CHALLENGE?\nThey are too big to be real! Are you ready to hear this about your eyelashes?\nPROVOCATION mascara creates the effect of lush, voluminous, seductive eyelashes."
            }
        ],
        "media": [
            {
                "ali_member_id": "0",
                "media_id": "0",
                "media_status": "",
                "media_type": "image",
                "url": "https://ae04.alicdn.com/kf/A2c4137699d0e4a0f9eaa113fc12ec9131.jpeg"
            }
        ],
        "sku": [
            {
                "id": "14:734637",
                "code": "00734637",
                "property": [
                    {
                      "name_id": "14",
                      "name": "",
                      "value_id": "734637",
                      "value": "NO_NAME_734637",
                      "image_url": "",
                      "value_definition": ""
                    }
                ],
                "price": "423.00",
                "discount_price": "",
                "barcode": "",
                "currency_code": "RUB",
                "ipm_sku_stock": "71",
                "stock": true,
                "gtin": "",
                "sku_id": "12000029215286768",
                "classifier_codes": [
                    {
                        "type": "tnved",
                        "value": "3304200000"
                    }
                ],
                "ticket_group": "0"
            }
        ],
        "subject": [
            {
                "locale": "ru_RU",
                "name": "Vivienne Sabo Тушь для ресниц Provocation 6 мл"
            },
            {
                "locale": "pl_PL",
                "name": "Vivienne Sabo Тушь для реснц prowokacja 6 мл"
            },
            {
                "locale": "en_US",
                "name": "Vivienne Sabo mascara provocation 6 ml"
            },
            {
                "locale": "tr_TR",
                "name": "Viviienne Sabo туссниц ресниц provokasyon 6 мaveravaz"
            },
            {
                "locale": "iw_IL",
                "name": "ויויאן סבו מסקרה פרובוקציה 6 ml"
            },
            {
                "locale": "vi_VN",
                "name": "Vivienne Sabo Mascara Khiêu Khích 6 Ml"
            },
            {
                "locale": "fr_FR",
                "name": "Vivienne Sabo – mascara pour la stimulation, 6 ml"
            }
        ],
        "marketing_images": [],
        "keywords": [],
        "gtin": "",
        "classifier_codes": [],
        "detail": "БРОСИТЬ ВЫЗОВ?\nОни слишком большие, чтобы быть настоящими! Готовы услышать такое о своих ресницах?\nТушь PROVOCATION создает эффект пышных, объемных, соблазнительных ресниц.\nМягкая ворсовая щеточка создает невероятно пушистый объем и выразительную длину в одно мгновение, а легкая кремовая масса подчеркивает соблазнительный изгиб ресниц.",
        "mobile_detail": "БРОСИТЬ ВЫЗОВ?\nОни слишком большие, чтобы быть настоящими! Готовы услышать такое о своих ресницах?\nТушь PROVOCATION создает эффект пышных, объемных, соблазнительных ресниц.\nМягкая ворсовая щеточка создает невероятно пушистый объем и выразительную длину в одно мгновение, а легкая кремовая масса подчеркивает соблазнительный изгиб ресниц.",
        "group_ids": [],
        "ticket_allocate_type": "",
        "video": null
    }
}

Получить группы товаров

POST /api/v1/product/groups

Возвращает группы товаров, созданные в вашем магазине. Как создать группы товаров с помощью API или в личном кабинете.

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

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

Пример групп товаров в магазине

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

Параметр	Тип	Обязательный	Описание
locale	string	Нет	Язык, на котором созданы группы товаров. Возможные значения: RU, EN.

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

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

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

Параметр	Тип	Описание
groups	array of objects	Массив из групп товаров.
↳ group_id	string	Идентификатор группы товаров.
↳ name	string	Название группы товаров.
↳ child_list	array of strings	Массив дочерних групп товаров.

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

{
    "groups": [
        {
            "group_id": "40000002460224",
            "name": "Красители и наполнители",
            "child_list": []
        },
        {
            "group_id": "40000002405455",
            "name": "На заказ",
            "child_list": []
        },
        {
            "group_id": "40000002324704",
            "name": "Тестовая группа",
            "child_list": []
        },
        {
            "group_id": "40000002499583",
            "name": "Верхняя группа",
            "child_list": []
        }
    ]
}

Редактировать группы товаров

POST /api/v1/product/change-products-groups

Добавляет товары в группы, созданные в вашем магазине. Как создать группы товаров, используя API или в личном кабинете.

В результате запроса формируется группа заданий (параметр group_id). Статус выполнения заданий можно получить с помощью метода GET /api/v1/tasks?group_id=.

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

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

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

Параметр	Тип	Обязательный	Описание
productIds	array of strings	Да	Идентификаторы товаров, которые нужно добавить в группы товаров.
groupIds	array of strings	Да	Идентификаторы групп товаров, в которые нужно добавить товар. Можно указать не более 3 групп. Если у группы есть подгруппа (непустое значение параметра child_list из ответа метода POST /api/v1/product/groups), передайте в запросе только группу нижнего уровня.

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

curl --location --request POST 'https://openapi.ru.laliexpress.com/api/v1/product/change-products-groups' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-auth-token: <YOUR_API_YOKEN>' \
--data-raw '{
    "productIds": [
        "1005004801144587"
    ],
    "groupIds": [
        "40000002460224",
        "40000002405455"
    ]
}'

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

Параметр	Тип	Описание
group_id	string	Идентификатор товарной группы. По нему можно будет посмотреть статусы загрузки и обновления товаров в товарную группу, используя метод GET /api/v1/tasks?group_id=.
results	array of objects	Результаты запроса.
↳ ok	boolean	Был ли запрос успешным.
↳ task_id	string	Идентификатор задания на редактирование группы товаров.
↳ errors	object	Список ошибок при редактировании группы товаров.

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

{
    "group_id": "27703687",
    "results": [
        {
            "ok": true,
            "task_id": "621715886",
            "errors": {}
        }
    ]
}