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

...

Example

xmlParameters value

Test request

Comment

20 items of Taobao provider

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Method requires at least one of parameter (CategoryId, VendorName, VendorId, ItemTitle, BrandId, Configurators). Get RootCategoryId from GetProviderInfo and pass it to CategoryId (for provider's root category search).
Follow the link to set up search's items count (and other parameters)

20 items of Alibaba1688 provider by 'Storage' search method

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Search method is selected automatic (by instance key settings and search parameters) by default.
Sometimes search method must be explicit. For example, search by reviews.
Подробнее про способы поискаMore details about search methods.

T-shirts search with system's optimal requested items count/number/batch (page size)

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>t-shirt</ItemTitle>
<UseOptimalFrameSize>true</UseOptimalFrameSize>
</SearchItemsParameters>

Documentation example

You can find more details about search with system's optimal requested items count/number/batch (page size) in paragraph "Goods quantity limitations". Pass any positive number into frameSize.

Sort 20 items of Taobao provider by descending price

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

More details about available sorts.

20 items of Taobao provider sorted by descending reviews count

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Available with "Reviews" module only.

More details about available sorts.

Search t-shirts by descending sales count

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>t-shirt</ItemTitle>
<OrderBy>Volume:Desc</OrderBy>
</SearchItemsParameters>

Documentation example

More details about available sorts.

Search by internal category identifier otc-4

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Search by Taobao provider's category identifier 50000671

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Search by Alibaba1688 provider's category identifier

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Searching for the first 100 items for "red t-shirt" query

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Search in original language: 红色T恤

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Search in russian language - "red t-shirt"

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Search in english language — red t-shirt

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Search in english by phrase (without translation on chinese): 3D Vision

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Search by article: 583346884671

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Search by link from Alibaba1688

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Search by vendor: maxmartin玛玛绨旗舰店

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Value of VendorId (vendor identifier) can be found in any item's information.

Search t-shirts by minimal vendor's rating 19

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>t-shirt</ItemTitle>
<MinVendorRating>19</MinVendorRating>
</SearchItemsParameters>

Documentation example

Search by brand's name: vero moda

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Brand identifier (BrandId) can be found in any item of this brand. For example, by BatchGetItemFullInfo method. You can find any item of selected brand by using demo-site search.
Search by brand from administration panel (internal brand) - documentation example.
Search brand by SearchOriginalBrandsFrame (administrator's method): pass brand name into 'name', sessionId from AuthenticateInstanceOperator method.

Search t-shirts by price interval: from 10 to 40 yuan

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>t-shirt</ItemTitle>
<CurrencyCode>CNY</CurrencyCode>
<MinPrice>10</MinPrice>
<MaxPrice>40</MaxPrice>
</SearchItemsParameters>

Documentation example

Selection includes items with promotion price (PromotionPrice). Currency (if not explicit) gets from administrators panel (first currency from list) and converts.

Search t-shirt by USD equivalent price not exceed 3

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>t-shirt</ItemTitle>
<MaxPrice>3</MaxPrice>
<CurrencyCode>USD</CurrencyCode>
</SearchItemsParameters>

Documentation example

Get currency code (CurrencyCode) by using GetCurrencyInstanceList or GetInstanceCurrencyInfoList methods.

Search t-shirt with minimal sales count of 50

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>t-shirt</ItemTitle>
<MinVolume>50</MinVolume>
</SearchItemsParameters>

Documentation example

Search t-shirt with minimal first lot 5

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<Provider>Alibaba1688</Provider>
<ItemTitle>t-shirt</ItemTitle>
<MinFirstLot>5</MinFirstLot>
</SearchItemsParameters>

Documentation example

Alibaba1688 only.

Search t-shirt with maximal first lot 1 (equals to retail order)

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<Provider>Alibaba1688</Provider>
<ItemTitle>t-shirt</ItemTitle>
<MaxFirstLot>1</MaxFirstLot>
</SearchItemsParameters>

Documentation example

Search t-shirts by condition (new)

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>t-shirt</ItemTitle>
<StuffStatus>New</StuffStatus>
</SearchItemsParameters>

Documentation example

Actualy we have 2 conditions right now: 'new' and 'used'.
New: new
Second: used

Search by attribute: red coloured XL size t-shirt

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>t-shirt</ItemTitle>
<Configurators>
<Configurator Pid="20509" Vid="28317" />
<Configurator Pid="1627207" Vid="13535612018" />
</Configurators>
</SearchItemsParameters>

Documentation example

Search attributes for selected item by using BatchGetItemFullInfo (example's item - id 646674173023) (<Attributes> )
<ItemAttribute Pid="20509" Vid="28317"> (for XL size)
<ItemAttribute Pid="1627207" Vid="13535612018"> (for "red" colour)
With additional information block 'SearchProperties' pass (more details about additional information blocks)

Search t-shirts with discount

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>t-shirt</ItemTitle>
<Features>
<Feature Name="Discount">true</Feature>
</Features>
</SearchItemsParameters>

Documentation example

List of available features can get from documentation's paragraph #2.

Search t-shirts in stock

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>t-shirt</ItemTitle>
<Features>
<Feature Name="IsStock">true</Feature>
</Features>
</SearchItemsParameters>

Documentation example

Search TMall t-shirts

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

<SearchItemsParameters>
<ItemTitle>t-shirt</ItemTitle>
<Features>
<Feature Name="Tmall">true</Feature>
</Features>
</SearchItemsParameters>

Documentation example

Search items with reviews after purchase in "dress" category

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Available with "Reviews" module only.

Search by image

Блок кода

language	xml
firstline	1
linenumbers	true
collapse	true

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

Documentation example

Can search by image URL or by uploaded through API file: more details about search by image.

...

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

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

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

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

Ключ