Please read information below to find out how goods search is performed and what search settings can be done.
Trade provider
Trade provider is a service (or marketplace) for trading. Information about goods (titles, settings, configuration, etc.) and categories is sent to OT API from trade provider and then is briadcased to website via OT API Key.
Check available trade providers.
Use GetProviderInfoList method to get list of available providers and information about them.
Taobao and Tmall
Taobao search can be done in different directions. Direction depends on website goals on which you integrate OT API Key.
Title | ID | Desription |
---|---|---|
Extended search | Extended | Search on whole Taobao catalog using special OTalgorithms |
Tmall search | Official | Only Tmall search using official API |
Yahoo.co.jp
Includes 2 providers:
- Usual goods from Yahoo Japan.
- Yahoo Japan Auction.
Each provider has one type of search.
Own catalog
"Warehouse" provider will be added with additional Goods from Stock Module. You can use it to create your own catalog and add any goods (either from available providers or your own).
Search options and conditions
Each provider has its own set of search conditions. It can be varied depending on website goals. Use GetProviderSearchMethodInfoList method to get list of available search options and information what they support.
Search can be done by two methods: SearchItemsFrame and BatchSearchItemsFrame. They are completely identical. Difference is that BatchSearchItemsFrame allows to get additional information right per one request besides search itself. Possible additional information will be described below.
Search conditions are also identical. They are sent into xmlParameters and presented by structure OtapiSearchItemsParameters. It has xml format (like other structure parameters). Examples will be described below.
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. | |
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. | ||
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:
| ||||
IsClearItemTitles | true/false | Feature of goods titles cleanup. True by default, that is search outputs only original untranslated goods titles. Such behavior strongly saves translator resources and speeds up search results output as in most cases titles are not shown in goods list. Each item also has translated title if value is false.
| ||||
Old conditions | IsOriginal | true/false | Feature of only original goods choice. | |||
IsTmall | true/false | Feature of only Tmall goods choice. |
Примеры параметров с условиями поиска и запросов поиска
Пример | Значение xmlParameters | Тестовый запрос |
---|---|---|
Описание результатов поиска
Результаты поиска представлены структурой OtapiItemSearchResult, ниже описание её полей.
Параметр | Описание |
---|---|
Items | Список найденных товаров с указанием полного числа товаров |
Categories | Список категорий, в которых есть искомые товары (уточняющие товары) |
Brands | Список брендов, в которых встречаются товары (уточняющие бренды) |
TranslatedItemTitle | Текст, по которому реально искались товары (переведенный на язык провайдера) |
Provider | Товарный провайдер, в котором был произведен поиск |
SearchMethod | Способ поиска, которым был произведен поиск |
CurrentSort | Реальная текущая сортировка |
CurrentFrameSize | Реальный текущий размер фрейма (страницы) |
MaximumPageCount | Максимальное число страниц в поиске |
IsFoundByItemId | Если true, то в результатах поиска содержится 1 товар, который был найден по артикулу или ссылке |
Дополнительные блоки информации в BatchSearchItemsFrame
Используя метод BatchSearchItemsFrame, можно получить дополнительную информацию за тот же один запрос к OTAPI. Список дополнительных блоков передается в параметре blockList, через запятую. Результатом является BatchItemSearchResult, который включает в себя обычный OtapiItemSearchResult, а также все свойства для дополнительной информации.
Название блока | Описание |
---|---|
SubCategories | get all subcategories if search by category |
SearchProperties | get filters by characteristics/properties |
RootPath | get path to root if search by category |
Vendor | get information on seller if search by seller |
Brand | get information on brand if search by brand |
Category | get information on category of search by category |
HintCategories | get appropriate categories for title if search by text |
AvailableSearchMethods | get list of appropriate matching data for search methods parameters and all information on them |