Request | Method | Example | Comment |
Get all categories | ℹ️ Our API does not allow to get all products in all categories at once. first we request the main (root) categories, then we separately request the subcategories of the second, third, ... level | ||
Get a list of subcategories in category | |||
Search by category (get products in category) | In xmlParameters specify category number (for example, otc-1): <SearchItemsParameters><CategoryId>otc-1</CategoryId></SearchItemsParameters> You can get category number in 2 ways: 1️⃣ via API using http://docs.otapi.net/en/Documentations/Method?name=BatchGetItemFullInfo method. In blockList parameter specify RootPath 2️⃣ via website (https://clip.otcommerce.com/files/40/48/category.jpg). in address bar the last digits are category number | ||
Get product info | Enter item ID in itemId (for Taobao without prefix. for other providers specify prefix) blockList - add Description if you need a photo, video and description of the product | ||
Get product SKU and configurations | |||
Get number of sold items | Find values: SalesInLast30Days TotalSales | ||
Search product by parameters (ID, word, phrase, seller and other) | All search parameters are in documentation | If 1 provider, in xmlParameters specify search query: (for example, dress) <SearchItemsParameters><ItemTitle>dress</ItemTitle></SearchItemsParameters> ℹ️ Maximum 200 items per request If there are several providers, in xmlParameters specify provider and search query (for example, dress on Taobao): <SearchItemsParameters><Provider>Taobao</Provider><ItemTitle>dress</ItemTitle></SearchItemsParameters> ℹ️ Maximum 200 items per request | |
Search by photo | If you have 1 provider, specify in xmlParameters: <SearchItemsParameters><ImageUrl>https://img.alicdn.com/imgextra/i1/529782397/O1CN01qnZeTY1TZs3xAcmOv_!!529782397.jpg</ImageUrl></SearchItemsParameters> ℹ️ Maximum 200 items per request If you have several providers specify in xmlParameters required provider, for example, Таобао: <SearchItemsParameters><Provider>Taobao</Provider><ImageUrl>https://img.alicdn.com/imgextra/i1/529782397/O1CN01qnZeTY1TZs3xAcmOv_!!529782397.jpg</ImageUrl></SearchItemsParameters> ℹ️ Maximum 200 items per request
⚠️ Link to photo can be anything, for example https://www.google.ru/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png, but it must be viewable in any browser ⚠️ Search by photo is an additional module. it costs 170$ (one-time payment) for each provider | ||
Search by brand | For Taobao (for example, Adidas) 1️⃣ add brand into brands list in admin panel of API Key: Catalog –> Collections –> Popular brands (https://clip.otcommerce.com/files/71/3f/brandseng.jpg). You can add brand: - from list https://clip.otcommerce.com/files/54/91/brandsrus2%20%281%29.jpg - by link or ID https://clip.otcommerce.com/files/e7/68/brandseng3.jpg. You can copy link or ID from website https://open-demo.otcommerce.com/?q=brands (https://clip.otcommerce.com/files/3d/cd/brandsrus4.jpg -> https://clip.otcommerce.com/files/dc/40/brandsrus5.jpg) ℹ️ ID should be copied exactly from the link (for example, ot:34657) 2️⃣ then make request using BatchSearchItemsFrame method. In xmlParameters specify <SearchItemsParameters><BrandId>Adidas</BrandId></SearchItemsParameters> For other providers don’t add brand to brands list in admin panel of API Key. Make a request as when searching by word, phrase, seller and other filters, using BatchSearchItemsFrame method. In xmlParameters specify brand (for example, Adidas): <SearchItemsParameters><ItemTitle>Adidas</ItemTitle></SearchItemsParameters> | ||
Search by vendor/seller | In xmlParameters specify vendor/seller name (https://clip.otcommerce.com/files/21/99/seller.jpg) | ||
Get vendor info (location, rating, etc.) | or | In vendorId specify vendor/seller name (https://clip.otcommerce.com/files/21/99/seller.jpg). Vendor’s rating in our API is Level In blockList specify vendor/seller name (https://clip.otcommerce.com/files/21/99/seller.jpg). Vendor’s rating in our API is Level | |
Get internal delivery price | In block list specify DeliveryCosts In the code search for words InternalDelivery (without a space) ℹ️ It's impossible to get internal shipping charge of a product for a specific address via api. You should set it in admin panel of API Key | ||
Get languages for API Key | http://docs.otapi.net/en/Documentations/Method/GetLanguageInfoList?language=en&signature=×tamp= | ℹ️ API Keys K0 Basic, K1 Standard and K2 Advanced include only 1 language. To connect additional language, you need to connect paid module "Multilingualism". Price ℹ️ Unlimited number of languages are available for K3 Enterprise Key. |
framePosition - 0 (this is the beginning of the page)
frameSize - maximum 200. this is the number of products on the page. you can request a maximum of 200 products in one request
to request further, specify:
framePosition: 200 (this is the beginning of the page)
frameSize: 200 (for example)
to request further, specify:
framePosition: 400 (this is the beginning of the page)
frameSize: 200 (for example)