Получить информацию о товарах
С помощью этой группы методов вы можете получать информацию о товарах и их список.

Получить схему товара

GET aliexpress.solution.product.schema.get
Возвращает схему товара для определённой категории.
Схема — это JSON объект, описывающий товар: его поля, опции и ограничения. Она соответствует стандарту JSON Schema Core.
Это позволяет упростить процесс подготовки данных перед загрузкой товара, поскольку предварительно нужно собрать информацию с нескольких API: категории, шаблон доставки, таблицы размеров. С помощью схемы товара эти данные передаются в едином формате.
Далее с помощью схемы вы можете создавать и редактировать товары, а также проверять данные товара перед отправкой в AliExpress.

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

ПараметрТипОбязательныйОписание
aliexpress_category_idstringДаИдентификатор категории на AliExpress, можно получить из API категорий.

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

ПараметрТипОписание
schemaобъектJSON объект, описывающий товар и содержащий поля, которые определяют товар, его название, описание, изображения, шаблон доставки, бренд, категорию и т.д.
Сейчас product schema содержит 15 обязательных полей первого уровня, которые включают атрибуты категории, атрибуты артикула (SKU), шаблоны доставки и т.д. Обратите внимание, что поля схемы для разных категорий могут меняться с течением времени.
  • title_multi_language_list — название на нескольких языках;
  • description_multi_language_list — описание на нескольких языках;
  • locale — локаль, её выбор определяет язык названия/описания товара по умолчанию. Всегда указывайте ru_RU;
  • product_units_type — единица измерения товара, например, штуки. У каждой единицы свой идентификатор, например, 100000015 — для штук.
  • category_id — идентификатор категории на AliExpress.
  • image_url_list — массив ссылок на изображения товара;
  • sku_info_list — массив атрибутов артикула, например, остаток, цена, цена со скидкой и другие;
  • inventory_deduction_strategy — когда вычитается остаток: place_order_withhold (в момент заказа) или payment_success_deduct (в момент оплаты);
  • package_weight — вес посылки;
  • package_length — длина посылки;
  • package_height — высота посылки;
  • package_width — ширина посылки;
  • shipping_preparation_time — максимальное время сборки посылки в днях, советуем указывать не более 5, чтобы покупатели реже отменяли заказы;
  • shipping_template_id — идентификатор шаблона доставки, значение уникально для каждого продавца и шаблона;
  • service_template_id — идентификатор шаблона возвратов, значение уникально для каждого шаблона. id = 0 соответствует шаблону Service Template for New Sellers.

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

GET aliexpress.solution.product.info.get
Возвращает характеристики товара по его идентификатору.

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

ПараметрТипОбязательныйОписание
product_idintДаИдентификатор товара на AliExpress.

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

ПараметрТипОписание
resultобъектJSON объект с информацией о товаре и его артикулах (SKU), например, категория, ссылки на изображения, габариты и вес товара, идентификатор шаблона доставки, идентификатор таблицы размеров, время на подготовку к отправке и другие атрибуты.

Получить список товаров

GET aliexpress.solution.product.list.get
Возвращает список всех ваших товаров в определённом статусе.

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

ПараметрТипОбязательныйОписание
aeop_a_e_product_list_queryItemListQuery[]НетОбъект.
product_status_typestringДаСтатус товара на AliExpress. Может быть onSelling (В продаже), offline (Сняты с продажи), auditing (На рассмотрении) и editingRequired.
current_pageintНетСтраница выдачи результатов, по умолчанию 1.
excepted_product_idslistНетСписок идентификаторов товаров, которые нужно исключить из ответа.
off_line_timelistНетДля товаров в статусе offline. Сколько дней прошло с момента снятия с публикации.
owner_member_idstringНетЛогин продавца-владельца товара.
page_sizeintНетЧисло товаров на каждой странице выдачи результата.
product_idintНетИдентификатор товара на AliExpress.
product_subjectstringНетНечёткий поиск по английскому названию товара.
ws_displaystringНетПричина, почему товар снят с продажи. Может быть expire_offline; user_offline, violate_offline, punish_offline и grade_offline.
have_national_quotestringНет
Есть ли у товара квота по стране:
  • y — если да
  • n — если нет.
group_idintНетИдентификатор группы товаров.
gmt_create_startdateНетПоиск товаров, созданных после указанной даты и времени в формате yyyy-MM-dd hh:mm:ss.
gmt_create_enddateНетПоиск товаров, созданных до указанной даты и времени в формате yyyy-MM-dd hh:mm:ss.
gmt_modified_startdateНетПоиск товаров, изменённых до указанной даты и времени в формате yyyy-MM-dd hh:mm:ss.
gmt_modified_enddateНетПоиск товаров, изменённых до указанной даты и времени в формате yyyy-MM-dd hh:mm:ss.
sku_codestringНетИдентификатор экземпляра (SKU) товара: его артикул или штрихкод.

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

ПараметрТипОписание
currency_codestringТрёхбуквенный код валюты, например, RUB.
freight_template_idintИдентификатор шаблона доставки.
gmt_createdateВремя создания товара.
gmt_modifieddateВремя изменения товара.
image_u_r_lsstringСписок ссылок на изображения товара.
owner_member_idstringЛогин продавца на AliExpress.
owner_member_seqintЧисловой идентификатор продавца на AliExpress.
product_idintИдентификатор товара на AliExpress (AliExpress ID).
product_max_pricestringНаибольшая цена среди всех артикулов товара.
product_min_pricestringНаименьшая цена среди всех артикулов товара.
srcstringИсточник товара.
subjectstringНазвание товара.

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