История страницы

...

Пример

Значение xmlParameters

Тестовый запрос

Комментарий

20 товаров провайдера Таобао

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<Provider>Taobao</Provider>
<CategoryId>0</CategoryId>
</SearchItemsParameters>

Пример в документации

Метод не выполнится без одного из обязательных параметров (CategoryId, VendorName, VendorId, ItemTitle, BrandId, Configurators), поэтому из GetProviderInfo берём RootCategoryId и передаём его в CategoryId (для поиска в корневой категории провайдера).

Изменить количество искомых товаров (и другие параметры) можно перейдя по ссылке Пример в документации

20 товаров провайдера Алибаба1688 путём конкретного способа поиска

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<Provider>Alibaba1688</Provider>
<CategoryId>abb-0</CategoryId>
<SearchMethod>Storage</SearchMethod>
</SearchItemsParameters>

Пример в документации

По умолчанию, способ поиска выбирается автоматически (на основе настроек ключа и параметров поиска).

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

Подробнее про способы поиска.

Поиск футболок с оптимальным для системы числом запрашиваемых товаров (размер страницы)

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>футболка</ItemTitle>
<UseOptimalFrameSize>true</UseOptimalFrameSize>
</SearchItemsParameters>

Пример в документации

Подробнее про поиск с оптимальным для системы числом запрашиваемых товаров (размер страницы) можно найти в пункте "Ограничения на число товаров"

В frameSize передаём любое число больше 0.

Сортировка 20 товаров Таобао по убыванию цены

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<Provider>Taobao</Provider>
<CategoryId>0</CategoryId>
<OrderBy>Price:Desc</OrderBy>
</SearchItemsParameters>

Пример в документации

Подробнее про возможные способы сортировки.

20 товаров провайдера Таобао отсортированные по кол-ву отзывов по убыванию

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<Provider>Taobao</Provider>
<CategoryId>0</CategoryId>
<SearchMethod>Reviews</SearchMethod>
<OrderBy>ReviewCount:Desc</OrderBy>
</SearchItemsParameters>

Пример в документации

Только при наличии модуля «Отзывы».

Подробнее про возможные способы сортировки.

Поиск футболок по убыванию количества продаж

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>футболка</ItemTitle>
<OrderBy>Volume:Desc</OrderBy>
</SearchItemsParameters>

Пример в документации

Подробнее про возможные способы сортировки.

Поиск по внутренней категории otc-4

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<CategoryId>otc-4</CategoryId>
</SearchItemsParameters>

Пример в документации

Поиск по категории 50000671 провайдера Taobao

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<Provider>Taobao</Provider>
<CategoryId>50000671</CategoryId>
</SearchItemsParameters>

Пример в документации

Поиск по категории с Alibaba1688

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<CategoryId>abb-1031918</CategoryId>
</SearchItemsParameters>

Пример в документации

Поиск первых 100 товаров по запросу «красная футболка»

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>красная футболка</ItemTitle>
</SearchItemsParameters>

Пример в документации

Поиск на оригинальном языке: 红色T恤

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>红色T恤</ItemTitle>
<LanguageOfQuery>zh-chs</LanguageOfQuery>
</SearchItemsParameters>

Пример в документации

Поиск на русском языке — «красная футболка»

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>красная футболка</ItemTitle>
<LanguageOfQuery>ru</LanguageOfQuery>
</SearchItemsParameters>

Пример в документации

Поиск на английском языке — Red T-shirt

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>red t-shirt</ItemTitle>
<LanguageOfQuery>en</LanguageOfQuery>
</SearchItemsParameters>

Пример в документации

Поиск по английскому слову (без перевода на китайский): 3D Vision

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>3D Vision</ItemTitle>
<LanguageOfQuery>zh-chs</LanguageOfQuery>
</SearchItemsParameters>

Пример в документации

Поиск по артикулу: 583346884671

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>583346884671</ItemTitle>
</SearchItemsParameters>

Пример в документации

Поиск по ссылке с Alibaba1688

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>
https://detail.1688.com/offer/530220113667.html
</ItemTitle>
</SearchItemsParameters>

Пример в документации

Поиск по продавцу: maxmartin玛玛绨旗舰店

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<VendorId>maxmartin玛玛绨旗舰店</VendorId>
</SearchItemsParameters>

Пример в документации

Значение для параметра VendorId (идентификатор продавца) можно найти, например, в данных любого товара.

Поиск футболки по рейтингу продавца не меньше 19

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>футболка</ItemTitle>
<MinVendorRating>19</MinVendorRating>
</SearchItemsParameters>

Пример в документации

Поиск по названию бренда: vero moda

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<BrandId>29902</BrandId>
</SearchItemsParameters>

Пример в документации

Идентификатор бренда (BrandId) берём из конкретного товара этого бренда, например, при помощи (BatchGetItemFullInfo). Найти товар какого-либо бренда можно на демо-сайте в поиске.
Поиск по бренду из админки (внутренний) - Пример в документации
Поиск брендов админским методом SearchOriginalBrandsFrame: В name передаём имя бренда, sessionId берём в AuthenticateInstanceOperator.

Поиск футболок с ограниченной стоимостью: от 10 до 40 юаней

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>футболка</ItemTitle>
<CurrencyCode>CNY</CurrencyCode>
<MinPrice>10</MinPrice>
<MaxPrice>40</MaxPrice>
</SearchItemsParameters>

Пример в документации

В выборку попадают товары со скидочной ценой (PromotionPrice). Валюта (если не передана в явном виде) берётся из витрины (первая валюта) и конвертируется.

Поиск футболки с ценой в долларах (эквивалент) не выше 3

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>футболка</ItemTitle>
<MaxPrice>3</MaxPrice>
<CurrencyCode>USD</CurrencyCode>
</SearchItemsParameters>

Пример в документации

Код валюты (CurrencyCode) берём в GetCurrencyInstanceList или в GetInstanceCurrencyInfoList

Поиск футболки с минимальным объёмом продаж 50 штук

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>футболка</ItemTitle>
<MinVolume>50</MinVolume>
</SearchItemsParameters>

Пример в документации

Поиск футболки с минимальной партией заказа от 5 штук

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<Provider>Alibaba1688</Provider>
<ItemTitle>футболка</ItemTitle>
<MinFirstLot>5</MinFirstLot>
</SearchItemsParameters>

Пример в документации

Только для Alibaba1688

Поиск футболки с максимальной партией заказа 1 штука (аналог заказа в розницу)

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<Provider>Alibaba1688</Provider>
<ItemTitle>футболка</ItemTitle>
<MaxFirstLot>1</MaxFirstLot>
</SearchItemsParameters>

Пример в документации

Поиск только новых футболок

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>футболка</ItemTitle>
<StuffStatus>New</StuffStatus>
</SearchItemsParameters>

Пример в документации

На данный момент работает 2 состояния: новый и б/у.

New: Новый
Second: Б\У

Поиск по характеристике: футболка размера XL, красного цвета

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>футболка</ItemTitle>
<Configurators>
<Configurator Pid="20509" Vid="28317" />
<Configurator Pid="1627207" Vid="13535612018" />
</Configurators>
</SearchItemsParameters>

Пример в документации

При помощи BatchGetItemFullInfo находим атрибуты для конкретного товара (в примере - id 646674173023) (<Attributes> )

<ItemAttribute Pid="20509" Vid="28317"> (для размера XL)

<ItemAttribute Pid="1627207" Vid="13535612018"> (для цвета “красный”)

При передаче доп. блока SearchProperties (побробнее про дополнительные блоки)

Поиск футболок со скидкой

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>футболка</ItemTitle>
<Features>
<Feature Name="Discount">true</Feature>
</Features>
</SearchItemsParameters>

Пример в документации

Список возможных особенностей (фич) можно взять из пункта №2 в документации.

Поиск футболок в наличии

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>футболка</ItemTitle>
<Features>
<Feature Name="IsStock">true</Feature>
</Features>
</SearchItemsParameters>

Пример в документации

Поиск футболок в TMall

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>футболка</ItemTitle>
<Features>
<Feature Name="Tmall">true</Feature>
</Features>
</SearchItemsParameters>

Пример в документации

Поиск товаров в категории "платья" с отзывами после покупки

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<CategoryId>162104</CategoryId>
<SearchMethod>Reviews</SearchMethod>
<Features>
<Feature Name="PurchasedItemReviews">true</Feature>
</Features>
</SearchItemsParameters>

Пример в документации

Только при наличии модуля «Отзывы».

Поиск по изображению

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ImageUrl>
https://img.alicdn.com/imgextra/i1/529782397/O1CN01qnZeTY1TZs3xAcmOv_!!529782397.jpg
</ImageUrl>
</SearchItemsParameters>

Пример в документации

Можно искать по URL-у изображения или по закачанному через апи: подробности поиска по фото.

...

Дерево страниц

Сравнение версий

Старая версия 65

Новая версия 66

Ключ