...
The following table provides a comparative description of search methods as they appear in parameters structure and how they are presented in search methods description.
Parameter | Search methods | Search method information | |||||||
---|---|---|---|---|---|---|---|---|---|
Parameter name | Value example | Parameter desription | Parameter title | Value example | Parameter desription | ||||
Provider | Provider | Taobao | Provider will be defined by other conditions (for example, categories) if provider was not explicitly specified in search methods. Search will be done by default provider if none of conditions defines provider.
| Provider | Taobao | Provider ID | |||
Search method
| SearchMethod | Official | Default search method defined in settings is used if another one is not set. | SearchMethod | Official | Search method title | |||
DisplayName | Branded goods (Tmall) | Displayed search method title (in necessary language) | |||||||
Flags | List of search method features | ||||||||
Goods quantity limitations | UseOptimalFrameSize | true/false | Feature of using optimal frame size insted of sent one. frameSize parameter is ignored and OptimalFrameSize parameter will be used from chosen search method if this condition was sent in true value. | ||||||
OptimalFrameSize | 40 | Optimal number of requested goods (page size). Maximum possible search speed is available if such size of pages is used because it meets size of provider's pages. | |||||||
MaximumFrameSize | 200 | Maximum quantity of pages received for 1 query. It can work much faster when using optimum number. | |||||||
MaximumItemsCount | 4000 | Number of goods received by the same search methods. Change and define search conditions to receive more goods. | |||||||
Goods order | OrderBy | Price:Asc | Default sorting set in settings will be used if value is not set or is not included into available. | AvailableSorts | List of available sorting in search method. | ||||
Category | CategoryId | 16 | Category ID for search. | ||||||
Item title | ItemTitle | dress | Search box for item title. If only item ID (item code) or link to provider's website page is indicated then only this item will be found and shown in search results (or empty if there is no such product). | ||||||
LanguageOfQuery | ru | Search box language by item title. It is equal to language of goods query if not set. Autotranslation to provider language is done if it is not equal to provider language. | |||||||
Vendor | VendorId | Vendor ID | Vendor | true/false | If search by vendor is supported. | ||||
VendorName | Vendor name | ||||||||
Vendor area | VendorAreaId | Vendor area ID | VendorLocation | true/false | If search method supports vendor area. | ||||
Vendor rating | VendorRatingRange | true/false | If search method supports filter by vendor rating. | ||||||
MinVendorRating | 5 | Minimum value of vendor rating | MinVendorRating | 1 | Minimum value of vendor rating. | ||||
MaxVendorRating | 15 | Maximum value of vendor rating | MaxVendorRating | 20 | Maximum value of vendor rating. NOTE! Maximum value of vendor rating varies from trade provider to trade provider. You can find it in provider's available search methods. | ||||
Brand | BrandId | Brand ID | Brand | true/false | If search method supports brands. | ||||
BrandPropertyValueId | Vrand Value ID (old parameter, use BrandId) | ||||||||
Price | MinPrice | 10 | Minimum price | PriceRange | true/false | If search method supports filter by item price. | |||
MaxPrice | 1000 | Maximum price | |||||||
CurrencyCode | CNY | Currency code for price range
| |||||||
Sales volume | MinVolume | 100 | Minimum sales volume | VolumeRange | true/false | If search method supports filter by sales volume. | |||
MaxVolume | 500 | Maximum sales volume | |||||||
VolumeRangeLogic | None / Range / OnlyMin / OnlyMax | The logic of conditions by sales volume: range, only minimum, only maximum. | |||||||
Item status (new, second-hand, unused) | StuffStatus | New / Unused / Second | Item status | StuffStatus | true/false | If search method supports filter by item status. | |||
Item configurations (color, model, etc.) | Configurators | List of search features provided by structure. | Configurators | true/false | If search method supports item features. | ||||
MultipleConfiguratorLogic | None / All / And | The logic of search method by several values of one feature. Use in search of several values of one feature (for example, it is possible to output only red AND green or red OR green). | |||||||
Item features | Features | List of item features. | Features | List of special filters supported by search method. | |||||
Search by photo | ImageUrl | Address of the image to search for goods | Module | Image | Photo search parameters are allowed only in the search mode, in which the Module property is equal to Image | ||||
ImageFileId | Image File ID for Product Search Used if the image you searched for was first uploaded via OTAPI. | ||||||||
Output mode | OutputMode | Full / TotalCount / Provider | Search results output mode. Usual search with goods output and all related information is done. Other variants:
| ||||||
CategoryMode | Nothing / External / InternalLeaf / CurrentLevel | Categories in search results output mode. There is categories list (not always) besides goods in search results. These categories include found goods. They are usually called clarifying categories. There are several variants of processing and output:
| |||||||
Old conditions | IsTmall | true/false | Feature of only Tmall goods choice. |
...
Examples of parameters with search conditions and search requests
Example | xmlParameters value | Test request | Comment | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
20 items of Taobao provider |
| 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 |
| 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) |
| 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 |
| Documentation example | More details about available sorts. | ||||||||||||
20 items of Taobao provider sorted by descending reviews count |
| Documentation example | Available with "Reviews" module only. | ||||||||||||
Search t-shirts by descending sales count |
| Documentation example | More details about available sorts. | ||||||||||||
Search by internal category identifier otc-4 |
| Documentation example | |||||||||||||
Search by Taobao provider's category identifier 50000671 |
| Documentation example | |||||||||||||
Search by Alibaba1688 provider's category identifier |
| Documentation example | |||||||||||||
Searching for the first 100 items for "red t-shirt" query |
| Documentation example | |||||||||||||
Search in original language: 红色T恤 |
| Documentation example | |||||||||||||
Search in russian language - "red t-shirt" |
| Documentation example | |||||||||||||
Search in english language — red t-shirt |
| Documentation example | |||||||||||||
Search in english by phrase (without translation on chinese): 3D Vision |
| Documentation example | |||||||||||||
Search by article: 583346884671 |
| Documentation example | |||||||||||||
Search by link from Alibaba1688 |
| Documentation example | |||||||||||||
Search by vendor: maxmartin玛玛绨旗舰店 |
| Documentation example | Value of VendorId (vendor identifier) can be found in any item's information. | ||||||||||||
Search t-shirts by minimal vendor's rating 19 |
| Documentation example | |||||||||||||
Search by brand's name: vero moda |
| Documentation example |
| ||||||||||||
Search t-shirts by price interval: from 10 to 40 yuan |
| 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 |
| Documentation example | Get currency code (CurrencyCode) by using GetCurrencyInstanceList or GetInstanceCurrencyInfoList methods. | ||||||||||||
Search t-shirt with minimal sales count of 50 |
| Documentation example | |||||||||||||
Search t-shirt with minimal first lot 5 |
| Documentation example | Alibaba1688 only. | ||||||||||||
Search t-shirt with maximal first lot 1 (equals to retail order) |
| Documentation example | |||||||||||||
Search t-shirts by condition (new) |
| 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 |
| 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 |
| Documentation example | List of available features can get from documentation's paragraph #2. | ||||||||||||
Search t-shirts in stock |
| Documentation example | |||||||||||||
Search TMall t-shirts |
| Documentation example | |||||||||||||
Search items with reviews after purchase in "dress" category |
| Documentation example | Available with "Reviews" module only. | ||||||||||||
Search by image |
| Documentation example | Can search by image URL or by uploaded through API file: more details about search by image. |
...
Search results description
...