tvcmall_openapi
  1. Product
tvcmall_openapi
  • Authorization
    • Get Authorization
      GET
  • Category
    • Get children of the category specified
      GET
    • Get parent of the category specified
      GET
  • Product
    • Search products
      GET
    • Get the details of the specified product
      GET
    • Get status of a list of products
      GET
    • Download the images of the specified product
      GET
    • Download the Scenseimage of the specified product
      GET
    • Search products with specific main category
      GET
    • Get the details of the specified product with images
      GET
  • Order
    • Create order
      POST
    • Get Order List
      GET
    • Get Order Information
      GET
  • Shipping
    • Shipping Calculation
      POST
    • Shipping Calculation Enhancement
      POST
  1. Product

Search products

GET
https://openapi.tvc-mall.com/OpenApi/Product/Search
Last modified:2024-10-29 07:24:52
Maintainer:Alfred.Tvc
Search products

Request

Query Params
CategoryCode
string 
optional
classified parameter
Example:
C0001
Status
integer 
optional

if status <=3 –> ProductStatus = 1; 4 –> ProductStatus > 1

Example:
1
Manufacturer
string 
optional
Applicable models
Example:
IPAD
ModifiedStart
string 
optional
the time of begin the specific modification
Example:
2000-01-01
PageSize
integer 
required
page size: default 40, Max.500
Example:
40
AttributeName
string 
optional
Product Attribute: 1. / means “and”;2. * means “or”;3. a name must correspond a value.
Example:
Brand/Color/Material
AttributeValue
string 
optional
see AttributeName’s note
Example:
Benks/White/Plastic
tags
string 
optional
The following tags can be used: NewArrivals, BestSellers, FlashShipping, Brands, StockClearances, Customizable. Please use comma to separate the tags if you want to filter by multiple tags.
Example:
BestSellers
beginDate
string 
optional
The timestamp marking when the item becomes available for sale or listing
Example:
2018-01-11T00:16:34
endDate
string 
optional
The timestamp indicating when the item is no longer available for sale or listing
Example:
2018-01-11T23:16:34
lastProductId
integer 
required
Required for all request but the first one. The biggest ProductId you get in previous request.
Example:
1353032
hasEanCode
string 
optional
Is there an eancode available ,default is null
Example:
true/false
Header Params
Authorization
string 
required
Authorization Param
Example:
2+s8CDVEwkmRHSJ9lorE5Q==

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://openapi.tvc-mall.com/OpenApi/Product/Search?CategoryCode=C0001&Status=1&Manufacturer=IPAD&ModifiedStart=2000-01-01&PageSize=40&AttributeName=Brand/Color/Material&AttributeValue=Benks/White/Plastic&tags=BestSellers&beginDate=2018-01-11T00:16:34&endDate=2018-01-11T23:16:34&lastProductId=1353032&hasEanCode=true/false' \
--header 'Authorization: 2+s8CDVEwkmRHSJ9lorE5Q=='

Responses

🟢200success
application/json
Body
ProductItemNoList
array [object {10}] 
required
ProductId
integer 
required
ItemNo
string 
required
CatalogCode
string 
required
ProductStatus
integer 
required
PublishDate
string 
required
StockStatus
integer 
required
Modified
string 
required
ProductName
string 
required
ImageUrl
string 
required
Price
number 
required
Total
integer 
required
pageIndex
integer 
required
pageSize
integer 
required
lastProductId
integer 
required
QueryTime
string 
required
Example
{"ProductItemNoList":[{"ProductId":2657326,"ItemNo":"660166037C","CatalogCode":"C003700020098","ProductStatus":1,"PublishDate":"2023-11-02T15:22:12Z","StockStatus":2,"Modified":"2024-02-28T13:11:13Z","ProductName":"For iPhone 14 Case Corners Shockproof TPU+PC Magnetic Phone Cover - Mint Green","ImageUrl":" https://img.tvc-mall.com/uploads/660166037C.jpg","Price":2.90},{"ProductId":2657325,"ItemNo":"660166037B","CatalogCode":"C003700020098","ProductStatus":1,"PublishDate":"2023-11-02T15:22:12Z","StockStatus":2,"Modified":"2024-02-28T13:11:13Z","ProductName":"For iPhone 14 Case Corners Shockproof TPU+PC Magnetic Phone Cover - Black","ImageUrl":" https://img.tvc-mall.com/uploads/660166037B.jpg","Price":2.90},{"ProductId":2657324,"ItemNo":"660166037A","CatalogCode":"C003700020098","ProductStatus":1,"PublishDate":"2023-11-02T15:22:12Z","StockStatus":2,"Modified":"2024-02-28T13:11:13Z","ProductName":"For iPhone 14 Case Corners Shockproof TPU+PC Magnetic Phone Cover - Rose Gold","ImageUrl":" https://img.tvc-mall.com/uploads/660166037A.jpg","Price":2.90},{"ProductId":2657323,"ItemNo":"660166036H","CatalogCode":"C003700020082","ProductStatus":1,"PublishDate":"2023-11-02T20:38:15Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 12 Pro Max 6.7 inch Case Compatible with MagSafe  Protective TPU+PC Phone Shell - Silver","ImageUrl":" https://img.tvc-mall.com/uploads/660166036H.jpg","Price":2.90},{"ProductId":2657322,"ItemNo":"660166036G","CatalogCode":"C003700020082","ProductStatus":1,"PublishDate":"2023-11-02T20:38:15Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 12 Pro Max 6.7 inch Case Compatible with MagSafe  Protective TPU+PC Phone Shell - Rose Gold","ImageUrl":" https://img.tvc-mall.com/uploads/660166036G.jpg","Price":2.90},{"ProductId":2657321,"ItemNo":"660166036F","CatalogCode":"C003700020082","ProductStatus":1,"PublishDate":"2023-11-02T20:38:15Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 12 Pro Max 6.7 inch Case Compatible with MagSafe  Protective TPU+PC Phone Shell - Red","ImageUrl":" https://img.tvc-mall.com/uploads/660166036F.jpg","Price":2.90},{"ProductId":2657320,"ItemNo":"660166036E","CatalogCode":"C003700020082","ProductStatus":1,"PublishDate":"2023-11-02T20:38:16Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 12 Pro Max 6.7 inch Case Compatible with MagSafe  Protective TPU+PC Phone Shell - Purple","ImageUrl":" https://img.tvc-mall.com/uploads/660166036E.jpg","Price":2.90},{"ProductId":2657319,"ItemNo":"660166036D","CatalogCode":"C003700020082","ProductStatus":1,"PublishDate":"2023-11-02T20:38:16Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 12 Pro Max 6.7 inch Case Compatible with MagSafe  Protective TPU+PC Phone Shell - Pink","ImageUrl":" https://img.tvc-mall.com/uploads/660166036D.jpg","Price":2.90},{"ProductId":2657318,"ItemNo":"660166036C","CatalogCode":"C003700020082","ProductStatus":1,"PublishDate":"2023-11-02T20:38:16Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 12 Pro Max 6.7 inch Case Compatible with MagSafe  Protective TPU+PC Phone Shell - Navy Blue","ImageUrl":" https://img.tvc-mall.com/uploads/660166036C.jpg","Price":2.90},{"ProductId":2657317,"ItemNo":"660166036B","CatalogCode":"C003700020082","ProductStatus":1,"PublishDate":"2023-11-02T20:38:17Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 12 Pro Max 6.7 inch Case Compatible with MagSafe  Protective TPU+PC Phone Shell - Black","ImageUrl":" https://img.tvc-mall.com/uploads/660166036B.jpg","Price":2.90},{"ProductId":2657316,"ItemNo":"660166036A","CatalogCode":"C003700020082","ProductStatus":1,"PublishDate":"2023-11-02T20:38:17Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 12 Pro Max 6.7 inch Case Compatible with MagSafe  Protective TPU+PC Phone Shell - Mint Green","ImageUrl":" https://img.tvc-mall.com/uploads/660166036A.jpg","Price":2.90},{"ProductId":2657315,"ItemNo":"660166035H","CatalogCode":"C003700020072","ProductStatus":1,"PublishDate":"2023-11-02T20:39:26Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 11 Case Compatible with MagSafe  Anti-Drop TPU+PC Phone Cover - Silver","ImageUrl":" https://img.tvc-mall.com/uploads/660166035H.jpg","Price":2.91},{"ProductId":2657314,"ItemNo":"660166035G","CatalogCode":"C003700020072","ProductStatus":1,"PublishDate":"2023-11-02T20:39:27Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 11 Case Compatible with MagSafe  Anti-Drop TPU+PC Phone Cover - Rose Gold","ImageUrl":" https://img.tvc-mall.com/uploads/660166035G.jpg","Price":2.91},{"ProductId":2657313,"ItemNo":"660166035F","CatalogCode":"C003700020072","ProductStatus":1,"PublishDate":"2023-11-02T20:39:27Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 11 Case Compatible with MagSafe  Anti-Drop TPU+PC Phone Cover - Red","ImageUrl":" https://img.tvc-mall.com/uploads/660166035F.jpg","Price":2.91},{"ProductId":2657312,"ItemNo":"660166035E","CatalogCode":"C003700020072","ProductStatus":1,"PublishDate":"2023-11-02T20:39:19Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 11 Case Compatible with MagSafe  Anti-Drop TPU+PC Phone Cover - Pink","ImageUrl":" https://img.tvc-mall.com/uploads/660166035E.jpg","Price":2.91},{"ProductId":2657311,"ItemNo":"660166035D","CatalogCode":"C003700020072","ProductStatus":1,"PublishDate":"2023-11-02T20:39:19Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 11 Case Compatible with MagSafe  Anti-Drop TPU+PC Phone Cover - Navy Blue","ImageUrl":" https://img.tvc-mall.com/uploads/660166035D.jpg","Price":2.91},{"ProductId":2657310,"ItemNo":"660166035C","CatalogCode":"C003700020072","ProductStatus":1,"PublishDate":"2023-11-02T20:39:20Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 11 Case Compatible with MagSafe  Anti-Drop TPU+PC Phone Cover - Mint Green","ImageUrl":" https://img.tvc-mall.com/uploads/660166035C.jpg","Price":2.91},{"ProductId":2657309,"ItemNo":"660166035B","CatalogCode":"C003700020072","ProductStatus":1,"PublishDate":"2023-11-02T20:39:20Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 11 Case Compatible with MagSafe  Anti-Drop TPU+PC Phone Cover - Black","ImageUrl":" https://img.tvc-mall.com/uploads/660166035B.jpg","Price":2.91},{"ProductId":2657308,"ItemNo":"660166035A","CatalogCode":"C003700020072","ProductStatus":1,"PublishDate":"2023-11-02T20:39:20Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 11 Case Compatible with MagSafe  Anti-Drop TPU+PC Phone Cover - Purple","ImageUrl":" https://img.tvc-mall.com/uploads/660166035A.jpg","Price":2.91},{"ProductId":2657307,"ItemNo":"660166034H","CatalogCode":"C003700020080","ProductStatus":1,"PublishDate":"2023-11-02T20:39:21Z","StockStatus":2,"Modified":"2024-02-28T13:11:15Z","ProductName":"For iPhone 12 / 12 Pro 6.1 inch Protective Case TPU+PC Phone Case Compatible with MagSafe - Silver","ImageUrl":" https://img.tvc-mall.com/uploads/660166034H.jpg","Price":2.90},{"ProductId":2657306,"ItemNo":"660166034G","CatalogCode":"C003700020080","ProductStatus":1,"PublishDate":"2023-11-02T20:39:21Z","StockStatus":2,"Modified":"2024-02-28T13:11:15Z","ProductName":"For iPhone 12 / 12 Pro 6.1 inch Protective Case TPU+PC Phone Case Compatible with MagSafe - Rose Gold","ImageUrl":" https://img.tvc-mall.com/uploads/660166034G.jpg","Price":2.90},{"ProductId":2657305,"ItemNo":"660166034F","CatalogCode":"C003700020080","ProductStatus":1,"PublishDate":"2023-11-02T20:39:22Z","StockStatus":2,"Modified":"2024-02-28T13:11:15Z","ProductName":"For iPhone 12 / 12 Pro 6.1 inch Protective Case TPU+PC Phone Case Compatible with MagSafe - Red","ImageUrl":" https://img.tvc-mall.com/uploads/660166034F.jpg","Price":2.90},{"ProductId":2657304,"ItemNo":"660166034E","CatalogCode":"C003700020080","ProductStatus":1,"PublishDate":"2023-11-02T20:39:22Z","StockStatus":2,"Modified":"2024-02-28T13:11:15Z","ProductName":"For iPhone 12 / 12 Pro 6.1 inch Protective Case TPU+PC Phone Case Compatible with MagSafe - Purple","ImageUrl":" https://img.tvc-mall.com/uploads/660166034E.jpg","Price":2.90},{"ProductId":2657303,"ItemNo":"660166034D","CatalogCode":"C003700020080","ProductStatus":1,"PublishDate":"2023-11-02T20:39:23Z","StockStatus":2,"Modified":"2024-02-28T13:11:15Z","ProductName":"For iPhone 12 / 12 Pro 6.1 inch Protective Case TPU+PC Phone Case Compatible with MagSafe - Pink","ImageUrl":" https://img.tvc-mall.com/uploads/660166034D.jpg","Price":2.90},{"ProductId":2657302,"ItemNo":"660166034C","CatalogCode":"C003700020080","ProductStatus":1,"PublishDate":"2023-11-02T20:39:23Z","StockStatus":2,"Modified":"2024-02-28T13:11:15Z","ProductName":"For iPhone 12 / 12 Pro 6.1 inch Protective Case TPU+PC Phone Case Compatible with MagSafe - Mint Green","ImageUrl":" https://img.tvc-mall.com/uploads/660166034C.jpg","Price":2.90},{"ProductId":2657301,"ItemNo":"660166034B","CatalogCode":"C003700020080","ProductStatus":1,"PublishDate":"2023-11-02T20:39:24Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 12 / 12 Pro 6.1 inch Protective Case TPU+PC Phone Case Compatible with MagSafe - Black","ImageUrl":" https://img.tvc-mall.com/uploads/660166034B.jpg","Price":2.90},{"ProductId":2657300,"ItemNo":"660166034A","CatalogCode":"C003700020080","ProductStatus":1,"PublishDate":"2023-11-02T20:39:24Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For iPhone 12 / 12 Pro 6.1 inch Protective Case TPU+PC Phone Case Compatible with MagSafe - Navy Blue","ImageUrl":" https://img.tvc-mall.com/uploads/660166034A.jpg","Price":2.90},{"ProductId":2657299,"ItemNo":"660166033H","CatalogCode":"C003700020100","ProductStatus":1,"PublishDate":"2023-11-02T20:37:19Z","StockStatus":2,"Modified":"2024-02-28T13:11:13Z","ProductName":"For iPhone 14 Plus / 15 Plus Case TPU+PC Phone Protector Compatible with MagSafe - Rose Gold","ImageUrl":" https://img.tvc-mall.com/uploads/660166033H.jpg","Price":2.90},{"ProductId":2657298,"ItemNo":"660166033G","CatalogCode":"C003700020100","ProductStatus":1,"PublishDate":"2023-11-02T20:37:19Z","StockStatus":2,"Modified":"2024-02-28T13:11:13Z","ProductName":"For iPhone 14 Plus / 15 Plus Case TPU+PC Phone Protector Compatible with MagSafe - Silver","ImageUrl":" https://img.tvc-mall.com/uploads/660166033G.jpg","Price":2.90},{"ProductId":2657297,"ItemNo":"660166033F","CatalogCode":"C003700020100","ProductStatus":1,"PublishDate":"2023-11-02T20:37:20Z","StockStatus":2,"Modified":"2024-02-28T13:11:13Z","ProductName":"For iPhone 14 Plus / 15 Plus Case TPU+PC Phone Protector Compatible with MagSafe - Red","ImageUrl":" https://img.tvc-mall.com/uploads/660166033F.jpg","Price":2.90},{"ProductId":2657296,"ItemNo":"660166033E","CatalogCode":"C003700020100","ProductStatus":1,"PublishDate":"2023-11-02T20:37:20Z","StockStatus":2,"Modified":"2024-02-28T13:11:13Z","ProductName":"For iPhone 14 Plus / 15 Plus Case TPU+PC Phone Protector Compatible with MagSafe - Purple","ImageUrl":" https://img.tvc-mall.com/uploads/660166033E.jpg","Price":2.90},{"ProductId":2657295,"ItemNo":"660166033D","CatalogCode":"C003700020100","ProductStatus":1,"PublishDate":"2023-11-02T20:37:20Z","StockStatus":2,"Modified":"2024-02-28T13:11:13Z","ProductName":"For iPhone 14 Plus / 15 Plus Case TPU+PC Phone Protector Compatible with MagSafe - Pink","ImageUrl":" https://img.tvc-mall.com/uploads/660166033D.jpg","Price":2.90},{"ProductId":2657294,"ItemNo":"660166033C","CatalogCode":"C003700020100","ProductStatus":1,"PublishDate":"2023-11-02T20:37:20Z","StockStatus":2,"Modified":"2024-02-28T13:11:13Z","ProductName":"For iPhone 14 Plus / 15 Plus Case TPU+PC Phone Protector Compatible with MagSafe - Navy Blue","ImageUrl":" https://img.tvc-mall.com/uploads/660166033C.jpg","Price":2.90},{"ProductId":2657293,"ItemNo":"660166033B","CatalogCode":"C003700020100","ProductStatus":1,"PublishDate":"2023-11-02T20:37:21Z","StockStatus":2,"Modified":"2024-02-28T13:11:13Z","ProductName":"For iPhone 14 Plus / 15 Plus Case TPU+PC Phone Protector Compatible with MagSafe - Mint Green","ImageUrl":" https://img.tvc-mall.com/uploads/660166033B.jpg","Price":2.90},{"ProductId":2657292,"ItemNo":"660166033A","CatalogCode":"C003700020100","ProductStatus":1,"PublishDate":"2023-11-02T20:37:22Z","StockStatus":2,"Modified":"2024-02-28T13:11:13Z","ProductName":"For iPhone 14 Plus / 15 Plus Case TPU+PC Phone Protector Compatible with MagSafe - Black","ImageUrl":" https://img.tvc-mall.com/uploads/660166033A.jpg","Price":2.90},{"ProductId":2657291,"ItemNo":"662802670A","CatalogCode":"C00670003","ProductStatus":1,"PublishDate":"2023-11-02T20:39:18Z","StockStatus":2,"Modified":"2024-02-19T07:25:55Z","ProductName":"ESSAGER EX-47 2m 100W Type-C Charging Cable Digital Display USB-C to USB-C Elbow Data Cord","ImageUrl":" https://img.tvc-mall.com/uploads/662802670A.jpg","Price":4.74},{"ProductId":2657290,"ItemNo":"662802669A","CatalogCode":"C00670003","ProductStatus":1,"PublishDate":"2023-11-02T20:39:19Z","StockStatus":2,"Modified":"2024-02-19T07:25:55Z","ProductName":"ESSAGER EX-47 1m Elbow 100W Type-C to Type-C Charging Data Cable Digital Display USB-C Charging Cord","ImageUrl":" https://img.tvc-mall.com/uploads/662802669A.jpg","Price":4.32},{"ProductId":2657288,"ItemNo":"660166032G","CatalogCode":"C003700130487","ProductStatus":1,"PublishDate":"2023-11-02T20:37:28Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For Samsung Galaxy S23+ Case Compatible with MagSafe Anti-Drop TPU+PC Phone Case - Silver","ImageUrl":" https://img.tvc-mall.com/uploads/660166032G.jpg","Price":2.90},{"ProductId":2657287,"ItemNo":"660166032F","CatalogCode":"C003700130487","ProductStatus":1,"PublishDate":"2023-11-02T20:37:28Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For Samsung Galaxy S23+ Case Compatible with MagSafe Anti-Drop TPU+PC Phone Case - Rose Gold","ImageUrl":" https://img.tvc-mall.com/uploads/660166032F.jpg","Price":2.90},{"ProductId":2657286,"ItemNo":"660166032E","CatalogCode":"C003700130487","ProductStatus":1,"PublishDate":"2023-11-02T20:37:28Z","StockStatus":2,"Modified":"2024-02-28T13:11:14Z","ProductName":"For Samsung Galaxy S23+ Case Compatible with MagSafe Anti-Drop TPU+PC Phone Case - Red","ImageUrl":" https://img.tvc-mall.com/uploads/660166032E.jpg","Price":2.90}],"Total":0,"pageIndex":1,"pageSize":40,"lastProductId":2657286,"QueryTime":"00:00:00.5304443"}
🟢200unauthorized
Previous
Get parent of the category specified
Next
Get the details of the specified product
Built with