Examples of requests

Request

Method

Example

Comment

Get all categories

GetRootCategoryInfoList

http://docs.otapi.net/en/Documentations/Method/GetRootCategoryInfoList?language=en&signature=&timestamp= 

ℹ️ 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 subcategories

list

in  category 

GetCategorySubcategoryInfoList 

http://docs.otapi.net/en/Documentations/Method/GetCategorySubcategoryInfoList?language=en&signature=&timestamp=&parentCategoryId=otc-1 

Search by category (get products in category)

BatchSearchItemsFrame

http://docs.otapi.net/en/Documentations/Method/BatchSearchItemsFrame?language=en&signature=&timestamp=&sessionId=&xmlParameters=%3CSearchItemsParameters%3E%3CCategoryId%3Eotc-13%3C%2FCategoryId%3E%3C%2FSearchItemsParameters%3E&framePosition=0&frameSize=10&blockList= 

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 

BatchGetItemFullInfo

http://docs.otapi.net/en/Documentations/Method/BatchGetItemFullInfo?language=en&signature=&timestamp=&sessionId=&itemParameters=&itemId=788547215798&blockList=Description 

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

BatchGetItemFullInfo

http://docs.otapi.net/en/Documentations/Method/BatchGetItemFullInfo?language=en&signature=&timestamp=&sessionId=&itemParameters=&itemId=788547215798&blockList=Description 

Get number of sold items

BatchGetItemFullInfo

http://docs.otapi.net/enDocumentations/Method/BatchGetItemFullInfo?language=en&signature=&timestamp=&sessionId=&itemParameters=&itemId=41202605330&blockList= 

Find values:

SalesInLast30Days

TotalSales

Search product by parameters (ID, word, phrase, seller and other)

BatchSearchItemsFrame

All search parameters are in documentation

1 provider:

http://docs.otapi.net/en/Documentations/Method/BatchSearchItemsFrame?language=en&signature=&timestamp=&sessionId=&xmlParameters=%3CSearchItemsParameters%3E%3CItemTitle%3Eплатье%3C%2FItemTitle%3E%3C%2FSearchItemsParameters%3E&framePosition=0&frameSize=10&blockList=